Man page - journalctl(1)

Packages contains this manual

Available languages:

en fr uk zh_TW zh_CN de

Manual

JOURNALCTL

NAME
SYNOPSIS
描 述
选 项
退 出 状 态
环 境 变 量
例 子
参 见
NOTES
跋

NAME

journalctl - 检 索 systemd 日 志

SYNOPSIS

journalctl [OPTIONS...] [MATCHES...]

描 述

journalctl 可 用 于 检 索 systemd (1) 日 志 (由 systemd-journald.service (8) 记 录 )。

如 果 不 带 任 何 参 数 直 接 调 用 此 命 令 ， 那 么 将 显 示 所 有 日 志 内 容 (从 最 早 一 条 日 志 记 录 开 始 )。

如 果 指 定 了 [MATCHES...] 参 数 ， 那 么 输 出 的 日 志 将 会 按 照 [MATCHES...] 参 数 进 行 过 滤 。 MATCHE 必 须 符 合 "FIELD=VALUE" 格 式 (例 如 "_SYSTEMD_UNIT=httpd.service" )， 参 见 systemd.journal-fields (7) 手 册 以 了 解 日 志 字 段 的 详 细 介 绍 。 如 果 有 多 个 不 同 的 字 段 被 [MATCHES...] 参 数 匹 配 ， 那 么 这 些 字 段 之 间 使 用 "AND"逻 辑 连 接 ， 也 就 是 ， 日 志 项 必 须 同 时 满 足 全 部 字 段 的 匹 配 条 件 才 能 被 输 出 。 如 果 同 一 个 字 段 被 多 个 [MATCHES...] 参 数 匹 配 ， 那 么 这 些 匹 配 条 件 之 间 使 用 "OR"逻 辑 连 接 ， 也 就 是 对 于 同 一 个 字 段 ， 日 志 项 只 需 满 足 任 意 一 个 匹 配 条 件 即 可 输 出 。 最 后 ， "+" 字 符 可 用 作 [MATCHES...] 组 之 间 的 分 隔 符 ， 并 被 视 为 使 用 "OR"逻 辑 连 接 。 也 就 是 ， MATCHE1 MATCHE2 + MATCHE3 MATCHE4 MATCHE5 + MATCHE6 MATCHE7 相 当 于 ( MATCHE1 MATCHE2 ) OR ( MATCHE3 MATCHE4 MATCHE5 ) OR ( MATCHE6 MATCHE7 )

还 可 以 使 用 绝 对 路 径 作 为 参 数 来 过 滤 日 志 。 绝 对 路 径 可 以 是 普 通 文 件 ， 也 可 以 是 软 连 接 ， 但 必 须 指 向 一 个 确 实 存 在 的 文 件 。 如 果 路 径 指 向 了 一 个 二 进 制 可 执 行 文 件 ， 那 么 它 实 际 上 相 当 于 是 一 个 对 "_EXE=" 字 段 的 匹 配 (仅 匹 配 完 整 的 绝 对 路 径 )。 如 果 路 径 指 向 了 一 个 可 执 行 脚 本 ， 那 么 它 实 际 上 相 当 于 是 一 个 对 "_COMM=" 字 段 的 匹 配 (仅 匹 配 脚 本 的 文 件 名 )。 如 果 路 径 指 向 了 一 个 设 备 节 点 ， 那 么 它 实 际 上 相 当 于 是 一 个 对 "_KERNEL_DEVICE=" 字 段 的 匹 配 (匹 配 该 设 备 及 其 所 有 父 设 备 的 内 核 设 备 名 称 )。 在 查 询 时 ， 软 连 接 会 被 追 踪 到 底 ， 内 核 设 备 名 称 将 被 合 成 ， 父 设 备 将 按 照 当 时 的 实 际 情 况 被 提 列 出 来 。 因 为 日 志 项 一 般 并 不 包 含 标 记 实 际 物 理 设 备 的 字 段 ， 所 以 ， 设 备 节 点 一 般 就 是 实 际 物 理 设 备 的 最 佳 代 表 。 但 是 又 因 为 设 备 节 点 与 物 理 设 备 之 间 的 对 应 关 系 在 系 统 重 启 之 后 可 能 会 发 生 变 化 ， 所 以 ， 根 据 设 备 节 点 过 滤 日 志 仅 对 本 次 启 动 有 意 义 ， 除 非 你 能 确 认 对 应 关 系 在 重 启 之 后 保 持 不 变 。

可 以 使 用 --boot , --unit= 等 选 项 进 一 步 附 加 额 外 的 约 束 条 件 (相 当 于 使 用 "AND"逻 辑 连 接 )。

最 终 的 输 出 结 果 来 自 所 有 可 访 问 的 日 志 文 件 的 综 合 ， 无 论 这 些 日 志 文 件 是 否 正 在 滚 动 或 者 正 在 被 写 入 ， 也 无 论 这 些 日 志 文 件 是 属 于 系 统 日 志 还 是 用 户 日 志 ， 只 要 有 访 问 权 限 ， 就 会 被 包 括 进 来 。

用 于 提 取 日 志 的 日 志 文 件 的 集 合 可 以 使 用 --user , --system , --directory , --file 选 项 进 行 筛 选 。

每 个 用 户 都 可 以 访 问 其 专 属 的 用 户 日 志 。 但 是 默 认 情 况 下 ， 只 有 root用 户 以 及 "systemd-journal", "adm", "wheel" 组 中 的 用 户 才 可 以 访 问 全 部 的 日 志 (系 统 与 其 他 用 户 )。 注 意 ， 一 般 发 行 版 还 会 给 "adm" 与 "wheel" 组 一 些 其 他 额 外 的 特 权 。 例 如 "wheel" 组 的 用 户 一 般 都 可 以 执 行 一 些 系 统 管 理 任 务 。

默 认 情 况 下 ， 结 果 会 通 过 less 工 具 进 行 分 页 输 出 ， 并 且 超 长 行 会 在 屏 幕 边 缘 被 截 断 。 不 过 ， 被 截 掉 的 部 分 可 以 通 过 左 右 箭 头 按 键 查 看 。 如 果 不 想 分 页 输 出 ， 那 么 可 以 使 用 --no-pager 选 项 ， 参 见 下 面 的 "环 境 变 量 "小 节 。

如 果 是 输 出 到 tty 的 话 ， 行 的 颜 色 还 会 根 据 日 志 的 级 别 变 化 ： ERROR 或 更 高 级 别 为 红 色 ， NOTICE 或 更 高 级 别 为 高 亮 ， 其 他 级 别 则 正 常 显 示 。

选 项

能 够 识 别 的 命 令 行 选 项 如 下 ：

--no-full , --full , -l

如 果 字 段 内 容 超 长 则 以 省 略 号 (...)截 断 以 适 应 列 宽 。 默 认 显 示 完 整 的 字 段 内 容 (超 长 的 部 分 换 行 显 示 或 者 被 分 页 工 具 截 断 )。

老 旧 的 -l / --full 选 项 仅 用 于 撤 销 已 有 的 --no-full 选 项 ， 除 此 之 外 没 有 其 他 用 处 。

-a , --all

完 整 显 示 所 有 字 段 内 容 ， 即 使 其 中 包 含 不 可 打 印 字 符 或 者 字 段 内 容 超 长 。

-f , --follow

只 显 示 最 新 的 日 志 项 ， 并 且 不 断 显 示 新 生 成 的 日 志 项 。 此 选 项 隐 含 了 -n 选 项 。

-e , --pager-end

在 分 页 工 具 内 立 即 跳 转 到 日 志 的 尾 部 。 此 选 项 隐 含 了 -n1000 以 确 保 分 页 工 具 不 必 缓 存 太 多 的 日 志 行 。 不 过 这 个 隐 含 的 行 数 可 以 被 明 确 设 置 的 -n 选 项 覆 盖 。 注 意 ， 此 选 项 仅 可 用 于 less (1) 分 页 器 。

-n , --lines=

限 制 显 示 最 新 的 日 志 行 数 。 --pager-end 与 --follow 隐 含 了 此 选 项 。 此 选 项 的 参 数 ： 若 为 正 整 数 则 表 示 最 大 行 数 ； 若 为 "all" 则 表 示 不 限 制 行 数 ； 若 不 设 参 数 则 表 示 默 认 值 10行 。

--no-tail

显 示 所 有 日 志 行 ， 也 就 是 用 于 撤 销 已 有 的 --lines= 选 项 (即 使 与 -f 连 用 )。

-r , --reverse

反 转 日 志 行 的 输 出 顺 序 ， 也 就 是 最 先 显 示 最 新 的 日 志 。

-o , --output=

控 制 日 志 的 输 出 格 式 。 可 以 使 用 如 下 选 项 ：

short

这 是 默 认 值 ， 其 输 出 格 式 与 传 统 的 syslog [1] 文 件 的 格 式 相 似 ， 每 条 日 志 一 行 。

short-iso

与 short 类 似 ， 只 是 将 时 间 戳 字 段 以 ISO 8601 格 式 显 示 。

short-precise

与 short 类 似 ， 只 是 将 时 间 戳 字 段 的 秒 数 精 确 到 微 秒 级 别 。

short-monotonic

与 short 类 似 ， 只 是 将 时 间 戳 字 段 的 零 值 从 内 核 启 动 时 开 始 计 算 。

short-unix

与 short 类 似 ， 只 是 将 时 间 戳 字 段 显 示 为 从 "UNIX时 间 原 点 "(1970-1-1 00:00:00 UTC)以 来 的 秒 数 。 精 确 到 微 秒 级 别 。

verbose

以 结 构 化 的 格 式 显 示 每 条 日 志 的 所 有 字 段 。

export

将 日 志 序 列 化 为 二 进 制 字 节 流 (大 部 分 依 然 是 文 本 ) 以 适 用 于 备 份 与 网 络 传 输 (详 见 Journal Export Format [2] 文 档 )。

json

将 日 志 项 按 照 JSON数 据 结 构 格 式 化 ， 每 条 日 志 一 行 (详 见 Journal JSON Format [3] 文 档 )。

json-pretty

将 日 志 项 按 照 JSON数 据 结 构 格 式 化 ， 但 是 每 个 字 段 一 行 ， 以 便 于 人 类 阅 读 。

json-sse

将 日 志 项 按 照 JSON数 据 结 构 格 式 化 ， 每 条 日 志 一 行 ， 但 是 用 大 括 号 包 围 ， 以 适 应 Server-Sent Events [4] 的 要 求 。

cat

仅 显 示 日 志 的 实 际 内 容 ， 而 不 显 示 与 此 日 志 相 关 的 任 何 元 数 据 (包 括 时 间 戳 )。

--utc

以 世 界 统 一 时 间 (UTC)表 示 时 间

--no-hostname

不 显 示 来 源 于 本 机 的 日 志 消 息 的 主 机 名 字 段 。 此 选 项 仅 对 short 系 列 输 出 格 式 (见 上 文 )有 效 。

-x , --catalog

在 日 志 的 输 出 中 增 加 一 些 解 释 性 的 短 文 本 ， 以 帮 助 进 一 步 说 明 日 志 的 含 义 、 问 题 的 解 决 方 案 、 支 持 论 坛 、 开 发 文 档 、 以 及 其 他 任 何 内 容 。 并 非 所 有 日 志 都 有 这 些 额 外 的 帮 助 文 本 ， 详 见 Message Catalog Developer Documentation [5] 文 档 。

注 意 ， 如 果 要 将 日 志 输 出 用 于 bug报 告 ， 请 不 要 使 用 此 选 项 。

-q , --quiet

当 以 普 通 用 户 身 份 运 行 时 ， 不 显 示 任 何 警 告 信 息 与 提 示 信 息 。 例 如 ： "-- Logs begin at ...", "-- Reboot --"

-m , --merge

混 合 显 示 包 括 远 程 日 志 在 内 的 所 有 可 见 日 志 。

-b [ ID ] [ ±offset ], --boot=[ ID ] [ ±offset ]

显 示 特 定 于 某 次 启 动 的 日 志 ， 这 相 当 于 添 加 了 一 个 "_BOOT_ID=" 匹 配 条 件 。

如 果 参 数 为 空 (也 就 是 ID 与 ±offset 都 未 指 定 )， 则 表 示 仅 显 示 本 次 启 动 的 日 志 。

