NAME | SYNOPSIS | DESCRIPTION | CONFIGURATION DIRECTORIES AND PRECEDENCE | OPTIONS | SEE ALSO | COLOPHON

BOOTCHART.CONF(5)              bootchart.conf              BOOTCHART.CONF(5)

NAME         top

       bootchart.conf, bootchart.conf.d - Boot performance analysis graphing
       tool configuration files

SYNOPSIS         top

       /etc/systemd/bootchart.conf
       /etc/systemd/bootchart.conf.d/*.conf
       /run/systemd/bootchart.conf.d/*.conf
       /usr/lib/systemd/bootchart.conf.d/*.conf

DESCRIPTION         top

       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         top

       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         top

       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
           /usr/lib/systemd/systemd. This option is only relevant if
           bootchart was invoked from the kernel command line with
           init=/usr/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 ALSO         top

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

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a bug
       report for this manual page, see 
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.  This
       page was obtained from the project's upstream Git repository 
       ⟨https://github.com/systemd/systemd.git⟩ on 2017-07-05.  If you dis‐
       cover any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org
systemd 228                                                BOOTCHART.CONF(5)

Pages that refer to this page: systemd-bootchart(1)