Fluentd 日誌驅動程式

fluentd 日誌驅動程式會將容器日誌以結構化日誌數據的形式傳送到 Fluentd 收集器。之後，使用者可以利用 Fluentd 各種輸出外掛程式將這些日誌寫入不同的目的地。

除了日誌訊息本身，fluentd 日誌驅動程式還會在結構化日誌訊息中傳送以下詮釋資料：

欄位	描述
`container_id`	完整的 64 字元容器 ID。
`container_name`	容器啟動時的名稱。如果您使用 `docker rename` 重新命名容器，新名稱不會反映在日誌項目中。
`來源`	`stdout` 或 `stderr`
`log`	容器日誌

使用方式

某些選項可以透過多次指定 --log-opt 來支援

fluentd-address：指定連線至 Fluentd 守護行程的 Socket 位址，例如 fluentdhost:24224 或 unix:///path/to/fluentd.sock。
tag：為 Fluentd 訊息指定標籤。支援部分 Go 模板標記，例如 {{.ID}}、{{.FullID}} 或 {{.Name}}，範例：docker.{{.ID}}。

若要將 fluentd 驅動程式作為預設日誌驅動程式，請在 daemon.json 檔案中設定 log-driver 與 log-opt 鍵值。該檔案位於 Linux 主機的 /etc/docker/ 目錄下，或 Windows Server 的 C:\ProgramData\docker\config\daemon.json。關於如何使用 daemon.json 設定 Docker 的詳細資訊，請參閱 daemon.json。

以下範例將日誌驅動程式設定為 fluentd 並設定了 fluentd-address 選項。

{
  "log-driver": "fluentd",
  "log-opts": {
    "fluentd-address": "fluentdhost:24224"
  }
}

重新啟動 Docker 以使變更生效。

注意
daemon.json 設定檔中的 log-opts 選項必須以字串形式提供。因此，布林值與數值（例如 fluentd-async 或 fluentd-max-retries 的值）必須用引號 (") 括起來。

若要為特定容器設定日誌驅動程式，請在執行 docker run 時傳遞 --log-driver 選項：

$ docker run --log-driver=fluentd ...

在使用此日誌驅動程式之前，請先啟動 Fluentd 守護行程。預設情況下，日誌驅動程式會透過 localhost:24224 連線至此守護行程。若要連線至不同位址，請使用 fluentd-address 選項。

$ docker run --log-driver=fluentd --log-opt fluentd-address=fluentdhost:24224

除非使用了 fluentd-async 選項，否則如果容器無法連線至 Fluentd 守護行程，容器會立即停止。

選項

使用者可以使用 --log-opt NAME=VALUE 旗標來指定額外的 Fluentd 日誌驅動程式選項。

fluentd-address

預設情況下，日誌驅動程式會連線至 localhost:24224。若要連線至不同位址，請提供 fluentd-address 選項。支援 tcp（預設）與 unix socket。

$ docker run --log-driver=fluentd --log-opt fluentd-address=fluentdhost:24224
$ docker run --log-driver=fluentd --log-opt fluentd-address=tcp://fluentdhost:24224
$ docker run --log-driver=fluentd --log-opt fluentd-address=unix:///path/to/fluentd.sock

上述兩個範例皆指定了相同位址，因為 tcp 是預設協定。

<source>
  @type forward
</source>

<match *>
  @type stdout
</match>

使用此設定檔啟動 Fluentd 容器

$ docker run -it -p 24224:24224 -v /path/to/conf/test.conf:/fluentd/etc/test.conf -e FLUENTD_CONF=test.conf fluent/fluentd:latest

使用 fluentd 日誌驅動程式啟動一個或多個容器
$ docker run --log-driver=fluentd your/application

Fluentd 日誌驅動程式

使用方式

選項

fluentd-address

tag

labels, labels-regex, env, 以及 env-regex

fluentd-async

fluentd-async-reconnect-interval

fluentd-buffer-limit

fluentd-retry-wait

fluentd-max-retries

fluentd-sub-second-precision

fluentd-write-timeout

使用 Docker 管理 Fluentd 守護行程

測試容器日誌記錄器