如 果 省 略 了 ID ， 那 么 当 ±offset 是 正 数 的 时 候 ， 将 从 日 志 头 开 始 正 向 查 找 ， 否 则 (也 就 是 为 负 数 或 零 )将 从 日 志 尾 开 始 反 响 查 找 。 举 例 来 说 ， "-b 1"表 示 按 时 间 顺 序 排 列 最 早 的 那 次 启 动 ， "-b 2"则 表 示 在 时 间 上 第 二 早 的 那 次 启 动 ； "-b -0"表 示 最 后 一 次 启 动 ， "-b -1"表 示 在 时 间 上 第 二 近 的 那 次 启 动 ， 以 此 类 推 。 如 果 ±offset 也 省 略 了 ， 那 么 相 当 于 "-b -0"， 除 非 本 次 启 动 不 是 最 后 一 次 启 动 (例 如 用 --directory 指 定 了 另 外 一 台 主 机 上 的 日 志 目 录 )。

如 果 指 定 了 32字 符 的 ID ， 那 么 表 示 以 此 ID 所 代 表 的 那 次 启 动 为 基 准 计 算 偏 移 量 ( ±offset )， 计 算 方 法 同 上 。 换 句 话 说 ， 省 略 ID 表 示 以 本 次 启 动 为 基 准 计 算 偏 移 量 ( ±offset )。

--list-boots

列 出 每 次 启 动 的 序 号 (也 就 是 相 对 于 本 次 启 动 的 偏 移 量 )、 32字 符 的 ID、 第 一 条 日 志 的 时 间 戳 、 最 后 一 条 日 志 的 时 间 戳 。

-k , --dmesg

仅 显 示 内 核 日 志 。 隐 含 了 -b 选 项 以 及 "_TRANSPORT=kernel" 匹 配 项 。

-t , --identifier= SYSLOG_IDENTIFIER

仅 显 示 syslog [1] 识 别 符 为 SYSLOG_IDENTIFIER 的 日 志 项 。

可 以 多 次 使 用 该 选 项 以 指 定 多 个 识 别 符 。

-u , --unit= UNIT | PATTERN

仅 显 示 属 于 特 定 单 元 的 日 志 。 也 就 是 单 元 名 称 正 好 等 于 UNIT 或 者 符 合 PATTERN 模 式 的 单 元 。 这 相 当 于 添 加 了 一 个 "_SYSTEMD_UNIT= UNIT " 匹 配 项 (对 于 UNIT 来 说 )， 或 一 组 匹 配 项 (对 于 PATTERN 来 说 )。

可 以 多 次 使 用 此 选 项 以 添 加 多 个 并 列 的 匹 配 条 件 (相 当 于 用 "OR"逻 辑 连 接 )。

--user-unit=

仅 显 示 属 于 特 定 用 户 会 话 单 元 的 日 志 。 相 当 于 同 时 添 加 了 "_SYSTEMD_USER_UNIT=" 与 "_UID=" 两 个 匹 配 条 件 。

可 以 多 次 使 用 此 选 项 以 添 加 多 个 并 列 的 匹 配 条 件 (相 当 于 用 "OR"逻 辑 连 接 )。

-p , --priority=

根 据 日 志 等 级 (包 括 等 级 范 围 )过 滤 输 出 结 果 。 日 志 等 级 数 字 与 其 名 称 之 间 的 对 应 关 系 如 下 (参 见 syslog (3))： "emerg" (0), "alert" (1), "crit" (2), "err" (3), "warning" (4), "notice" (5), "info" (6), "debug" (7) 。 若 设 为 一 个 单 独 的 数 字 或 日 志 等 级 名 称 ， 则 表 示 仅 显 示 小 于 或 等 于 此 等 级 的 日 志 (也 就 是 重 要 程 度 等 于 或 高 于 此 等 级 的 日 志 )。 若 使 用 FROM..TO.. 设 置 一 个 范 围 ， 则 表 示 仅 显 示 指 定 的 等 级 范 围 内 (含 两 端 )的 日 志 。 此 选 项 相 当 于 添 加 了 "PRIORITY=" 匹 配 条 件 。

-c , --cursor=

从 指 定 的 游 标 (cursor)开 始 显 示 日 志 。 [提 示 ]每 条 日 志 都 有 一 个 "__CURSOR"字 段 ， 类 似 于 该 条 日 志 的 指 纹 。

