記錄代理程式總覽

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

在預設設定中，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 代理程式才能傳送記錄。

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

支援地端部署和混合雲

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)。

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

  • Logging API：logging.googleapis.com

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

  • (Linux) Google Cloud 套件存放區：packages.cloud.google.com

  • Google 下載伺服器：dl.google.com

不支援的受管理環境

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

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 前置字串。

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

廢止政策

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

後續步驟