BOOTCHART.CONF, BOOTCHART.CONF.D - reference manual online

Boot performance analysis graphing tool configuration files.

Chapter

BOOTCHART.CONF(5) bootchart.conf BOOTCHART.CONF(5)NAME
bootchart.conf, bootchart.conf.d - Boot performance analysis graphing tool configuration
files
SYNOPSIS
/etc/systemd/bootchart.conf
/etc/systemd/bootchart.conf.d/*.conf
/run/systemd/bootchart.conf.d/*.conf
/usr/lib/systemd/bootchart.conf.d/*.conf
DESCRIPTION
When starting, systemd-bootchart will read the configuration file
/etc/systemd/bootchart.conf, followed by the files in the bootchart.conf.d directories.
These configuration files determine logging parameters and graph output.
CONFIGURATION DIRECTORIES AND PRECEDENCE
The default configuration is defined during compilation, so a configuration file is only
needed when it is necessary to deviate from those defaults. By default, the configuration
file in /etc/systemd/ contains commented out entries showing the defaults as a guide to
the administrator. This file can be edited to create local overrides.
When packages need to customize the configuration, they can install configuration snippets
in /usr/lib/systemd/*.conf.d/. Files in /etc/ are reserved for the local administrator,
who may use this logic to override the configuration files installed by vendor packages.
The main configuration file is read before any of the configuration directories, and has
the lowest precedence; entries in a file in any configuration directory override entries
in the single configuration file. Files in the *.conf.d/ configuration subdirectories are
sorted by their filename in lexicographic order, regardless of which of the subdirectories
they reside in. If multiple files specify the same option, the entry in the file with the
lexicographically latest name takes precedence. It is recommended to prefix all filenames
in those subdirectories with a two-digit number and a dash, to simplify the ordering of
the files.
To disable a configuration file supplied by the vendor, the recommended way is to place a
symlink to /dev/null in the configuration directory in /etc/, with the same filename as
the vendor configuration file.
OPTIONS
Samples=500
Configure the amount of samples to record in total before bootchart exits. Each sample
will record at intervals defined by Frequency=.
Frequency=25
Configure the sample log frequency. This can be a fractional number, but must be
larger than 0.0. Most systems can cope with values under 25–50 without impacting boot
time severely.
Relative=no
Configures whether the left axis of the output graph equals time=0.0 (CLOCK_MONOTONIC
start). This is useful for using bootchart at post-boot time to profile an already
booted system, otherwise the graph would become extremely large. If set to yes, the
horizontal axis starts at the first recorded sample instead of time=0.0.
Filter=no
Configures whether the resulting graph should omit tasks that did not contribute
significantly to the boot. Processes that are too short-lived (only seen in one
sample) or that do not consume any significant CPU time (less than 0.001sec) will not
be displayed in the output graph.
Output=[path]
Configures the output directory for writing the graphs. By default, bootchart writes
the graphs to /run/log.
Init=[path]
Configures bootchart to run a non-standard binary instead of /lib/systemd/systemd.
This option is only relevant if bootchart was invoked from the kernel command line
with init=/lib/systemd/systemd-bootchart.
PlotMemoryUsage=no
If set to yes, enables logging and graphing of processes' PSS memory consumption.
PlotEntropyGraph=no
If set to yes, enables logging and graphing of the kernel random entropy pool size.
ScaleX=100
Horizontal scaling factor for all variable graph components.
ScaleY=20
Vertical scaling factor for all variable graph components.
ControlGroup=no
Display process control group.
SEE ALSOsystemd-bootchart(1), systemd.directives(7)systemd 229 BOOTCHART.CONF(5)