--after-cursor=

从 指 定 的 游 标 (cursor) 之 后 开 始 显 示 日 志 。 如 果 使 用 了 --show-cursor 选 项 ， 则 也 会 显 示 游 标 本 身 。

--show-cursor

在 最 后 一 条 日 志 之 后 显 示 游 标 ， 类 似 下 面 这 样 ， 以 "--"开 头 ：

-- cursor: s=0639...

游 标 的 具 体 格 式 是 私 有 的 (也 就 是 没 有 公 开 的 规 范 )， 并 且 会 变 化 。

-S , --since= , -U , --until=

显 示 晚 于 指 定 时 间 (--since=)的 日 志 、 显 示 早 于 指 定 时 间 (--until=)的 日 志 。 参 数 的 格 式 类 似 "2012-10-30 18:17:16" 这 样 。 如 果 省 略 了 "时 :分 :秒 "部 分 ， 则 相 当 于 设 为 "00:00:00" 。 如 果 仅 省 略 了 "秒 "的 部 分 则 相 当 于 设 为 ":00" 。 如 果 省 略 了 "年 -月 -日 "部 分 ， 则 相 当 于 设 为 当 前 日 期 。 除 了 "年 -月 -日 时 :分 :秒 "格 式 ， 参 数 还 可 以 进 行 如 下 设 置 ： (1)设 为 "yesterday", "today", "tomorrow" 以 表 示 那 一 天 的 零 点 (00:00:00)。 (2)设 为 "now" 以 表 示 当 前 时 间 。 (3)可 以 在 "年 -月 -日 时 :分 :秒 "前 加 上 "-"(前 移 ) 或 "+"(后 移 ) 前 缀 以 表 示 相 对 于 当 前 时 间 的 偏 移 。 关 于 时 间 与 日 期 的 详 细 规 范 ， 参 见 systemd.time (7)

-F , --field=

显 示 所 有 日 志 中 某 个 字 段 的 所 有 可 能 值 。 [译 者 注 ]类 似 于 SQL语 句 ： "SELECT DISTINCT 某 字 段 FROM 全 部 日 志 "

-N , --fields

输 出 所 有 日 志 字 段 的 名 称

--system , --user

仅 显 示 系 统 服 务 与 内 核 的 日 志 ( --system )、 仅 显 示 当 前 用 户 的 日 志 ( --user )。 如 果 两 个 选 项 都 未 指 定 ， 则 显 示 当 前 用 户 的 所 有 可 见 日 志 。

-M , --machine=

显 示 来 自 于 正 在 运 行 的 、 特 定 名 称 的 本 地 容 器 的 日 志 。 参 数 必 须 是 一 个 本 地 容 器 的 名 称 。

-D DIR , --directory= DIR

仅 显 示 来 自 于 特 定 目 录 中 的 日 志 ， 而 不 是 默 认 的 运 行 时 和 系 统 日 志 目 录 中 的 日 志 。

--file= GLOB

GLOB 是 一 个 可 以 包 含 "?"与 "*"的 文 件 路 径 匹 配 模 式 。 表 示 仅 显 示 来 自 与 指 定 的 GLOB 模 式 匹 配 的 文 件 中 的 日 志 ， 而 不 是 默 认 的 运 行 时 和 系 统 日 志 目 录 中 的 日 志 。 可 以 多 次 使 用 此 选 项 以 指 定 多 个 匹 配 模 式 (多 个 模 式 之 间 用 "OR"逻 辑 连 接 )。

--root= ROOT

在 对 日 志 进 行 操 作 时 ， 将 ROOT 视 为 系 统 的 根 目 录 。 例 如 --update-catalog 将 会 创 建 ROOT /var/lib/systemd/catalog/database

--new-id128

此 选 项 并 不 用 于 显 示 日 志 内 容 ， 而 是 用 于 重 新 生 成 一 个 标 识 日 志 分 类 的 128-bit ID 。 此 选 项 的 目 的 在 于 帮 助 开 发 者 生 成 易 于 辨 别 的 日 志 消 息 ， 以 方 便 调 试 。

--header

