Skip to content
merge of bootchart-collector and pybootchartgui
Branch: master
Clone or download
xrmx Merge pull request #76 from mephi42/master tolerate total_time == 0
Latest commit 331ada0 Jun 1, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
collector Ignore SIGHUP when starting as PID 1 Nov 15, 2016
examples Remove what looks like an artifact from some hand editing, this makes… Apr 22, 2009
pybootchartgui tolerate total_time == 0 May 31, 2017
.gitignore Ignore generated files Sep 22, 2013
AUTHORS Update Michael's email Sep 18, 2013
COPYING remember to update the COPYING file Nov 22, 2010
MAINTAINERS Update Michael's email Aug 11, 2014
Makefile Bump version to 0.14.8 Dec 17, 2015
NEWS Bump version to 0.14.8 Dec 17, 2015
README README: added HOWTO for initramfs with dracut Nov 19, 2010
README.pybootchart improve the help for --annotate. Nov 26, 2009
TODO Fix typo in TODO Sep 26, 2010 Rename systemd files to use bootchart2 name. Aug 5, 2014 Rename systemd files to use bootchart2 name. Aug 5, 2014
bootchart2.1 Add manpages for bootchart2, bootchartd and pybootchartgui Mar 7, 2011 Rename systemd files to use bootchart2 name. Aug 5, 2014
bootchartd.1 Fix self reference in bootchartd SEE ALSO section man page. Mar 21, 2011
bootchartd.conf Add sddm-helper to EXIT_PROC Jun 30, 2016 Ignore SIGHUP when starting as PID 1 Nov 15, 2016
pybootchartgui.1 Add manpages for bootchart2, bootchartd and pybootchartgui Mar 7, 2011 Add license info to all files, as suggested in Issue 11 Jun 14, 2009



	bootchart2 was created from the fusion of three separate
pieces of work. First - the original bootchart: a shell script, and a
Java visualisation tool written by Ziga Mahkovec. Some of the original
shell scripting, and the concept remain unchanged from this time.

	bootchart2 replaces the Java visualisation with the more
friendly and flexible pybootchartgui (cf. README.pybootchart) written
by Anders Norgaard and Henning Niss, this lives mostly in the
pybootchart/ sub-directory.

	bootchart2 embeds a new collector, based on a port to C of the
inner-loop of the original bootchart collector shell-script by Scott
James Remnant. This has been subsequently re-written by Michael Meeks
to use the higher granularity 'taskstat' data available via a twisted
netlink interface, amongst other new features.

			    Using bootchart2 ?

	After install, simply add these options to your kernel
command-line, normally in /boot/grub/menu.lst:

	initcall_debug printk.time=y quiet init=/sbin/bootchartd ...

	Then - after bootup, run 'pybootchartgui -i' to get an interactive
chart rendering tool. If you want to chart the initrd, add
rdinitrd=/sbin/bootchartd to the kernel command-line.

	To make bootchart2 work best, please ensure your kernel is
configured with CONFIG_PROC_EVENTS=y and CONFIG_TASKSTATS=y, without
these we are slower, less accurate, and produce an uglier task 

	If you want to start bootchart2 in a dracut (version >= 008)
initramfs, you have to change "init=/sbin/bootchartd" to 
"rdinit=/sbin/bootchartd" and regenerate the initramfs with bootchart support
with "# dracut -f -a bootchart".

			    Why bootchart2 ?

	There are a number of interesting additional features:

	* higher resolution - the taskstat interface gives nanosecond
	  timing information, where /proc/*/stat information is far,
	  far less reliable and useful.

	* higher performance - the C re-write allows us to collect more
	  data, more quickly - sampling at ~50+Hz.

	* using PROC_EVENTS we can determine accurate process parentage
	  without needing to use a (poorly maintained) 'acct' binary

	* no Java dependency - with the visualisation in easy-to-hack
	  python, development is quicker, and dependencies more commonly

	* simpler wrappers - by using ptrace to connect to and extract
	  data from the collector, we no longer require a consistently
	  visible set of logs accessible via a shared file-system.

	* built-in visualisation - allowing some level of interaction,
	  zoom and so on.

	* better rendering - render to png, or svg, with added event
	  annotation support, and 'show more' functionality.

	* cumulative, and total CPU time graphing in the boot-chart.

	* and no doubt more by the time this is actually read.


	For potential future work, see the TODO, and/or mail the authors,
wander over to #bootchart2 on All patches most welcome.
You can’t perform that action at this time.