關於 Logging 代理程式

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

Logging 代理程式的運作方式

在預設設定中,Stackdriver Logging 代理程式會將記錄從常見第三方應用程式與系統軟體串流至 Stackdriver Logging;請參閱預設記錄的清單。您可以設定代理程式,使其串流其他記錄。如要瞭解代理程式設定與作業,請參閱設定 Stackdriver Logging 代理程式一文。

最佳做法是在所有 VM 執行個體上執行 Stackdriver Logging 代理程式。代理程式會在 Linux 與 Windows 下執行。如要安裝 Stackdriver Logging 代理程式,請參閱安裝記錄代理程式一文。

支援的作業系統

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

  • CentOS 6 與 7
  • Debian 9 "Stretch"
  • Red Hat Enterprise Linux 6 與 7
  • Ubuntu LTS 16.04「Xenial」、LTS 18.04「Bionic」與 18.10「Cosmic」
  • SUSE Linux Enterprise Server 12 SP3、12 SP2 for SAP 與 12 SP3 for SAP
  • Windows Server 2008 R2、2012 R2、2016 與 2019
  • Amazon Linux AMI (Amazon Linux 2.0 AMI 除外)

支援的環境

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

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

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

  • Amazon Web Services Elastic Compute Cloud (AWS EC2) 執行個體。Stackdriver Logging 代理程式會針對您的工作區,將記錄傳送至 AWS 連接器專案。Stackdriver 會在您將 AWS 帳戶連結至工作區時為您建立這個專案。

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

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

下列 VM 執行個體支援使用自己軟體的 Stackdriver Logging,其中可能包含 Stackdriver Logging 代理程式的自訂版本或設定。系統不支援在這些執行個體上手動安裝 Stackdriver Logging 代理程式:

代理程式存取需求

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

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

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

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

  • 記錄 API:logging.googleapis.com

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

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

  • (Windows) Google 下載伺服器:dl.google.com

Stackdriver Logging 代理程式原始碼

如果您不需要瞭解原始碼相關資訊,也沒有其他特殊需求,則可略過這部分的資訊。您可透過安裝操作說明中說明的指令碼安裝 Stackdriver Logging 代理程式。

Stackdriver Logging 代理程式 google-fluentdfluentd 記錄資料收集器的修改版本。 google-fluentd 分散在兩個不同的套件中。原始碼可以從關聯的 GitHub 存放區取得:

  • 名為 google-fluentd 的 GitHub 存放區,包含適用於 Stackdriver Logging API 的核心 fluentd 程式、自訂封裝指令碼與輸出外掛程式。
    • 輸出外掛程式會封裝成 Ruby Gem 並包含在 google-fluentd 套件中,也可以在 fluent-plugin-google-cloud 的 Ruby Gem 託管服務中單獨提供。
  • 名為 google-fluentd-catch-all-config 的 GitHub 存放區,包含適用於 Stackdriver Logging 代理程式的設定檔,用來從各種第三方軟體套件擷取記錄。

廢止政策

Stackdriver Logging 代理程式必須遵守 Stackdriver 代理程式廢止政策

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Stackdriver Logging
需要協助嗎?請前往我們的支援網頁