systemd-analyze 中文手册

描述¶

systemd-analyze 可以显示系统启动过程中的性能统计数据、 获取 systemd 系统管理器的状态与跟踪信息、 校验单元文件的正确性。 此外，还可以用于调试 systemd 系统管理器。

systemd-analyze time 可以显示如下时间： (1)在启动第一个用户态进程(init)之前，内核运行了多长时间； (2)在切换进入实际的根文件系统之前，initrd(initial RAM disk)运行了多长时间； (3)进入实际的根文件系统之后，用户空间启动完成花了多长时间。 注意， 上述时间只是简单的计算了系统启动过程中到达不同标记点的时间， 并没有计入各单元实际启动完成所花费的时间以及磁盘空闲的时间。

systemd-analyze blame 按照每个单元花费的启动时间从多到少的顺序，列出所有当前正处于活动(active)状态的单元。 这些信息有助于用户优化系统启动速度。 不过需要注意的是，这些信息也可能具有误导性， 因为花费较长时间启动的单元，有可能只是在等待另一个依赖单元完成启动。 注意， systemd-analyze blame Type=simple 服务的结果， 因为 systemd 认为这种服务是立即启动的， 所以无法测量初始化延迟。

systemd-analyze critical-chain [UNIT…] 为指定的单元(省略参数表示默认启动目标单元)以树状形式显示时间关键链(time-critical chain)。 "@"后面的时刻表示该单元的启动时刻； "+"后面的时长表示该单元总计花了多长时间才完成启动。 不过需要注意的是， 这些信息也可能具有误导性， 因为花费较长时间启动的单元， 有可能只是在 等待另一个依赖单元完成启动。

systemd-analyze plot 输出一个 SVG 图像，详细显示每个单元的启动时刻， 并高亮显示每个单元总计花了多长时间才完成启动。

systemd-analyze dot 按照 GraphViz dot(1) 格式输出单元间的依赖关系图。 在实践中，通常使用 systemd-analyze dot | dot -Tsvg > systemd.svg 命令来最终生成描述单元间依赖关系的 SVG 图像。 除非使用了 --order 或 --require 选项限定仅显示特定类型的依赖关系， 否则将会显示所有的依赖关系。如果指定了至少一个 PATTERN 参数(例如 *.target 这样的 shell 匹配模式)， 那么将会仅显示所有匹配这些模式的单元的直接依赖关系。

systemd-analyze dump 按照人类易读的格式输出全部单元的状态(一般都有几千数万行)。 因为它的输出格式经常在未通知的情况下发生变化， 所以切勿将此输出用于程序分析。

systemd-analyze cat-config 类似于 systemctl cat ，但用于显示配置文件。 此命令将会把配置文件与配置片段的内容显示在标准输出上， 并且遵守 systemd 配置目录与配置文件的优先级规则。 参数要么是 绝对路径(例如 /etc/systemd/logind.conf 或 /usr/lib/systemd/logind.conf)、 要么是相对于前缀的相对路径(例如 systemd/logind.conf)。

$ systemd-analyze cat-config systemd/logind.conf
# /etc/systemd/logind.conf
...
[Login]
NAutoVTs=8
...

# /usr/lib/systemd/logind.conf.d/20-test.conf
... some override from another package

# /etc/systemd/logind.conf.d/50-override.conf
... some administrator override
      

systemd-analyze unit-paths 列出与单元相关的全部目录， 包括：单元文件目录、配置片段目录(.d)、 依赖关系目录(.wants 与 .requires)。 与 --user 一起使用时表示针对 systemd 用户实例。 与 --global 一起使用时表示针对 systemd 用户实例的全局配置。 注意，此命令输出的列表仅为编译在 systemd-analyze 中的路径， 它实际上并不与运行中的 systemd 进程通信。

systemctl [--user] [--global] show -p UnitPath --value

命令会列出运行中的 systemd 进程实际使用的路径列表， 但是会忽略空目录。

systemd-analyze log-level 打印出 systemd 守护进程当前的日志等级。 如果提供了可选的 LEVEL 参数， 那么表示将 systemd 守护进程的日志等级更改为 LEVEL (可使用的值参见 --log-level= 选项(参见 systemd(1)))。

systemd-analyze log-target 打印出 systemd 守护进程当前的日志目标。 如果提供了可选的 TARGET 参数， 那么表示将 systemd 守护进程的日志目标更改为 TARGET (可使用的值参见 --log-target= 选项(参见 systemd(1)))。

systemd-analyze syscall-filter [SET…] 如果指定了至少一个 SET 参数，那么仅显示指定的集合所包含的系统调用列表； 否则显示全部系统调用集合的详情。注意，必须在 SET 参数中包含 "@" 前缀。

