bionic (5) bootchart.conf.5.gz

Provided by: systemd-bootchart_233-1_amd64 bug

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.

       Cmdline=no
           Display the full command line of each process.

SEE ALSO

       systemd-bootchart(1), systemd.directives(7)