此 选 项 并 不 用 于 显 示 日 志 内 容 ， 而 是 用 于 显 示 日 志 文 件 内 部 的 头 信 息 (类 似 于 元 数 据 )。

--disk-usage

此 选 项 并 不 用 于 显 示 日 志 内 容 ， 而 是 用 于 显 示 所 有 日 志 文 件 (归 档 文 件 与 活 动 文 件 )的 磁 盘 占 用 总 量 。

--vacuum-size= , --vacuum-time= , --vacuum-files=

这 些 选 项 并 不 用 于 显 示 日 志 内 容 ， 而 是 用 于 清 理 日 志 归 档 文 件 (并 不 清 理 活 动 的 日 志 文 件 )， 以 释 放 磁 盘 空 间 。 --vacuum-size= 可 用 于 限 制 归 档 文 件 的 最 大 磁 盘 使 用 量 (可 以 使 用 "K", "M", "G", "T" 后 缀 )； --vacuum-time= 可 用 于 清 除 指 定 时 间 之 前 的 归 档 (可 以 使 用 "s", "m", "h", "days", "weeks", "months", "years" 后 缀 )； --vacuum-files= 可 用 于 限 制 日 志 归 档 文 件 的 最 大 数 量 。 注 意 ， --vacuum-size= 对 --disk-usage 的 输 出 仅 有 间 接 效 果 ， 因 为 --disk-usage 输 出 的 是 归 档 日 志 与 活 动 日 志 的 总 量 。 同 样 ， --vacuum-files= 也 未 必 一 定 会 减 少 日 志 文 件 的 总 数 ， 因 为 它 同 样 仅 作 用 于 归 档 文 件 而 不 会 删 除 活 动 的 日 志 文 件 。 此 三 个 选 项 可 以 同 时 使 用 ， 以 同 时 从 三 个 维 度 去 限 制 归 档 文 件 。 若 将 某 选 项 设 为 零 ， 则 表 示 取 消 此 选 项 的 限 制 。

--list-catalog [ 128-bit-ID... ]

简 要 列 出 日 志 分 类 信 息 ， 其 中 包 括 对 分 类 信 息 的 简 要 描 述 。

如 果 明 确 指 定 了 分 类 ID( 128-bit-ID )， 那 么 仅 显 示 指 定 的 分 类 。

--dump-catalog [ 128-bit-ID... ]

详 细 列 出 日 志 分 类 信 息 (格 式 与 .catalog 文 件 相 同 )。

如 果 明 确 指 定 了 分 类 ID( 128-bit-ID )， 那 么 仅 显 示 指 定 的 分 类 。

--update-catalog

更 新 日 志 分 类 索 引 二 进 制 文 件 。 每 当 安 装 、 删 除 、 更 新 了 分 类 文 件 ， 都 需 要 执 行 一 次 此 动 作 。

--setup-keys

此 选 项 并 不 用 于 显 示 日 志 内 容 ， 而 是 用 于 生 成 一 个 新 的 FSS(Forward Secure Sealing)密 钥 对 。 此 密 钥 对 包 含 一 个 "sealing key"与 一 个 "verification key"。 "sealing key"保 存 在 本 地 日 志 目 录 中 ， 而 "verification key"则 必 须 保 存 在 其 他 地 方 。 详 见 journald.conf (5) 中 的 Seal= 选 项 。

--force

与 --setup-keys 连 用 ， 表 示 即 使 已 经 配 置 了 FSS(Forward Secure Sealing)密 钥 对 ， 也 要 强 制 重 新 生 成 。

--interval=

与 --setup-keys 连 用 ， 指 定 "sealing key"的 变 化 间 隔 。 较 短 的 时 间 间 隔 会 导 致 占 用 更 多 的 CPU资 源 ， 但 是 能 够 减 少 未 检 测 的 日 志 变 化 时 间 。 默 认 值 是 15min

--verify

检 查 日 志 文 件 的 内 在 一 致 性 。 如 果 日 志 文 件 在 生 成 时 开 启 了 FSS特 性 ， 并 且 使 用 --verify-key= 指 定 了 FSS的 "verification key"， 那 么 ， 同 时 还 将 验 证 日 志 文 件 的 真 实 性 。

--verify-key=

与 --verify 选 项 连 用 ， 指 定 FSS的 "verification key"

