Splunk ロギング・ドライバ¶

splunk ロギング・ドライバは、コンテナのログを Splunk Enterprise もしくは Splunk Cloud の HTTP Event Collector に送ります。

使い方 ¶

デフォルトのロギング・ドライバを変更するには、Docker デーモンに --log-driver オプションを付けます。

docker daemon --log-driver=splunk

特定のコンテナに対してロギング・ドライバを指定するには、 docker run の実行時に --log-driver オプションを付けます。

docker run --log-driver=splunk ...

Splunk オプション ¶

Splunnk ロギング・ドライバでは、--log-opt 名前=値 フラグを指定できます。

オプション	必須	説明
`splunk-token`	必須	Splunk HTTP Event Collector トークンを指定
`splunk-url`	必須	Splunk Enterprise または Splunk Cloud インスタンスに対するパス（HTTP Event Collector の使うポートとスキームを含む） `https://your_splunk_instance:8088`
`splunk-source`	オプション	イベント・ソース
`splunk-sourcetype`	オプション	イベント・ソースのタイプ
`splunk-index`	オプション	Event インデックス
`splunk-capath`	オプション	root 証明書のパス
`splunk-caname`	オプション	サーバ証明書に使う有効な名前。デフォルトでは `splunk-url` で指定したホスト名が使われる。
`splunk-insecureskipverify`	オプション	サーバ証明書の認証を無効化。
`splunk-tag`	オプション	メッセージに対するタグを指定。いくつかのマークアップを利用可能。デフォルトの値は `{{.ID}}` （コンテナ ID の12文字）。ログのタグ書式のカスタマイズ方法は、ログ・ドライバー出力のカスタマイズを参照。
`splunk-labels`	オプション	メッセージに含めるラベルを、カンマ区切りのキーで指定できる。ラベルはコンテナで指定できる。
`splunk-env`	オプション	メッセージに含める環境変数を、カンマ区切りのキーで指定できる。これらの変数はコンテナで指定できる。

label と env のキーが重複する場合は、 env が優先されます。どちらのオプションも、ロギング・メッセージの追加フィールドに追加できるものです。

以下はロギング・ドライバに Splunk Enterprise インスタンスを指定する例です。インスタンスは Docker デーモンを実行している同じマシン上のローカルにインストールされています。root 証明書とコモンネームの指定には HTTP スキームを使います。これが証明書の使い方です。 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 logging driver: https://docs.docker.com/engine/admin/logging/splunk/

Splunk ロギング・ドライバ¶

使い方¶

Splunk オプション¶

使い方 ¶

Splunk オプション ¶