Splunk 日誌驅動程式

splunk 日誌記錄驅動程式將容器日誌傳送到 Splunk Enterprise 和 Splunk Cloud 中的HTTP 事件收集器。

用法

您可以將 Docker 日誌記錄配置為預設使用 splunk 驅動程式，或在每個容器的基礎上使用。

要將 splunk 驅動程式用作預設日誌記錄驅動程式，請在 daemon.json 配置檔案中將 log-driver 和 log-opts 鍵設定為適當的值，然後重啟 Docker。例如：

{
  "log-driver": "splunk",
  "log-opts": {
    "splunk-token": "",
    "splunk-url": "",
    ...
  }
}

daemon.json 檔案位於 Linux 主機的 /etc/docker/ 或 Windows Server 的 C:\ProgramData\docker\config\daemon.json 中。有關使用 daemon.json 配置 Docker 的更多資訊，請參閱 daemon.json。

注意

daemon.json 配置檔案中的 log-opts 配置選項必須以字串形式提供。因此，布林值和數值（例如 splunk-gzip 或 splunk-gzip-level 的值）必須用引號（"）括起來。

要為特定容器使用 splunk 驅動程式，請在 docker run 中使用命令列標誌 --log-driver 和 log-opt：

$ docker run --log-driver=splunk --log-opt splunk-token=VALUE --log-opt splunk-url=VALUE ...

Splunk 選項

以下屬性可讓您配置 Splunk 日誌記錄驅動程式。

• 要在整個 Docker 環境中配置 splunk 驅動程式，請使用鍵 "log-opts": {"NAME": "VALUE", ...} 編輯 daemon.json。
• 要為單個容器配置 splunk 驅動程式，請使用帶 --log-opt NAME=VALUE ... 標誌的 docker run 命令。

如果 label 和 env 鍵之間存在衝突，則以 env 的值為準。這兩個選項都會向日志訊息的屬性中新增額外的欄位。

下面是為 Splunk Enterprise 例項指定的日誌記錄選項示例。該例項本地安裝在執行 Docker 守護程序的同一臺機器上。

根證書和通用名稱的路徑透過 HTTPS 方案指定。這用於驗證。SplunkServerDefaultCert 是由 Splunk 證書自動生成的。

$ docker run \
    --log-driver=splunk \
    --log-opt splunk-token=176FCEBF-4CF5-4EDF-91BC-703796522D20 \
    --log-opt splunk-url=https://splunkhost:8088 \
    --log-opt splunk-capath=/path/to/cert/cacert.pem \
    --log-opt splunk-caname=SplunkServerDefaultCert \
    --log-opt tag="{{.Name}}/{{.FullID}}" \
    --log-opt labels=location \
    --log-opt env=TEST \
    --env "TEST=false" \
    --label location=west \
    your/application

託管在 Splunk Cloud 上的 Splunk 例項的 splunk-url 格式類似於 https://http-inputs-XXXXXXXX.splunkcloud.com，不包含埠說明符。

訊息格式

有三種日誌記錄驅動程式訊息格式：inline（預設）、json 和 raw。

{
  "attrs": {
    "env1": "val1",
    "label1": "label1"
  },
  "tag": "MyImage/MyContainer",
  "source": "stdout",
  "line": "my message"
}

{
  "attrs": {
    "env1": "val1",
    "label1": "label1"
  },
  "tag": "MyImage/MyContainer",
  "source": "stdout",
  "line": "{\"foo\": \"bar\"}"
}

{
  "attrs": {
    "env1": "val1",
    "label1": "label1"
  },
  "tag": "MyImage/MyContainer",
  "source": "stdout",
  "line": "my message"
}

{
  "attrs": {
    "env1": "val1",
    "label1": "label1"
  },
  "tag": "MyImage/MyContainer",
  "source": "stdout",
  "line": {
    "foo": "bar"
  }
}

MyImage/MyContainer env1=val1 label1=label1 my message
MyImage/MyContainer env1=val1 label1=label1 {"foo": "bar"}

高階選項

Splunk 日誌記錄驅動程式允許您透過為 Docker 守護程序設定環境變數來配置一些高階選項。