記錄代理程式總覽

本指南提供 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
  • 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 代理程式傳送記錄。

對於這些 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 代理程式廢止政策。

後續步驟