在個別 VM 中安裝 Cloud Logging 代理程式

Linux

1. 使用 SSH 或類似工具開啟連至 VM 執行個體的終端機連線，並確認您有 sudo 存取權。

2. 變更為您有寫入權限的目錄，例如主目錄。

3. 使用下列指令下載並執行代理程式安裝指令碼：

   curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
   sudo bash add-logging-agent-repo.sh --also-install
   

   安裝完成後，代理程式會自動啟動。

Windows

1. 使用遠端桌面協定或類似工具連線至執行個體，並登入 Windows。

2. 以滑鼠右鍵按一下 PowerShell 圖示，然後選取「以系統管理員身分執行」，開啟具有管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe", "${env:UserProfile}\StackdriverLogging-v1-22.exe")
   & "${env:UserProfile}\StackdriverLogging-v1-22.exe"
   

Linux

1. 使用 SSH 或類似工具開啟連至 VM 執行個體的終端機連線，並確認您有 sudo 存取權。

2. 變更為您有寫入權限的目錄，例如主目錄。

3. 下載代理程式安裝指令碼：

   curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
   

   執行 add-logging-agent-repo.sh 腳本時，您也可以設定下列標記：

   • --verbose：在指令碼執行期間啟用詳細記錄。
   • --also-install：新增代理程式套件存放區後，安裝代理程式。
   • --version：設定指令碼要安裝的代理程式版本。 如需版本資訊，請參閱「列出所有代理程式版本」。
   • --uninstall：解除安裝代理程式。
   • --remove-repo：在安裝或解除安裝代理程式後，移除對應的代理程式套件存放區。
   • --dry-run：只會觸發指令碼執行的試執行，並列印應執行的指令。

   詳情和使用範例請參閱指令碼註解。

4. 新增代理程式的套件存放區並安裝代理程式：

   1. 如要列出可用的代理程式版本，請參閱「列出所有代理程式版本」。

   2. 在實際工作環境中，您可能想固定使用主要版本，避免安裝可能包含回溯不相容變更的主要版本。如要固定在主要版本，請執行：

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      舉例來說，如要將代理程式固定在 1.x.x 版，請執行：

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=1.*.*
      

   3. 如要安裝特定版本的代理程式，請執行下列指令：

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

5. 重新啟動代理程式服務

   您必須重新啟動，上述一應俱全的套件安裝的設定才會生效。

   sudo service google-fluentd restart
   

安裝指令碼成功執行後，即可加以刪除。

• 如要確認代理程式運作狀況符合預期，請執行下列指令：

  sudo service google-fluentd status
  

  代理程式的狀態應為「確定」。

• 您也可以檢查記錄，確保沒有錯誤：

  tail /var/log/google-fluentd/google-fluentd.log
  

如果您無法順利安裝，請參閱疑難排解頁面。

Windows

1. 使用遠端桌面協定或類似工具連線至執行個體，並登入 Windows。

2. 以滑鼠右鍵按一下 PowerShell 圖示，然後選取「以系統管理員身分執行」，開啟具有管理員權限的 PowerShell 終端機。

   1. 執行下列 PowerShell 指令：

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe", "${env:UserProfile}\StackdriverLogging-v1-22.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-22.exe"
      

   您也可以瀏覽至下列網址來下載並執行代理程式的安裝程式：

   https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-22.exe

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

   & "${env:UserProfile}\StackdriverLogging-v1-22.exe" /S
   

   在「無訊息」模式中，使用 /D 選項指定安裝目錄，例如：

   & "${env:UserProfile}\StackdriverLogging-v1-22.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
   

   安裝程式成功完成作業後，即可加以刪除。

   如果您無法順利安裝，請參閱疑難排解頁面。

Linux

1. 編輯下列設定檔 (如果檔案不存在，請建立)：

    /etc/default/google-fluentd
   

2. 在檔案中新增下列內容：

    export http_proxy="http://proxy-ip:proxy-port"
    export https_proxy="http://proxy-ip:proxy-port"
    export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
   

3. 在 VM 執行個體上執行下列指令，重新啟動代理程式：

    sudo service google-fluentd restart
   

Windows

1. 如果您使用 HTTP Proxy，請從管理員命令提示字元執行下列指令。這會設定 http_proxy 和 https_proxy 環境變數，讓代理程式可以使用傳出 HTTPS 傳送資料：

   setx http_proxy http://proxy-ip:proxy-port /m
   setx https_proxy http://proxy-ip:proxy-port /m
   setx no_proxy 169.254.169.254 /m
   

DEBIAN / UBUNTU

在 Debian 或 Ubuntu 上執行下列指令：

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

SLES / SUSE

在 SUSE 上執行下列指令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-fluentd google-fluentd-catch-all-config google-fluentd-catch-all-config-structured

Windows

1. 使用遠端桌面協定或類似工具連線至執行個體，並登入 Windows。

2. 以滑鼠右鍵按一下 PowerShell 圖示，然後選取「以系統管理員身分執行」，開啟具有管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

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

Linux

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

     sudo service google-fluentd restart

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

Windows

1. 使用遠端桌面協定或類似工具連線至執行個體，並登入 Windows。

2. 以滑鼠右鍵按一下 PowerShell 圖示，然後選取「以系統管理員身分執行」，開啟具有管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

Restart-Service -Name StackdriverLogging

Linux

如要將代理程式升級至最新版本，請執行下列指令：

sudo bash add-logging-agent-repo.sh --also-install

如要將代理程式升級至特定主要版本的最新點發行版本，請執行下列指令：

sudo bash add-logging-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

如要升級至最新代理程式版本，請依照本頁面的「在 Windows 上安裝」相關說明安裝最新代理程式。安裝程式會提示您解除安裝代理程式的先前版本。

CENTOS / RHEL

列出可用的代理程式版本：

sudo yum list --showduplicates google-fluentd

DEBIAN / UBUNTU

列出可用的代理程式版本：

sudo apt-cache madison google-fluentd

SLES / SUSE

列出可用的代理程式版本：

sudo zypper search -s google-fluentd

Windows

不支援在 Windows 上安裝舊版代理程式。

Linux

執行下列指令：

sudo bash add-logging-agent-repo.sh --uninstall

(選用) 如要移除存放區並解除安裝代理程式，請在先前的指令中附加 --remove-repo。

Windows

在 Windows 控制台中，選擇 [Uninstall a program] (解除安裝程式)。您應會在可以解除安裝的程式清單中看到 Logging 代理程式。您也可以從安裝 Logging 代理程式的目錄執行 uninstall.exe。