1 <?xml version='1.0'?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 This file is part of systemd.
8 Copyright 2012 Lennart Poettering
10 systemd is free software; you can redistribute it and/or modify it
11 under the terms of the GNU Lesser General Public License as published by
12 the Free Software Foundation; either version 2.1 of the License, or
13 (at your option) any later version.
15 systemd is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
24 <refentry id="systemd-analyze"
25 xmlns:xi="http://www.w3.org/2001/XInclude">
28 <title>systemd-analyze</title>
29 <productname>systemd</productname>
33 <contrib>Developer</contrib>
34 <firstname>Lennart</firstname>
35 <surname>Poettering</surname>
36 <email>lennart@poettering.net</email>
39 <contrib>Developer</contrib>
40 <firstname>Harald</firstname>
41 <surname>Hoyer</surname>
42 <email>harald@redhat.com</email>
48 <refentrytitle>systemd-analyze</refentrytitle>
49 <manvolnum>1</manvolnum>
53 <refname>systemd-analyze</refname>
54 <refpurpose>Analyze system boot-up performance</refpurpose>
59 <command>systemd-analyze</command>
60 <arg choice="opt" rep="repeat">OPTIONS</arg>
64 <command>systemd-analyze</command>
65 <arg choice="opt" rep="repeat">OPTIONS</arg>
66 <arg choice="plain">blame</arg>
69 <command>systemd-analyze</command>
70 <arg choice="opt" rep="repeat">OPTIONS</arg>
71 <arg choice="plain">critical-chain</arg>
72 <arg choice="opt" rep="repeat"><replaceable>UNIT</replaceable></arg>
75 <command>systemd-analyze</command>
76 <arg choice="opt" rep="repeat">OPTIONS</arg>
77 <arg choice="plain">plot</arg>
78 <arg choice="opt">> file.svg</arg>
81 <command>systemd-analyze</command>
82 <arg choice="opt" rep="repeat">OPTIONS</arg>
83 <arg choice="plain">dot</arg>
84 <arg choice="opt" rep="repeat"><replaceable>PATTERN</replaceable></arg>
85 <arg choice="opt">> file.dot</arg>
88 <command>systemd-analyze</command>
89 <arg choice="opt" rep="repeat">OPTIONS</arg>
90 <arg choice="plain">dump</arg>
93 <command>systemd-analyze</command>
94 <arg choice="opt" rep="repeat">OPTIONS</arg>
95 <arg choice="plain">set-log-level</arg>
96 <arg choice="opt"><replaceable>LEVEL</replaceable></arg>
101 <title>Description</title>
103 <para><command>systemd-analyze</command> may be used
104 to determine system boot-up performance statistics and
105 retrieve other state and tracing information from the
106 system and service manager.</para>
108 <para><command>systemd-analyze time</command>
109 prints the time spent in the kernel before
110 userspace has been reached, the time spent in the
111 initial RAM disk (initrd) before normal system
112 userspace has been reached, and the time normal system
113 userspace took to initialize. Note that these
114 measurements simply measure the time passed up to the
115 point where all system services have been spawned, but
116 not necessarily until they fully finished
117 initialization or the disk is idle.</para>
119 <para><command>systemd-analyze blame</command> prints
120 a list of all running units, ordered by the time they
121 took to initialize. This information may be used to
122 optimize boot-up times. Note that the output might be
123 misleading as the initialization of one service might
124 be slow simply because it waits for the initialization
125 of another service to complete.</para>
127 <para><command>systemd-analyze critical-chain [<replaceable>UNIT...</replaceable>]</command>
128 prints a tree of the time-critical chain of units
129 (for each of the specified <replaceable>UNIT</replaceable>s
130 or for the default target otherwise).
131 The time after the unit is active or started is printed
132 after the "@" character. The time the unit takes to
133 start is printed after the "+" character.
134 Note that the output might be misleading as the
135 initialization of one service might depend on socket
136 activation and because of the parallel execution
139 <para><command>systemd-analyze plot</command> prints
140 an SVG graphic detailing which system services have
141 been started at what time, highlighting the time they
142 spent on initialization.</para>
144 <para><command>systemd-analyze dot</command> generates
145 textual dependency graph description in dot format for
146 further processing with the GraphViz
147 <citerefentry><refentrytitle>dot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
148 tool. Use a command line like <command>systemd-analyze
149 dot | dot -Tsvg > systemd.svg</command> to generate a
150 graphical dependency tree. Unless
151 <option>--order</option> or <option>--require</option>
152 is passed, the generated graph will show both ordering
153 and requirement dependencies. Optional pattern
154 globbing style specifications
155 (e.g. <filename>*.target</filename>) may be given at
156 the end. A unit dependency is included in the graph if
157 any of these patterns match either the origin or
158 destination node.</para>
160 <para><command>systemd-analyze dump</command> outputs
161 a (usually very long) human-readable serialization of
162 the complete server state. Its format is subject to
163 change without notice and should not be parsed by
166 <para><command>systemd-analyze set-log-level
167 <replaceable>LEVEL</replaceable></command> changes the
168 current log level of the <command>systemd</command>
169 daemon to <replaceable>LEVEL</replaceable> (accepts
170 the same values as <option>--log-level=</option>
172 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>).</para>
174 <para>If no command is passed, <command>systemd-analyze
175 time</command> is implied.</para>
180 <title>Options</title>
182 <para>The following options are understood:</para>
186 <term><option>--user</option></term>
188 <listitem><para>Shows performance data
189 of user sessions instead of the system
190 manager.</para></listitem>
194 <term><option>--system</option></term>
196 <listitem><para>Shows performance data
197 of the system manager. This is the
198 implied default.</para></listitem>
202 <term><option>-H</option></term>
203 <term><option>--host=</option></term>
205 <listitem><para>Execute the operation
206 remotely. Specify a hostname, or
207 username and hostname separated by
208 <literal>@</literal>, to connect
209 to. This will use SSH to talk to the
210 remote machine manager
211 instance.</para></listitem>
215 <term><option>-M</option></term>
216 <term><option>--machine=</option></term>
218 <listitem><para>Execute the operation on a
219 local container. Specify a container
220 name to connect to.</para></listitem>
224 <term><option>--order</option></term>
225 <term><option>--require</option></term>
227 <listitem><para>When used in
229 <command>dot</command> command (see
230 above), selects which dependencies are
231 shown in the dependency graph. If
232 <option>--order</option> is passed,
233 only dependencies of type
234 <varname>After=</varname> or
235 <varname>Before=</varname> are
236 shown. If <option>--require</option>
237 is passed, only dependencies of type
238 <varname>Requires=</varname>,
239 <varname>RequiresOverridable=</varname>,
240 <varname>Requisite=</varname>,
241 <varname>RequisiteOverridable=</varname>,
242 <varname>Wants=</varname> and
243 <varname>Conflicts=</varname> are
244 shown. If neither is passed, this shows
245 dependencies of all these
246 types.</para></listitem>
250 <term><option>--from-pattern=</option></term>
251 <term><option>--to-pattern=</option></term>
253 <listitem><para>When used in
255 <command>dot</command> command (see
256 above), this selects which relationships
257 are shown in the dependency graph.
259 <citerefentry><refentrytitle>glob</refentrytitle><manvolnum>7</manvolnum></citerefentry>
260 patterns as arguments, which are
261 matched against left-hand and
262 right-hand, respectively, nodes of a
263 relationship. Each of these can be
264 used more than once, which means a
265 unit name must match one of the given
266 values.</para></listitem>
270 <term><option>--fuzz=</option><replaceable>timespan</replaceable></term>
272 <listitem><para>When used in conjunction
273 with the <command>critical-chain</command>
274 command (see above), also show units, which
275 finished <replaceable>timespan</replaceable> earlier, than the
276 latest unit in the same level. The unit of
277 <replaceable>timespan</replaceable> is seconds
278 unless specified with a different unit,
279 e.g. "50ms".</para></listitem>
282 <xi:include href="standard-options.xml" xpointer="help" />
283 <xi:include href="standard-options.xml" xpointer="version" />
284 <xi:include href="standard-options.xml" xpointer="no-pager" />
290 <title>Exit status</title>
292 <para>On success, 0 is returned, a non-zero failure
293 code otherwise.</para>
297 <title>Examples</title>
299 <para>This plots all dependencies of any unit whose
300 name starts with <literal>avahi-daemon.</literal>:</para>
302 <programlisting>$ systemd-analyze dot 'avahi-daemon.*' | dot -Tsvg > avahi.svg
303 $ eog avahi.svg</programlisting>
305 <para>This plots the dependencies between all known target units:</para>
307 <programlisting>systemd-analyze dot --to-pattern='*.target' --from-pattern='*.target' | dot -Tsvg > targets.svg
308 $ eog targets.svg</programlisting>
313 <xi:include href="less-variables.xml" />
316 <title>See Also</title>
318 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
319 <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>