安裝代理程式

Stackdriver Logging 代理程式會將記錄從您的 VM 執行個體與所選第三方軟體套件串流至 Stackdriver Logging。最佳做法是在所有的 VM 執行個體上執行 Stackdriver Logging 代理程式。

適用於 Compute Engine 與 AWS EC2 的 VM 映像檔不包含 Logging 代理程式,因此您必須在這些執行個體上安裝。代理程式會在 Linux 與 Windows 下執行。

事前準備

查看 Stackdriver Logging 代理程式是否支援您的 VM 執行個體,並瞭解工作區。如要進一步瞭解需求與支援的環境,請參閱關於 Stackdriver Logging 代理程式的說明。

支援的 VM 執行個體

一些種類的 VM 執行個體已經包含 Logging 代理程式,或與 Logging 代理程式類似的軟體。針對其他執行個體,您應該使用這個頁面中的操作說明安裝代理程式:

  • Google Cloud Platform (GCP) VM 執行個體:
    • App Engine:VM 映像檔中包含代理程式。請略過本頁面。
    • GKE:VM 映像檔中包含代理程式。請略過本頁面。
    • Compute Engine:在您的 VM 執行個體上安裝代理程式。VM 執行個體已經擁有必要授權。請參閱在 Linux 和 Windows 上安裝一文。
  • Amazon EC2:安裝代理程式之前,您必須先在您的 VM 執行個體上安裝授權憑證。安裝憑證完畢後,請回到本文以完成在 Linux 和 Windows 上安裝步驟。

安裝 Stackdriver Logging 代理程式時,必須有至少 250MB 的記憶體,但建議使用 1GB 的記憶體。

Stackdriver 計費

如果您使用 AWS VM 執行個體,必須將 AWS 帳戶連結至工作區,才能使用 Stackdriver Logging 代理程式。

詳情請參閱建立工作區一文。

沒有遠端套件存取權的 VM

安裝 Logging 代理程式需要存取遠端套件存放區,其中涵蓋代理程式與其在 Linux 上的依附元件。如果 VM 主機的安全性政策拒絕遠端套件存放區的存取,建議您建立已預先安裝代理程式的自訂 VM 映像檔並停用該映像檔中的套件管理功能。

在 Linux 和 Windows 上安裝

如要在執行 Linux 或 Microsoft Windows 的 VM 執行個體上安裝代理程式,請使用下列操作說明。

如果您嘗試啟用結構化記錄,請參閱結構化記錄的安裝操作說明

Linux 執行個體

  1. 使用 SSH 或類似工具開啟對 VM 執行個體的終端機連線。

  2. 在 VM 執行個體執行以下指令,下載 Logging 代理程式的安裝指令碼:

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    
  3. 使用下列指令執行安裝指令碼:

    sudo bash install-logging-agent.sh
    

安裝指令碼成功執行後,便可以刪除該指令碼。

Windows 執行個體

  1. 使用遠端桌面協定或類似工具開啟對執行個體的終端機連線,並登入 Windows。

  2. 如果您使用 HTTP Proxy,請從管理員命令提示字元執行下列指令。這將會設定 https_proxy 環境變數,使代理程式可以使用傳出 HTTPS 將資料傳送到 Stackdriver Logging:

    setx https_proxy https://[YOUR_PROXY_SERVER_URI] /m
    
  3. 開啟 PowerShell 終端機,然後執行下列三個 PowerShell 指令。您不需要管理員權限。

    cd $env:UserProfile;
    Invoke-WebRequest https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-9.exe -OutFile StackdriverLogging-v1-9.exe;
    .\StackdriverLogging-v1-9.exe
    

    如要以無訊息的方式安裝代理程式,請在叫用安裝程式時附加 /S 選項:

    .\StackdriverLogging-v1-9.exe /S
    

    在「無訊息」模式下,使用 /D 選項指定安裝目錄,例如:

    .\StackdriverLogging-v1-9.exe /S /D="C:\Stackdriver\Logging\"
    