--sync

要 求 日 志 守 护 进 程 将 所 有 未 写 入 磁 盘 的 日 志 数 据 刷 写 到 磁 盘 上 ， 并 且 一 直 阻 塞 到 刷 写 操 作 实 际 完 成 之 后 才 返 回 。 因 此 该 命 令 可 以 保 证 当 它 返 回 的 时 候 ， 所 有 在 调 用 此 命 令 的 时 间 点 之 前 的 日 志 ， 已 经 全 部 安 全 的 刷 写 到 了 磁 盘 中 。

--flush

要 求 日 志 守 护 进 程 将 /run/log/journal 中 的 日 志 数 据 刷 写 到 /var/log/journal 中 (如 果 持 久 存 储 设 备 当 前 可 用 的 话 )。 此 操 作 会 一 直 阻 塞 到 操 作 完 成 之 后 才 会 返 回 ， 因 此 可 以 确 保 在 该 命 令 返 回 时 ， 数 据 转 移 确 实 已 经 完 成 。 注 意 ， 此 命 令 仅 执 行 一 个 单 独 的 、 一 次 性 的 转 移 动 作 ， 若 没 有 数 据 需 要 转 移 ， 则 此 命 令 什 么 也 不 做 ， 并 且 也 会 返 回 一 个 表 示 操 作 已 正 确 完 成 的 返 回 值 。

--rotate

要 求 日 志 守 护 进 程 滚 动 日 志 文 件 。 此 命 令 会 一 直 阻 塞 到 滚 动 完 成 之 后 才 会 返 回 。

-h , --help

显 示 简 短 的 帮 助 信 息 并 退 出 。

--version

显 示 简 短 的 版 本 信 息 并 退 出 。

--no-pager

不 将 程 序 的 输 出 内 容 管 道 (pipe)给 分 页 程 序 。

退 出 状 态

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

环 境 变 量

$SYSTEMD_PAGER

指 定 分 页 程 序 。 仅 在 未 指 定 --no-pager 选 项 时 有 意 义 。 此 变 量 会 覆 盖 $PAGER 的 值 。 将 此 变 量 设 为 空 字 符 串 或 "cat" 等 价 于 使 用 --no-pager 选 项 。

$SYSTEMD_LESS

用 于 覆 盖 默 认 传 递 给 less 程 序 的 命 令 行 选 项 ("FRSXMK")。

例 子

不 带 任 何 选 项 与 参 数 ， 表 示 显 示 全 部 日 志

journalctl

仅 指 定 一 个 匹 配 条 件 ， 显 示 所 有 符 合 该 匹 配 条 件 的 日 志

journalctl _SYSTEMD_UNIT=avahi-daemon.service

指 定 了 两 个 不 同 字 段 的 匹 配 条 件 ， 显 示 同 时 满 足 两 个 匹 配 条 件 的 日 志

journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097

指 定 了 同 一 个 字 段 的 两 个 不 同 匹 配 条 件 ， 显 示 满 足 其 中 任 意 一 个 条 件 的 日 志

journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service

使 用 "+" 连 接 两 组 匹 配 条 件 ， 相 当 于 逻 辑 "OR"连 接

journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service

显 示 所 有 D-Bus 进 程 产 生 的 日 志

journalctl /usr/bin/dbus-daemon

显 示 上 一 次 启 动 所 产 生 的 所 有 内 核 日 志

journalctl -k -b -1

持 续 显 示 apache.service 服 务 不 断 生 成 的 日 志

journalctl -f -u apache

参 见

systemd (1), systemd-journald.service (8), systemctl (1), coredumpctl (1), systemd.journal-fields (7), journald.conf (5), systemd.time (7)

NOTES

1.

syslog

//linux/sysklogd.html

2.

Journal Export Format

http://www.freedesktop.org/wiki/Software/systemd/export

3.

Journal JSON Format

http://www.freedesktop.org/wiki/Software/systemd/json

4.

Server-Sent Events

https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events

5.

Message Catalog Developer Documentation

http://www.freedesktop.org/wiki/Software/systemd/catalog

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。

翻 译 人 员 ： 金 步 国
金 步 国 作 品 集 ： http://www.jinbuguo.com
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh