Google Cloud Logging 驱动程序

Google Cloud Logging 驱动程序将容器日志发送到 Google Cloud Logging Logging。

用法

要使用 gcplogs 驱动程序作为默认日志驱动程序,请在 daemon.json 文件(Linux 主机上位于 /etc/docker/,Windows Server 上位于 C:\ProgramData\docker\config\daemon.json)中将 log-driverlog-opt 键设置为适当的值。有关使用 daemon.json 配置 Docker 的更多信息,请参阅 daemon.json

以下示例将日志驱动程序设置为 gcplogs 并设置了 gcp-meta-name 选项。

{
  "log-driver": "gcplogs",
  "log-opts": {
    "gcp-meta-name": "example-instance-12345"
  }
}

重启 Docker 以使更改生效。

您可以使用 docker run--log-driver 选项为特定容器设置日志驱动程序

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

如果 Docker 检测到它正在 Google Cloud 项目中运行,它会从实例元数据服务中发现配置。否则,用户必须使用 --gcp-project 日志选项指定要记录到哪个项目,并且 Docker 将尝试从 Google Application Default Credential 获取凭据。--gcp-project 标志优先于从元数据服务器发现的信息,因此在 Google Cloud 项目中运行的 Docker 守护程序可以使用 --gcp-project 覆盖以记录到不同的项目。

Docker 从 Google Cloud 元数据服务器获取 zone、instance name 和 instance ID 的值。如果元数据服务器不可用,可以通过选项提供这些值。它们不会覆盖元数据服务器提供的值。

gcplogs 选项

您可以使用 --log-opt NAME=VALUE 标志来指定这些额外的 Google Cloud Logging 驱动程序选项

选项必需描述
gcp-project可选要记录到哪个 Google Cloud 项目。默认情况下从 Google Cloud 元数据服务器发现此值。
gcp-log-cmd可选是否记录容器启动时使用的命令。默认为 false。
labels可选标签键的逗号分隔列表,如果这些标签为容器指定,则应包含在消息中。
labels-regex可选类似于 labels 并与其兼容。用于匹配日志相关标签的正则表达式。用于高级日志标签选项
env可选环境变量键的逗号分隔列表,如果这些变量为容器指定,则应包含在消息中。
env-regex可选类似于 env 并与其兼容。用于匹配日志相关环境变量的正则表达式。用于高级日志标签选项
gcp-meta-zone可选实例的区域名称。
gcp-meta-name可选实例名称。
gcp-meta-id可选实例 ID。

如果 labelenv 键发生冲突,env 的值优先。这两个选项都会向日志消息的属性添加额外的字段。

以下是记录到通过查询 Google Cloud 元数据服务器发现的默认日志目标的所需日志选项示例。

$ 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

此配置还指示驱动程序在负载中包含标签 location、环境变量 ENV 和用于启动容器的命令。

以下示例显示了在 Google Cloud 外部运行时的日志选项。必须为守护程序设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量,例如通过 systemd。

[Service]
Environment="GOOGLE_APPLICATION_CREDENTIALS=uQWVCPkMTI34bpssr1HI"
$ 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
页面选项