关于 Logging 代理

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

Logging 代理的工作原理

在默认配置中,Logging 代理会将常见第三方应用和系统软件中的日志流式传输到 Logging;请参阅默认日志列表。您可以通过配置来让该代理流式传输更多日志。如需详细了解代理配置和操作,请转至配置 Logging 代理

最好在所有虚拟机实例上都运行 Logging 代理。该代理可在 Linux 和 Windows 上运行。如需安装 Logging 代理,请转至安装代理

如果您运行的专业化日志记录工作负载需要比标准 Cloud Logging 代理更高的吞吐量和/或更高的资源效率,请考虑使用 Ops Agent

支持的操作系统

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

  • CentOS 6、7 和 8
  • Debian 9“Stretch”和 10“Buster”
  • Red Hat Enterprise Linux 6、7 和 8
  • Ubuntu LTS 16.04 (Xenial Xerus)、LTS 18.04 (Bionic Beaver)、19.10 (Eoan Ermine) 和 LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 16.04 (Xenial Xerus)、LTS 18.04 (Bionic Beaver)、19.10 (Eoan Ermine) 和 LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 SP3、12 SP2 for SAP、12 SP3 for SAP、15、15 for SAP 和 15 SP1 for SAP
  • Windows Server 2008 R2、2012 R2、2016 和 2019
  • Windows Server Core 2008 R2、2012 R2、2016 和 2019
  • Windows Server Core 1809、1903、1909 版
  • Amazon Linux AMI(不含 Amazon Linux 2.0 AMI)

受支持的环境

Logging 代理与以下环境兼容:

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

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

支持本地和混合云

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

如需详细了解 Blue Medora,请转至 Blue Medora 简介

代理访问要求

运行代理需要访问以下 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

  • (Windows) Google 下载服务器:dl.google.com

Logging 代理源代码

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

Logging 代理 google-fluentdfluentd 日志数据收集器的修订版。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 的运维套件代理弃用政策

后续步骤