?
This document uses PHP Chinese website manual Release
Google Cloud Logging 驅(qū)動程序?qū)⑷萜魅罩景l(fā)送到 Google Cloud Logging Logging。
要將gcplogs
驅(qū)動程序用作默認日志記錄驅(qū)動程序,請將該鍵log-driver
和log-opt
鍵設置daemon.json
為位于/etc/docker/
在Linux主機上或C:\ProgramData\docker\config\daemon.json
在Windows Server 上的文件中的適當值。有關(guān) Docker 配置使用daemon.json
的更多信息,請參閱 daemon.json。
以下示例將日志驅(qū)動程序設置為gcplogs
并設置該gcp-meta-name
選項。
{ "log-driver": "gcplogs", "log-opts": { "gcp-meta-name": "example-instance-12345" }}
重新啟動 Docker 以使更改生效。
您可以使用以下--log-driver
選項來設置docker run
特定容器的日志記錄驅(qū)動程序:
docker run --log-driver=gcplogs ...
該日志驅(qū)動程序沒有實現(xiàn)與其docker logs
不兼容的閱讀器。
如果 Docker 檢測到它在 Google Cloud Project 中運行,它將從實例元數(shù)據(jù)服務中發(fā)現(xiàn)配置。否則,用戶必須使用--gcp-project
日志選項指定要登錄的項目,并且 Docker 將嘗試從Google應用程序默認憑證中獲取憑據(jù)。該--gcp-project
標志優(yōu)先于從元數(shù)據(jù)服務器發(fā)現(xiàn)的信息,因此可以覆蓋在 Google 云項目中運行的Docker守護程序以使用--gcp-project
登錄到其他 Google 云項目。
Docker 從 Google 云元數(shù)據(jù)服務器獲取區(qū)域,實例名稱和實例 ID 的值。如果元數(shù)據(jù)服務器不可用,那么可以通過選項提供這些值。它們不會覆蓋元數(shù)據(jù)服務器的值。
您可以使用該--log-opt NAME=VALUE
標志來指定這些額外的 Google Cloud Logging 驅(qū)動程序選項:
選項 | 需要 | 描述 |
---|---|---|
gcp-project | 可選的 | 哪個GCP項目要登錄。默認從GCE元數(shù)據(jù)服務中發(fā)現(xiàn)此值。 |
gcp-log-cmd | 可選的 | 是否記錄容器啟動的命令。默認為false。 |
labels | 可選的 | 如果為容器指定了這些標簽,則應在消息中包含標簽的逗號分隔列表。 |
env | 可選的 | 如果為容器指定了這些變量,則應該在消息中包含環(huán)境變量的鍵的逗號分隔列表。 |
env-regex | 可選的 | 與env類似且兼容。一個正則表達式來匹配與日志相關(guān)的環(huán)境變量。用于高級日志標記選項。 |
gcp-meta-zone | 可選的 | 實例的區(qū)域名稱。 |
gcp-meta-name | 可選的 | 實例名稱。 |
gcp-meta-id | 可選的 | 實例ID。 |
如果label
和env
鍵之間存在沖突,則env
優(yōu)先。這兩個選項都將附加字段添加到日志消息的屬性中。
以下是登錄到通過查詢 GCE 元數(shù)據(jù)服務器發(fā)現(xiàn)的默認日志記錄目標所需的日志記錄選項示例。
docker run --log-driver=gcplogs \ --log-opt labels=location \ --log-opt env=TEST \ --log-opt gcp-log-cmd=true \ --env "TEST=false" \ --label location=west \ your/application
此配置還指示驅(qū)動程序在有效負載中包含標簽location
,環(huán)境變量ENV
和用于啟動容器的命令。
在 GCE 之外運行的日志記錄選項示例(守護程序必須配置為 GOOGLE_APPLICATION_CREDENTIALS):
docker run --log-driver=gcplogs \ --log-opt gcp-project=test-project --log-opt gcp-meta-zone=west1 \ --log-opt gcp-meta-name=`hostname` \ your/application