systemd-analyze verify 校验指定的单元文件以及被指定的单元文件引用的其他单元文件的正确性，并显示发现的错误。 FILES 参数可以是单元文件的精确路径(带有上级目录)，也可以仅仅是单元文件的名称(没有目录前缀)。 对于那些仅给出了文件名(没有目录前缀)的单元， 将会优先在其他已经给出精确路径的单元文件的所在目录中搜索， 如果没有找到，将会继续在常规的单元目录中搜索(详见 systemd.unit(5) 手册)。 可以使用 $SYSTEMD_UNIT_PATH 环境变量来更改默认的单元搜索目录。

systemd-analyze calendar 解析并标准化"日历事件"， 计算出下一个过期时间。接受的参数与 OnCalendar= 选项(参见 systemd.timer(5) 手册)相同， 表达式语法遵守 systemd.time(7) 规范。

systemd-analyze service-watchdogs 显示 systemd 守护进程的服务单元运行时看门狗的当前状态。 如果提供了可选的布尔值参数，那么表示全局启用或禁用 服务单元运行时看门狗(WatchdogSec=)与紧急操作(例如 OnFailure= 或 StartLimitAction=)。参见 systemd.service(5) 手册。 注意，硬件看门狗不受该命令的影响。

systemd-analyze timespan 解析一个"时长"，并以微秒为单位输出规格化后的等效值。 接受的参数表达式语法遵守 systemd.time(7) 规范。有单位的值将被解析为秒。

systemd-analyze security 分析一个或多个指定服务单元的安全性和沙箱设置。 如果指定了至少一个单元名称，那么将检查指定服务单元的安全设置并显示详细分析。 如果未指定单元名称，那么将检查所有当前已加载的长时间运行的服务单元， 并显示一个简洁的结果表格。 该命令检查各种安全相关的设置，根据每个设置的重要性分配一个"暴露级别"数值。 然后，为整个单元计算出一个总体暴露级别数值，这是一个 0.0…10.0 之间的估计值，表示该服务的暴露程度。 数值越大表示沙箱应用的越少(安全性越低)、数值越小表示沙箱应用的越多(安全性越高)。 注意，该命令只分析 systemd 本身实现的针对每个服务的安全特性， 并不会考虑服务代码本身应用的任何附加安全机制。不要误解这种方式计算的"暴露级别"： 高"暴露级别"既不意味着服务代码本身没有有效的沙箱机制， 也不意味着服务实际上易受远程或本地攻击的影响。 但是，高"暴露级别"的服务确实有可能需要加强额外的安全与沙箱限制。 注意，许多单独的安全和沙箱设置是可以规避绕过的(除非与其他结合使用)。 例如，如果服务保留了创建或撤消挂载点的特权， 那么许多沙箱选项就可以由服务代码本身取消。 所以，每个服务应该尽可能使用最全面和最严格的沙箱与安全设置。 该工具会考虑某些设置组合之间的关系，但不是全部。 还要注意，这里分析的安全性和沙箱设置仅适用于服务代码本身执行的操作。 如果一个服务可以访问IPC系统(例如 D-Bus)，那么它可能会请求其他不受相同限制的服务进行操作。 如果没有验证IPC访问策略， 那么任何全面的安全性和沙箱分析都是不完整的。

如果没指定任何命令，那么等价于使用 systemd-analyze time 命令。

选项(OPTIONS)¶

可以识别的选项如下：

退出状态¶

返回值为 0 表示成功， 非零返回值表示失败代码。

dot 命令的例子¶

$ systemd-analyze dot 'avahi-daemon.*' | dot -Tsvg > avahi.svg
$ eog avahi.svg

$ systemd-analyze dot --to-pattern='*.target' --from-pattern='*.target' | dot -Tsvg > targets.svg
$ eog targets.svg

verify 命令的例子¶

目前可以检测如下错误：

$ cat ./user.slice
[Unit]
WhatIsThis=11
Documentation=man:nosuchfile(1)
Requires=different.service

[Service]
Description=x

$ systemd-analyze verify ./user.slice
[./user.slice:9] Unknown lvalue 'WhatIsThis' in section 'Unit'
[./user.slice:13] Unknown section 'Service'. Ignoring.
Error: org.freedesktop.systemd1.LoadFailed:
   Unit different.service failed to load:
   No such file or directory.
Failed to create user.slice/start: Invalid argument
user.slice: man nosuchfile(1) command failed with code 16
      

$ tail ./a.socket ./b.socket
==> ./a.socket <==
[Socket]
ListenStream=100

==> ./b.socket <==
[Socket]
ListenStream=100
Accept=yes

$ systemd-analyze verify ./a.socket ./b.socket
Service a.service not loaded, a.socket cannot be started.
Service b@0.service not loaded, b.socket cannot be started.
      

环境变量¶

参见¶

systemd(1), systemctl(1)