?
このドキュメントでは、 php中國(guó)語(yǔ)ネットマニュアル リリース
Google Cloud Logging 驅(qū)動(dòng)程序?qū)⑷萜魅罩景l(fā)送到 Google Cloud Logging Logging。
要將gcplogs
驅(qū)動(dòng)程序用作默認(rèn)日志記錄驅(qū)動(dòng)程序,請(qǐng)將該鍵log-driver
和log-opt
鍵設(shè)置daemon.json
為位于/etc/docker/
在Linux主機(jī)上或C:\ProgramData\docker\config\daemon.json
在Windows Server 上的文件中的適當(dāng)值。有關(guān) Docker 配置使用daemon.json
的更多信息,請(qǐng)參閱 daemon.json。
以下示例將日志驅(qū)動(dòng)程序設(shè)置為gcplogs
并設(shè)置該gcp-meta-name
選項(xiàng)。
{ "log-driver": "gcplogs", "log-opts": { "gcp-meta-name": "example-instance-12345" }}
重新啟動(dòng) Docker 以使更改生效。
您可以使用以下--log-driver
選項(xiàng)來(lái)設(shè)置docker run
特定容器的日志記錄驅(qū)動(dòng)程序:
docker run --log-driver=gcplogs ...
該日志驅(qū)動(dòng)程序沒(méi)有實(shí)現(xiàn)與其docker logs
不兼容的閱讀器。
如果 Docker 檢測(cè)到它在 Google Cloud Project 中運(yùn)行,它將從實(shí)例元數(shù)據(jù)服務(wù)中發(fā)現(xiàn)配置。否則,用戶必須使用--gcp-project
日志選項(xiàng)指定要登錄的項(xiàng)目,并且 Docker 將嘗試從Google應(yīng)用程序默認(rèn)憑證中獲取憑據(jù)。該--gcp-project
標(biāo)志優(yōu)先于從元數(shù)據(jù)服務(wù)器發(fā)現(xiàn)的信息,因此可以覆蓋在 Google 云項(xiàng)目中運(yùn)行的Docker守護(hù)程序以使用--gcp-project
登錄到其他 Google 云項(xiàng)目。
Docker 從 Google 云元數(shù)據(jù)服務(wù)器獲取區(qū)域,實(shí)例名稱和實(shí)例 ID 的值。如果元數(shù)據(jù)服務(wù)器不可用,那么可以通過(guò)選項(xiàng)提供這些值。它們不會(huì)覆蓋元數(shù)據(jù)服務(wù)器的值。
您可以使用該--log-opt NAME=VALUE
標(biāo)志來(lái)指定這些額外的 Google Cloud Logging 驅(qū)動(dòng)程序選項(xiàng):
選項(xiàng) | 需要 | 描述 |
---|---|---|
gcp-project | 可選的 | 哪個(gè)GCP項(xiàng)目要登錄。默認(rèn)從GCE元數(shù)據(jù)服務(wù)中發(fā)現(xiàn)此值。 |
gcp-log-cmd | 可選的 | 是否記錄容器啟動(dòng)的命令。默認(rèn)為false。 |
labels | 可選的 | 如果為容器指定了這些標(biāo)簽,則應(yīng)在消息中包含標(biāo)簽的逗號(hào)分隔列表。 |
env | 可選的 | 如果為容器指定了這些變量,則應(yīng)該在消息中包含環(huán)境變量的鍵的逗號(hào)分隔列表。 |
env-regex | 可選的 | 與env類似且兼容。一個(gè)正則表達(dá)式來(lái)匹配與日志相關(guān)的環(huán)境變量。用于高級(jí)日志標(biāo)記選項(xiàng)。 |
gcp-meta-zone | 可選的 | 實(shí)例的區(qū)域名稱。 |
gcp-meta-name | 可選的 | 實(shí)例名稱。 |
gcp-meta-id | 可選的 | 實(shí)例ID。 |
如果label
和env
鍵之間存在沖突,則env
優(yōu)先。這兩個(gè)選項(xiàng)都將附加字段添加到日志消息的屬性中。
以下是登錄到通過(guò)查詢 GCE 元數(shù)據(jù)服務(wù)器發(fā)現(xiàn)的默認(rèn)日志記錄目標(biāo)所需的日志記錄選項(xiàng)示例。
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ū)動(dòng)程序在有效負(fù)載中包含標(biāo)簽location
,環(huán)境變量ENV
和用于啟動(dòng)容器的命令。
在 GCE 之外運(yùn)行的日志記錄選項(xiàng)示例(守護(hù)程序必須配置為 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