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