Container-Optimized OS 包含一个日志记录代理，可将一些系统和容器日志导出到 Cloud Logging。在 Container-Optimized OS 101 之前，基于 x86 的 Container-Optimized OS 映像使用的是基于 fluentd 的容器化日志记录代理。Container-Optimized OS 105 开始提供替代的日志记录代理实现 fluent-bit。从 Container-Optimized OS 109 开始，fluent-bit 日志记录代理是默认代理。旧版 Logging 代理 fluentd 将从 Container-Optimized OS 113 中移除。
所有基于 ARM 的 Container-Optimized OS 映像的版本都附带 fluent-bit 日志记录代理。
启用 Logging 代理
Logging 代理默认处于停用状态。您可以在创建新实例或更新现有实例时启用此功能。
访问权限要求
Cloud Logging 提供了 IAM 角色，您可以使用这些角色授予适当的访问权限。要查看项目中的日志，您必须拥有 roles/logging.viewer 角色，并且应用必须具有写入日志的权限。您可以通过将 IAM 角色 roles/logging.logWriter 分配给应用的服务帐号来授予此权限。
如需详细了解权限和角色，请参阅预定义角色。
创建启用了 Logging 代理的实例
控制台
如需在启用了 fluent-bit Logging 代理的 Container-Optimized OS 上运行 Compute Engine 实例，请执行以下操作：
在 Google Cloud 控制台上打开 Compute Engine 实例创建页面。
为您的实例指定名称。
在启动磁盘部分中，选择一个 Container-Optimized OS 映像。
点击管理、安全、磁盘、网络、单租户以展开其他选项。
在管理标签页下，滚动到元数据部分。添加新的元数据条目，其中键为
google-logging-enabled，值为true。（可选）为您的使用场景指定任何其他选项。如需了解详情，请参阅创建和配置实例。
单击创建以创建并启动实例。
gcloud
如需在启用了 Logging 代理的 Container-Optimized OS 上运行 Compute Engine 实例，请使用 gcloud compute instances create 命令，并在元数据中包含 google-logging-enabled=true。例如：
gcloud compute instances create instance-name \
--image-family cos-stable \
--image-project cos-cloud \
--zone compute-zone \
--metadata google-logging-enabled=true
替换以下内容：
- instance-name：虚拟机实例的名称。
- compute-zone：您的实例的计算可用区。
如需详细了解 gcloud 命令，请参阅 gcloud compute instances create 参考文档。如需详细了解如何创建 Container-Optimized OS 实例，请参阅创建和配置实例。
选择 Logging 代理
基于 x86 的 Container-Optimized OS 105 和 109 映像包含 Logging 代理的两种实现：fluentd（旧版）和 fluent-bit。Container-Optimized OS 105 默认使用 fluentd，而 Container-Optimized OS 109 默认使用 fluent-bit。您可以使用 google-logging-use-fluentbit 元数据条目来更改默认行为。
如需在 Container-Optimized OS 105 上使用 fluent-bit Logging 代理，请将 google-logging-use-fluentbit 值设置为 true。
如需在 Container-Optimized OS 109 上使用 fluentd Logging 代理，请将 google-logging-use-fluentbit 值设置为 false。
在项目元数据中启用日志记录代理
从里程碑 97 开始，可以在项目元数据中启用日志记录功能：
gcloud compute project-info add-metadata \
--metadata google-logging-enabled=true
访问日志
控制台
转到“虚拟机实例”页面。
点击要访问其日志的 Container-Optimized OS 实例的名称。
在日志部分下，点击 Cloud Logging。
此操作会打开给定实例的日志浏览器。如需了解详情，请参阅使用日志浏览器。
gcloud
如需访问日志，请使用 gcloud logging read 命令。例如：
gcloud logging read \
"resource.type=gce_instance AND resource.labels.instance_id=instance-id" \
--limit 10 \
--format json \
--freshness 30d
替换以下内容：
- instance-id：您的虚拟机实例的 ID。
此命令尝试使用 instance-id 从虚拟机实例读取最近 30 天的 JSON 格式日志，最多 10 条。
如需详细了解 gcloud 命令，请参阅 gcloud logging read 参考文档。
工作原理
Logging 代理默认配置为将日志从某些系统关键服务和用户应用容器发送到 Cloud Logging 后端。例如，来自 Docker 容器的日志、选定的 systemd 服务的日志、审核日志、日志日志错误等。如需了解完整的默认日志记录配置，请参阅 Container-Optimized OS 特定的配置源（x86 映像和 Arm 映像）。
对于 Container-Optimized OS 105 及更早版本的 x86 映像，Logging 代理是 Google Cloud 的运维套件的容器化旧版 Logging 代理。启动 Logging 代理的 Docker 命令在 Container-Optimized OS stackdriver-logging systemd 服务的源代码中定义。正在运行的容器化代理的版本在 Container-Optimized OS 的源 app-admin/stackdriver 目录中定义。
对于所有版本的 Arm 映像和适用于 Container-Optimized OS 109 及更高版本的 x86 映像，Logging 代理是一个名为 fluent-bit 的内置操作系统软件包。该代理内置于操作系统中，并与操作系统映像一起更新。
已知限制
与 gcplogs 驱动程序的兼容性
从里程碑 89 开始，如果启用了 Container-Optimized OS 附带的 Logging 代理并且为一个或多个容器启用了 Docker gcplogs 日志记录驱动程序，附带的 Logging 代理可能会输出大量警告日志记录。这可能会导致日志噪声和/或增加 Cloud Logging 相关费用。
解决方法是不使用 gcplogs 作为 Docker 日志记录驱动程序，而是使用 Container-Optimized OS 配置的默认驱动程序。请注意，Container-Optimized OS 附带的 Logging 代理会将容器日志导出到 Cloud Logging，因此不需要同时使用这两种解决方案。
Logging 代理配置兼容性
Logging 代理是基于 x86 的 Container-Optimized OS 映像上的基于 fluentd 的容器，也是基于 ARM 的 Container-Optimized OS 映像上的 fluent-bit 二进制文件。这两个代理的配置不兼容。如果您只依赖于操作系统映像内置的默认日志记录配置，则不会产生问题。但是，如果您有自定义日志记录配置，则在将工作负载迁移到基于其他架构的映像或新版 Container-Optimized OS 的映像时，可能会遇到中断。
引用
- Google Cloud 的运维套件的旧版 Logging 代理文档。Container-Optimized OS 中包含的容器化 Logging 代理是旧版 Logging 代理的一部分，因此本文档可以在 Container-Optimized OS 的范围之外更笼统地提供有关该代理的上下文。
- Google Cloud 的运维套件文档。Google Cloud 运维套件文档的首页；可能对您有所帮助。