記錄代理程式總覽

本指南提供 Logging 代理程式的基本資訊。Logging 代理程式是以 fluentd 為基礎的應用程式，可在虛擬機器 (VM) 執行個體上執行。

根據預設設定，Logging 代理程式會將常見第三方應用程式和系統軟體的記錄檔串流至 Logging；請參閱預設記錄清單。您可以設定代理程式串流傳輸其他記錄，如要進一步瞭解代理程式設定和作業，請參閱「設定 Logging 代理程式」。

最佳做法是在所有 VM 執行個體上執行 Logging 代理程式。代理程式會在 Linux 與 Windows 中執行。

如要安裝 Logging 代理程式，請參閱安裝 Logging 代理程式。

記錄代理程式的運作方式

支援的作業系統

您可以在相容的虛擬機器 (VM) 執行個體上，透過下列作業系統執行 Logging 代理程式：

  • Rocky Linux 8
  • RHEL 8：rhel-8-6-sap-ha、rhel-8-8-sap-ha
  • Debian 11 (Bullseye)
  • 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 VM，請按照 Container-Optimized OS 操作說明，從 VM 收集記錄。

支援的環境

Logging 代理程式與下列環境相容：

  • Compute Engine 執行個體。Logging 代理程式會將記錄傳送至與每個 VM 執行個體相關聯的專案。

    針對沒有外部 IP 位址的執行個體，您必須啟用私人 Google 存取權，才能允許 Logging 代理程式傳送記錄。

  • Amazon Elastic Compute Cloud (Amazon EC2) 執行個體。Logging 代理程式會將 AWS 的記錄傳送至 Google Cloud 專案。

    為了讓 Logging 代理程式正常運作，執行該代理程式的 Amazon EC2 執行個體必須能夠與 Google Cloud API，尤其是 Logging API 通訊。這需要外部 IP 位址或 VPC 網際網路閘道。

對於這些 VM 執行個體，必須要有至少 250 MiB 的常駐 (RSS) 記憶體，才能執行 Logging 代理程式，但建議使用 1 GiB 的記憶體。舉例來說，在每秒 100 個 1-KB 大小記錄項目的速率下，採用預設設定的 Logging 代理程式會耗用單核心中 5% 的 CPU，以及 150 MiB 的記憶體。

下列 VM 執行個體支援使用自有軟體記錄，因此不支援手動安裝記錄代理程式：

支援地端部署系統和混合雲

Google Cloud 與 Bindplane 合作，以一致且可預測的方式，為地端和混合雲平台提供記錄服務。您可以使用 Bindplane 收集自己的資料，並傳送至 Logging 進行分析。Bindplane 會與 Cloud Logging 整合，擷取基礎架構的資料，且專案會免費提供這項服務。

如要進一步瞭解 Bindplane 和 Bindplane，請參閱「關於 Bindplane 和 Bindplane」。

代理程式存取需求

執行代理程式需要存取以下 DNS 名稱：

  • OAuth2 憑證伺服器：oauth2.googleapis.com

    舊版代理程式可能需要存取 www.googleapis.com (完整網址：https://www.googleapis.com/oauth2/v3/token)。

    如果您正在使用舊版代理程式，建議您更新代理程式為最新版本。

  • 記錄 API：logging.googleapis.com

安裝代理程式需要存取以下 DNS 名稱：

  • (Linux) Google Cloud 套件存放區：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 代理程式的設定檔，用來從各種第三方軟體套件擷取記錄。

記錄代理程式版本資訊

  • 如要查看 google-fluentd Linux 套件的版本資訊，請前往 google-fluentd/releases，其中版本標記遵循 [Major].[Minor].[Patch] 語意版本格式。

  • Windows 安裝程式的版本資訊位於相同位置：google-fluentd/releases。但發布標記的前置字串是 Windows。

  • 如要查看獨立寶石 fluent-plugin-google-cloud 的版本資訊，請前往 fluent-plugin-google-cloud/releases，版本標記採用 [Major].[Minor].[Patch] 語意版本格式。

廢止政策

Logging 代理程式必須遵守 Google Cloud Observability 代理程式廢止政策。

後續步驟