Ubuntu Manpage: journald.conf, journald.conf.d

NAME

       journald.conf, journald.conf.d - 日誌服務配置文件

SYNOPSIS

       /etc/systemd/journald.conf

       /etc/systemd/journald.conf.d/*.conf

       /run/systemd/journald.conf.d/*.conf

       /usr/lib/systemd/journald.conf.d/*.conf

描述

       這些文件用於配置系統日誌服務 systemd-journald.service(8) 的行爲。

配置目錄及其優先級

       默認設置是在編譯期間確定的， 所以僅在確實需要修改默認設置的情況下， 才需要使用配置文件。位
       於 /etc/systemd/ 目錄中的初始配置文件， 僅包含了展示選項默認值的註釋， 目的在於方便系統管
       理員查看和直接修改。

       如果軟件包想要自定義某些默認設置， 那麼必須將自定義的配置文件安裝到
       /usr/lib/systemd/*.conf.d/ 目錄中。 /etc/ 目錄僅供系統管理員使用。 系統管理員可以利用下面
       的邏輯來覆蓋默認設置： 主配置文件最先被讀取， 優先級也最低。 所有 *.conf.d/ 中的配置文件
       都會覆蓋主配置文件中的設置。 所有 *.conf.d/ 中的配置文件(無論位於哪個目錄中)， 統一按照文
       件名的字典順序處理。 如果在多個配置文件中設置了同一個選項， 那麼僅以文件名最靠後(字典順
       序)的那一個爲準。 爲了便於排序， 建議給所有 *.conf.d/ 中的配置文件 都加上兩位十進制數字的
       文件名前綴。

       如果系統管理員想要屏蔽 /usr/lib/ 目錄中的某個配置文件， 那麼最佳做法是在 /etc/ 目錄中 創建
       一個指向 /dev/null 的同名符號鏈接， 即可徹底屏蔽 /usr/lib/ 目錄中的同名文件。

選項

       所有選項都位於 "[Journal]" 小節：

       Storage=
           在哪裏存儲日誌文件： "volatile" 表示僅保存在內存中， 也就是僅保存在 /run/log/journal
           目錄中(將會被自動按需創建)。 "persistent" 表示優先保存在磁盤上， 也就優先保存在
           /var/log/journal 目錄中(將會被自動按需創建)， 但若失敗(例如在系統啓動早期"/var"尚未掛
           載)， 則轉而保存在 /run/log/journal 目錄中(將會被自動按需創建)。 "auto"(默認值) 與
           "persistent" 類似， 但不自動創建 /var/log/journal 目錄， 因此可以根據該目錄的存在與否
           決定日誌的保存位置。 "none" 表示不保存任何日誌(直接丟棄所有收集到的日誌)， 但日誌轉
           發(見下文)不受影響。 默認值是 "auto"

       Compress=
           默認值"yes"表示： 壓縮存儲大於特定閾值的對象。

       Seal=
           默認值"yes"表示：如果存在一個"sealing key"(由 journalctl(1) 的 --setup-keys 命令創
           建)， 那麼就爲所有持久保存的日誌文件啓用 FSS(Seekable Sequential Key Generators[1])保
           護， 以避免日誌文件被惡意或無意的修改。

       SplitMode=
           設置如何按用戶分割日誌文件，以實現不同的訪問控制策略(日誌守護進程會確保每個用戶都能讀
           取自己的日誌文件)。 注意，僅分割持久保存的日誌(/var/log/journal)，永不分割內存中的日
           誌(/run/log/journal)。 可以使用的分割策略如下： "uid" 表示每個用戶都有自己專屬的日誌文
           件(無論該用戶是否擁有登錄會話)， 但系統用戶的日誌依然記錄到系統日誌中。這是默認值。

           "none" 表示不對日誌文件進行分割，而是將所有日誌都記錄到系統日誌中。 這意味着非特權用戶
           根本無法讀取屬於自己的日誌信息。

       RateLimitIntervalSec=, RateLimitBurst=
           用於限制日誌的生成速度(設爲零表示不作限制)。 RateLimitIntervalSec= 用於設置一個時間段
           長度，默認值是30秒。 RateLimitBurst= 用於設置一個正整數，表示消息條數，默認值
           是1000條。 表示在 RateLimitIntervalSec= 時間段內， 每個服務最多允許產生
           RateLimitBurst= 數量(條數)的日誌。 在同一個時間段內，超出數量限制的日誌將被丟棄，直到
           下一個時間段才能再次開始記錄。 對於所有被丟棄的日誌消息，僅用一條類似"xxx條消息被丟
           棄"的消息來代替。 這個限制是針對每個服務的限制，一個服務超限並不會影響到另一個服務的日
           誌記錄。 RateLimitIntervalSec= 可以使用下面的時間單位："ms", "s", "min", "h", "d"

       SystemMaxUse=, SystemKeepFree=, SystemMaxFileSize=, SystemMaxFiles=, RuntimeMaxUse=,
       RuntimeKeepFree=, RuntimeMaxFileSize=, RuntimeMaxFiles=
           限制日誌文件的大小上限。 以 "System" 開頭的選項用於限制磁盤使用量， 也就是
           /var/log/journal 的使用量。 以 "Runtime" 開頭的選項用於限制內存使用量， 也就是
           /run/log/journal 的使用量。 以 "System" 開頭的選項僅在 /var/log/journal 目錄確實存在且
           可寫時纔有意義。 但以 "Runtime" 開頭的選項永遠有意義。 也就是說， 在系統啓動早期 /var
           尚未掛載時、 或者系統管理員禁止在磁盤上存儲日誌的時候， 僅有 "Runtime" 開頭的選項有意
           義。 journalctl 與 systemd-journald 工具會忽略日誌目錄中 所有後綴名不等於 ".journal"
           或 ".journal~" 的文件。 換句話說， 日誌目錄中不應該存在後綴名不等於 ".journal" 或
           ".journal~" 的文件， 因爲這些文件永遠不會被清理。

           SystemMaxUse= 與 RuntimeMaxUse= 限制全部日誌文件加在一起最多可以佔用多少空間。
           SystemKeepFree= 與 RuntimeKeepFree= 表示除日誌文件之外，至少保留多少空間給其他用途。
           systemd-journald 會同時考慮這兩個因素， 並且儘量限制日誌文件的總大小，以同時滿足這兩個
           限制。

           SystemMaxUse= 與 RuntimeMaxUse= 的默認值是10%空間與4G空間兩者中的較小者；
           SystemKeepFree= 與 RuntimeKeepFree= 的默認值是15%空間與4G空間兩者中的較大者； 如果在
           systemd-journald 啓動時， 文件系統即將被填滿並且已經超越了 SystemKeepFree= 或
           RuntimeKeepFree= 的限制，那麼日誌記錄將被暫停。 也就是說，如果在創建日誌文件時，文件系
           統有充足的空閒空間， 但是後來文件系統被其他非日誌文件過多佔用， 那麼 systemd-journald
           只會立即暫停日誌記錄， 但不會刪除已經存在的日誌文件。

           SystemMaxFileSize= 與 RuntimeMaxFileSize= 限制單個日誌文件的最大體積， 到達此限制後日
           志文件將會自動滾動。 默認值是對應的 SystemMaxUse= 與 RuntimeMaxUse= 值的1/8 ， 這也意
           味着日誌滾動默認保留7個歷史文件。

           日誌大小的值可以使用以1024爲基數的 K, M, G, T, P, E 後綴， 分別對應於 1024, 1024², ...
           字節。

           SystemMaxFiles= 與 RuntimeMaxFiles= 限制最多允許同時存在多少個日誌文件， 超出此限制
           後， 最老的日誌文件將被刪除， 而當前的活動日誌文件則不受影響。 默認值爲100個。

       MaxFileSec=
           日誌滾動的時間間隔。 通常並不需要使用基於時間的日誌滾動策略， 因爲由
           SystemMaxFileSize= 與 RuntimeMaxFileSize= 控制的基於文件大小的日誌滾動策略 已經可以確
           保日誌文件的大小不會超標。 默認值是一個月， 設爲零表示禁用基於時間的日誌滾動策略。 可
           以使用 "year", "month", "week", "day", "h", "m" 時間後綴， 若不使用後綴則表示以秒爲單
           位。

       MaxRetentionSec=
           日誌文件的最大保留期限。 當日志文件的最後修改時間超過此期限後將被刪除。 默認值零表示不
           使用基於時間的日誌刪除策略。 通常並不需要使用基於時間的日誌刪除策略，因爲由
           SystemMaxUse= 與 RuntimeMaxUse= 控制的基於文件大小的日誌滾動策略 已經可以確保日誌文件
           的大小不會超標。 可以使用 "year", "month", "week", "day", "h", "m" 時間後綴， 若不使用
           後綴則表示以秒爲單位。

       SyncIntervalSec=
           向磁盤刷寫日誌文件的時間間隔，默認值是五分鐘。 刷寫之後，日誌文件將會處於離
           線(OFFLINE)狀態。 注意，當接收到 CRIT, ALERT, EMERG 級別的日誌消息後， 將會無條件的立
           即刷寫日誌文件。 因此該設置僅對 ERR, WARNING, NOTICE, INFO, DEBUG 級別的日誌消息有意
           義。

       ForwardToSyslog=, ForwardToKMsg=, ForwardToConsole=, ForwardToWall=
           ForwardToSyslog= 表示是否將接收到的日誌消息轉發給傳統的 syslog[2] 守護進程，默認值
           爲"no"。 如果設爲"yes"，但是沒有任何進程監聽對應的套接字，那麼這種轉發是無意義的。 此
           選項可以被內核引導選項 "systemd.journald.forward_to_syslog=" 覆蓋。 ForwardToKMsg= 表
           示是否將接收到的日誌消息轉發給內核日誌緩衝區(kmsg)，默認值爲"no"。 此選項可以被內核引
           導選項 "systemd.journald.forward_to_kmsg=" 覆蓋。 ForwardToConsole= 表示是否將接收到的
           日誌消息轉發給系統控制檯，默認值爲"no"。 如果設爲"yes"，那麼可以通過下面的 TTYPath= 指
           定轉發目標。 此選項可以被內核引導選項 "systemd.journald.forward_to_console=" 覆蓋。
           ForwardToWall= 表示是否將接收到的日誌消息作爲警告信息發送給所有已登錄用戶，默認值
           爲"yes"。 此選項可以被內核引導選項 "systemd.journald.forward_to_wall=" 覆蓋。

       MaxLevelStore=, MaxLevelSyslog=, MaxLevelKMsg=, MaxLevelConsole=, MaxLevelWall=
           MaxLevelStore= 設置記錄到日誌文件中的最高日誌等級，默認值爲"debug"； MaxLevelSyslog=
           設置轉發給傳統的 syslog[2] 守護進程的最高日誌等級，默認值爲"debug"； MaxLevelKMsg= 設
           置轉發給內核日誌緩衝區(kmsg)的最高日誌等級，默認值爲"notice"； MaxLevelConsole= 設置轉
           發給系統控制檯的最高日誌等級，默認值爲"info"； MaxLevelWall= 設置作爲警告信息發送給所
           有已登錄用戶的最高日誌等級，默認值爲"emerg"； 這些選項既可以設爲日誌等級的名稱， 也可
           以設爲日誌等級對應的數字： "emerg"(0), "alert"(1), "crit"(2), "err"(3), "warning"(4),
           "notice"(5), "info"(6), "debug"(7) 。 所有高於設定等級的日誌消息都將被直接丟棄， 僅保
           存/轉發小於等於設定等級的日誌消息。

       TTYPath=
           指定 ForwardToConsole=yes 時所使用的控制檯TTY， 默認值是 /dev/console

日誌轉發

       有兩種不同的日誌轉發方法： (1)通過套接字文件(/run/systemd/journal/syslog) 可以將收集到的日
       誌消息 立即轉發給套接字的監聽進程(傳統的 syslog[2] 守護進程)。 此方法受 ForwardToSyslog=
       指令的控制。 (2)日誌接收進程作爲客戶端運行，就像 journalctl(1) 一樣讀取日誌文件。 因此，此
       方法在 Storage=none 時無效。 此方法不能實時讀取日誌消息， 但是可以讀取先前保存的日誌消
       息(例如在系統啓動完成之後讀取系統啓動早期的日誌消息)。 此方法還可以讀取到完整的日誌元數
       據。 此方法一般無法讀取當前最新的日誌消息， 只能讀取已經被記錄到文件系統上的日誌消息。 注
       意，syslog[2] 守護進程通常使用此方法(而不是前一種方法)， 因此 Storage= 選項(而不是
       ForwardToSyslog= 選項) 不應該設爲"none"。

參見

       systemd(1), systemd-journald.service(8), journalctl(1), systemd.journal-fields(7),
       systemd-system.conf(5)

NOTES

        1. Seekable Sequential Key Generators
           https://eprint.iacr.org/2013/397

        2. syslog
           //linux/sysklogd.html

跋

       本頁面中文版由中文 man 手冊頁計劃提供。

       翻譯人員：金步國
       金步國作品集：http://www.jinbuguo.com
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh