Manpages

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