記錄代理程式總覽

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

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

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

如要安裝 Logging 代理程式，請參閱「安裝 Logging 代理程式」一文。

支援的作業系統

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

• CentOS 7 和 8
• Rocky Linux 8
• Red Hat Enterprise Linux 7 和 8
• Debian 9「Stretch」、10「Buster」和 11「Bullseye」
• Ubuntu LTS 20.04 (Focal Fossa)
• Ubuntu Minimal LTS 20.04 (Focal Fossa)
• SUSE Linux Enterprise Server 12 和 12 SP5 for SAP
• SUSE Linux Enterprise Server 15、15 SP2 for SAP、15 S3 for SAP、15 SP4 for SAP 和 15 SP5 for SAP
• OpenSUSE Leap 15、15.2、15.3 和 15.4
• Windows Server 2016 和 2019
• Windows Server Core 2016 和 2019
• Amazon Linux AMI (Amazon Linux 2.0 AMI 除外)

如果您執行 Container-Optimized OS VM，請按照 Container-Optimized OS 操作說明收集 VM 的記錄。

支援的環境

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

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

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

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

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

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

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

• App Engine 標準環境執行個體。App Engine 內建 Logging 支援。詳情請參閱「寫入應用程式記錄」。

• App Engine 彈性環境執行個體。在 App Engine 彈性環境中執行的應用程式，可以寫入不在 App Engine 標準環境所含記錄範圍內的記錄。詳情請參閱「寫入應用程式記錄」。

• Google Kubernetes Engine 節點執行個體。根據預設，系統會為新的容器叢集啟用含有 Logging 的記錄收集功能，您也可以為現有叢集啟用這項功能。詳情請參閱「設定 GKE 的記錄和監控功能」。

• 對於在 Google Distributed Cloud 上執行的執行個體，代理程式會收集系統記錄，但不會收集應用程式記錄。

• Cloud Run 容器執行個體。Cloud Run 內建 Logging 支援功能。詳情請參閱「記錄及查看記錄」。

• Cloud Run 函式：HTTP 和背景函式。Cloud Run functions 內建記錄支援功能。

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

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 代理程式 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/releases 中找到獨立寶石 fluent-plugin-google-cloud 的版本資訊，其中的版本標記會遵循 [Major].[Minor].[Patch] 語意版本格式。

廢止政策

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

後續步驟

• 安裝記錄代理程式

• 設定記錄代理程式

• 授權 Logging 代理程式

• 升級記錄代理程式

• 安裝代理程式後，請在 Logs Explorer 中查看記錄。