記錄代理程式總覽

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

在預設設定中，Logging 代理程式會將常見第三方應用程式和系統軟體的記錄串流至 Logging；請參閱預設記錄清單。您可以設定 Logging 代理程式串流其他記錄；如要瞭解代理程式設定和運作的詳細資料，請參閱「設定 Logging 代理程式」。

建議您在所有 VM 執行個體上執行 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 VM，請按照 Container-Optimized OS 操作說明，從 VM 收集記錄。

支援的環境

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

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

    對於沒有外部 IP 位址的執行個體，您必須啟用 Private Google Access，才能允許 Logging 代理程式傳送記錄。

對於這些 VM 執行個體，執行 Logging 代理程式至少需要 250 MiB 的常駐 (RSS) 記憶體，但建議使用 1 GiB。舉例來說，如果每秒有 100 個大小為 1 KB 的記錄檔項目，預設設定的 Logging 代理程式會耗用一個核心的 5% CPU 和 150 MiB 記憶體。

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

支援地端和混合雲

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 套件中。您也可以前往 Ruby Gem 託管服務 (fluent-plugin-google-cloud) 取得這個外掛程式。
    • 與 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 的版本資訊位於 fluent-plugin-google-cloud/releases，版本標記採用 [Major].[Minor].[Patch] 語意版本格式。

廢止政策

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

後續步驟