如要驗證或測試 Stackdriver Logging 代理程式的安裝,請參閱驗證代理程式安裝一文。

如果在安裝過程中發生問題,請參閱疑難排解 Logging 代理程式一文。

其他工作

代理程式已預先設定,可監控特定的已知記錄位置。在 Linux 中,這些位置在套件 google-fluentd-catch-all-config 中說明,您可以使用安裝指令碼自動引用。在 Windows 中,根據預設,代理程式會監控 Windows 事件記錄。如果您想調整代理程式設定,請參閱設定 Logging 代理程式一文。

這部分說明如何執行一般維護工作:判斷代理程式版本、重新啟動代理程式、升級代理程式,及解除安裝代理程式。

判別版本

如要識別 Logging 代理程式的版本及其設定元件,請執行下列指令:

Linux 執行個體

在您的執行個體上執行下列指令:

# For Debian and Ubuntu systems:
dpkg-query --show --showformat \
    '${Package;-45} ${Version;-10} ${Architecture;-8} ${Status;-25}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

# For Amazon Linux, Red Hat, CentOS, and SUSE systems:
rpm --query --queryformat \
    '%-45{NAME} %-10{VERSION} %-10{RELEASE} %-8{ARCH}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

Windows 執行個體

執行下列指令。

reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

如果代理程式的版本低於 v1-5,前面的指令會傳回錯誤。請升級至最新代理程式

重新啟動代理程式

您必須重新啟動 Stackdriver Logging 代理程式,才能在設定檔中納入變更。如要重新啟動 Stackdriver Logging 代理程式,請使用下列操作說明。

Linux 執行個體

在您的執行個體上執行下列指令:

    $ sudo service google-fluentd restart

重新啟動 Logging 代理程式之後,您可能會想要傳送測試訊息

Windows 執行個體

需要管理員權限:如要重新啟動代理程式,請在 VM 執行個體上,於命令提示字元或 PowerShell 中執行下列指令:

# For Logging agent version v1-5 and later.
net stop  StackdriverLogging
net start StackdriverLogging

# For Logging agents before v1-5.
net stop  fluentdwinsvc
net start fluentdwinsvc

升級代理程式

如要將 Stackdriver Logging 代理程式升級至最新版本,請使用下列操作說明:

Linux 執行個體

如要升級至最新代理程式版本,請在您的執行個體上執行下列指令:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd

# For SUSE systems:
sudo zypper update google-fluentd

前面的指令不會變更代理程式的設定檔。如要取得最新預設設定與全部接收設定檔,請在您的執行個體上執行下列指令:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo zypper update google-fluentd google-fluentd-catch-all-config

您也可以移除目前的代理程式,然後安裝最新的代理程式。若執行升級可能會導致設定變更 (例如發生主要版本升級情況),此為建議做法。

Windows 執行個體

如要升級至最新代理程式版本,請依在 Windows 上安裝中所述安裝最新代理程式。系統會提示您解除安裝之前版本的代理程式。

解除安裝代理程式

如要移除 Stackdriver Logging 代理程式及其設定檔,請使用下列操作說明。

Linux 執行個體

解除安裝目前的 Linux 代理程式:

# For Debian and Ubuntu systems:
sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

# For Amazon Linux, Red Hat and CentOS systems:
sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Windows 執行個體

執行下列指令,解除安裝目前的代理程式:

[AGENT_INSTALLATION_DIRECTORY]\uninstall.exe

如果您執行版本 v1-5 及之後版本的 Logging 代理程式,請使用安裝代理程式時選擇的目錄。預設安裝目錄為:

C:\Program Files (x86)\Stackdriver\LoggingAgent\

如果您執行 v1-5 之前版本的 Logging 代理程式,安裝目錄為:

C:\GoogleStackdriverLoggingAgent\

詳情請參閱設定 Logging 代理程式

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

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

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