Logging 代理概览

本指南介绍了 Logging 代理，这是一种基于在虚拟机 (VM) 实例上运行的 fluentd 的应用。

在默认配置中，Logging 代理会将常见第三方应用和系统软件中的日志流式传输到 Logging；请参阅默认日志列表。您可以将该代理配置为流式传输更多日志；如需详细了解代理配置和操作，请前往配置 Logging 代理。

最好在所有虚拟机实例上都运行 Logging 代理。该代理可在 Linux 和 Windows 上运行。

如需安装 Logging 代理，请参阅安装 Logging 代理。

Logging 代理的工作原理

支持的操作系统

您可以使用以下操作系统，在兼容的虚拟机 (VM) 实例上运行 Logging 代理：

  • Rocky Linux 8
  • RHEL 8：rhel-8-6-sap-ha、rhel-8-8-sap-ha
  • SLES 12：sles-12-sp5-sap
  • SLES 15：sles-15-sp6、sles-15-sp3-sap、sles-15-sp4-sap、sles-15-sp5-sap
  • Windows Server 2016 和 2019
  • Windows Server Core 2016 和 2019

如果您运行的是 Container-Optimized OS 虚拟机，请按照 Container-Optimized OS 说明从虚拟机收集日志。

受支持的环境

Logging 代理与以下环境兼容：

这些虚拟机实例运行 Logging 代理时，至少需要 250 MiB 的常驻 (RSS) 内存，但建议留出 1 GiB 可用内存。举例来说，按每秒处理 100 个 1 KB 大小的日志条目的速率计算，使用默认配置的 Logging 代理将占用 5% 的 CPU（单核）和 150 MiB 的内存。

以下虚拟机实例使用自己的软件支持 Logging，因此不支持在其上手动安装 Logging 代理：

支持本地和混合云

Google Cloud 与 Bindplane 合作，以一种一致且可预测的方式为本地和混合云平台提供日志记录服务。使用 Bindplane，您可以收集自己的数据并将其发送到 Logging 进行分析。Bindplane 与 Cloud Logging 集成，可从您的基础设施中捕获数据，并且包含在您的项目中，不会产生额外的费用。

如需详细了解 Bindplane，请参阅 Bindplane 简介。

代理访问要求

运行代理需要访问以下 DNS 名称：

  • OAuth2 令牌服务器：oauth2.googleapis.com

    旧版代理可能需要访问 www.googleapis.com（完整网址：https://www.googleapis.com/oauth2/v3/token）。

    如果您使用的是旧版代理，建议您升级代理到最新版本。

  • Logging API：logging.googleapis.com

安装代理需要访问以下 DNS 名称：

  • (Linux) Google Cloud package repository：packages.cloud.google.com

  • Google 下载服务器：dl.google.com

Logging 代理源代码

除非您想了解相关源代码或有其他特殊需求，否则无需关注本部分中的信息。您可以通过安装说明中描述的脚本来安装 Logging 代理。

Logging 代理 google-fluentd 是 fluentd 日志数据收集器的修订版。google-fluentd 分布在两个独立的程序包中。源代码可从相关的 GitHub 代码库中获取：

  • 名为 google-fluentd 的 GitHub 代码库，其中包含核心 fluentd 程序、自定义封装脚本以及适用于 Cloud Logging API 的输出插件。
    • 输出插件作为 Ruby gem 封装，并包含在 google-fluentd 程序包中。它也可以通过 fluent-plugin-google-cloud 的 Ruby gem 托管服务单独获取。
    • 与 Windows 安装程序相关的内容位于 windows-installer 文件夹中。
  • 名为 google-fluentd-catch-all-config 的 GitHub 代码库，其中包含 Logging 代理用于从各种第三方软件包中提取日志的配置文件。

Logging 代理版本说明

  • 如需查看 google-fluentd Linux 软件包的版本说明，请访问 google-fluentd/releases，其中的版本标志采用 [Major].[Minor].[Patch] 语义化版本格式。

  • 您可以在同一位置找到 Windows 安装程序的版本说明：google-fluentd/releases。 但是，其版本标志带有 Windows 前缀。

  • 您可以在 fluent-plugin-google-cloud/releases 中找到独立的 gem fluent-plugin-google-cloud 的版本说明，其中的版本标志采用 [Major].[Minor].[Patch] 语义化版本格式。

弃用政策

Logging 代理需遵守 Google Cloud Observability 代理弃用政策。

后续步骤