在個別 VM 中安裝作業套件代理程式

Linux

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

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

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

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

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

Windows

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

2. 在 PowerShell 圖示上按一下滑鼠右鍵，然後選取「Run as Administrator」，即可開啟具有系統管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
   

Linux

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

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

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

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

   執行 add-google-cloud-ops-agent-repo.sh 指令碼時，您也可以設定下列標記：

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

   如需更多資訊和使用範例，請參閱指令碼的註解。

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

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

   2. 如為實際工作環境，建議您固定使用主要版本，以免安裝可能包含回溯不相容性變更的主要版本。如要將檔案固定在主要版本，請執行：

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      例如，如要將代理程釘選至 1.x.x，請執行以下命令：

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      

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

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

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

• 如要確認代理程式是否正常運作，請執行以下指令：

  sudo systemctl status google-cloud-ops-agent"*"
  

  確認「Logging Agent」和「Metrics Agent」元件是否正在執行。

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

Windows

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

2. 在 PowerShell 圖示上按一下滑鼠右鍵，然後選取「Run as Administrator」，即可開啟具有系統管理員權限的 PowerShell 終端機。

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

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   

   執行 add-google-cloud-ops-agent-repo.ps1 指令碼時，您也可以設定下列標記：

   • -Verbose：在指令碼執行期間開啟詳細記錄。
   • -AlsoInstall：在新增代理程式套件存放區後安裝代理程式。
   • -Version：設定要安裝的指令碼的代理程式版本。如需版本資訊，請參閱「列出所有代理程式版本」。
   • -Uninstall：解除安裝代理程式。
   • -RemoveRepo：在安裝或解除安裝代理程式後，移除對應的代理程式套件存放區。
   • -WhatIf：只會觸發指令碼執行的模擬執行作業，並列印出應執行的指令。
   • -UninstallStandaloneLoggingAgent：解除安裝舊版記錄代理程式 (StackdriverLogging)。
   • -UninstallStandaloneMonitoringAgent：解除安裝舊版監控代理程式 (StackdriverMonitoring)。

   如需更多資訊和使用範例，請參閱指令碼的註解。

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

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

   2. 如為實際工作環境，建議您固定使用主要版本，以免安裝可能包含回溯不相容性變更的主要版本。如要將檔案固定在主要版本，請執行：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

      例如，如要將代理程式釘選至 1.x.x，請執行以下指令：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      

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

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      例如：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

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

• 如要確認代理程式是否正常運作，請執行以下指令：

  Get-Service google-cloud-ops-agent
  

  代理人的狀態應為 Running。

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

Cloud Monitoring

前往 Google Cloud 控制台的「VM Instances」(VM 執行個體) 資訊主頁：

前往「VM Instances」(VM 執行個體) 資訊主頁

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

資訊主頁「Inventory」分頁的「List」檢視畫面會列出所有 VM，並包含代理程式的狀態欄，如以下螢幕截圖所示：

「Agent」欄會回報以下值：

• 未偵測到：您尚未安裝代理程式，或代理程式未執行。如果您不確定是否已安裝代理程式，可以查詢已安裝的版本。如果您已安裝代理程式，可以重新啟動代理程式。如果您已安裝並啟動 Ops Agent，但狀態仍為「未偵測到」，表示代理程式可能未正確啟動，或無法傳送指標。

  如要排解啟動問題，請參閱「代理程式已安裝但未執行」一文。如要排解指標攝入問題，請參閱「排解資料攝入問題」。一般代理程式診斷指令碼和健康狀態檢查也可能有所幫助。

• 作業套件代理程式：您正在執行作業套件代理程式。如果項目旁邊沒有綠色勾號，則表示有可用的代理程式升級，這取決於 VM 偵測到的作業系統。

  將滑鼠游標懸停在表格中的作業套件代理程式指標上，即可查看作業套件代理程式版本的相關資訊。如果您執行的是舊版，系統也會建議您升級代理程式。

• 待處理：正在安裝或升級作業套件代理程式。

  如果代理程式安裝狀態仍為「待處理」超過 10 分鐘，表示套用作業套件代理程式 OS 政策或啟動代理程式時可能發生問題。如需疑難排解資訊，請參閱 自動安裝政策的代理程式診斷工具。

• 無法安裝代理程式：無法安裝作業套件代理程式。如需疑難排解資訊，請參閱「代理程式無法安裝」。

• 未收集遙測資料：Ops Agent 安裝成功，但代理程式尚未傳送遙測資料。

  新代理程式通常需要約 10 分鐘，才能開始傳送遙測資料。您可以重新整理頁面來更新狀態。如果這個狀態持續超過 10 分鐘，可能代表擷取遙測資料時發生問題。詳情請參閱「代理程式已安裝，但未執行」。

• 舊版代理程式：您正在執行舊版 Monitoring 或 Logging 代理程式。如要瞭解如何轉換至作業套件代理程式，請參閱「從舊版代理程式遷移至作業套件代理程式」。

• 不適用：這個 VM 不是支援執行代理程式的平台。

• VM 已停止：VM 未執行，因此無法得知代理程式狀態。

如要安裝作業套件代理程式，請按照下列步驟操作：

• 選取要安裝代理程式的 VM 執行個體。
• 在「Instances」表格中，按一下「Install/Update Ops Agent」選項。

您也可以針對特定 VM 在「VM Details」頁面中安裝或更新作業套件代理程式。

盡可能使用作業套件代理程式 OS 政策安裝代理程式。詳情請參閱「 管理受 Ops Agent OS 政策涵蓋的 VM」。並非所有作業系統的所有版本都支援 Ops Agent OS 政策。在這種情況下，點選「Install/Update Ops Agent」即可取得一系列可在 Cloud Shell 中執行的指令。

作業套件代理程式預設會同時收集指標和記錄檔。您可以 設定作業套件代理程式來變更這項預設行為。

Compute Engine

1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面：

   前往「VM instances」(VM 執行個體) 頁面

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。

2. 按一下要安裝代理程式的 VM 名稱。

3. 點選「Observability」分頁標籤。

4. 按一下「安裝作業套件代理程式」。

   盡可能使用作業套件代理程式 OS 政策安裝代理程式。詳情請參閱「 管理受 Ops Agent OS 政策涵蓋的 VM」。並非所有作業系統的所有版本都支援 Ops Agent OS 政策。在這種情況下，點選「Install/Update Ops Agent」即可取得一系列可在 Cloud Shell 中執行的指令。

   作業套件代理程式預設會同時收集指標和記錄檔。您可以 設定作業套件代理程式來變更這項預設行為。

   如果代理程式安裝狀態仍為「待處理」超過 10 分鐘，表示套用作業套件代理程式 OS 政策或啟動代理程式時可能發生問題。如需疑難排解資訊，請參閱 自動安裝政策的代理程式診斷工具。

Linux

1. 編輯下列設定檔 (如果尚未建立檔案，請先建立檔案)：

    /etc/systemd/system.conf
   

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

    DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
   

3. 重新載入環境變數：

    sudo systemctl daemon-reload
   

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

    sudo systemctl restart google-cloud-ops-agent"*"
   

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 "metadata.google.internal,169.254.169.254" /m
   

Google Cloud 控制台

如要查看 VM 上的作業套件代理程式版本，請按照下列步驟操作：

• 在「監控」頁面的「Instances」表格中，找出 VM 的項目。如需導覽資訊，請參閱「使用 Google Cloud 控制台安裝代理程式」。

• 將滑鼠游標懸停在表格項目中的「Ops Agent」指標上。

CENTOS / RHEL

在 Red Hat 或 CentOS Linux 上執行下列指令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN / UBUNTU

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

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES / SUSE

在 SUSE 上執行下列指令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

Windows

在 Windows 上執行下列指令：

googet installed google-cloud-ops-agent

Linux

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

     sudo systemctl restart google-cloud-ops-agent

Windows

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

2. 在 PowerShell 圖示上按一下滑鼠右鍵，然後選取「Run as Administrator」，即可開啟具有系統管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

Restart-Service google-cloud-ops-agent -Force

Google Cloud 控制台

您可以按照 Cloud Monitoring 安裝說明升級 Ops Agent。詳情請參閱「使用Google Cloud 控制台安裝代理程式」。

Linux

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

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

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

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

如要升級至最新的代理程式版本，請按照下列步驟操作：

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

2. 在 PowerShell 圖示上按一下滑鼠右鍵，然後選取「Run as Administrator」，即可開啟具有系統管理員權限的 PowerShell 終端機。

   Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
   

3. 執行下列 PowerShell 指令，移除已安裝的代理程式，並執行安裝指令：

   googet -noconfirm remove google-cloud-ops-agent
   googet -noconfirm install google-cloud-ops-agent
   

CENTOS / RHEL

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

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN / UBUNTU

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

sudo apt-cache madison google-cloud-ops-agent

SLES / SUSE

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

sudo zypper search -s google-cloud-ops-agent

Windows

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

googet available google-cloud-ops-agent

Linux

執行下列指令：

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

如要除瞭解除安裝代理程式之外，還要移除存放區，請在前一個指令後方附加 --remove-repo。

Windows

如要解除安裝作業套件代理程式，請按照下列步驟操作：

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

2. 在 PowerShell 圖示上按一下滑鼠右鍵，然後選取「Run as Administrator」，即可開啟具有系統管理員權限的 PowerShell 終端機。

3. 執行下列 PowerShell 指令：

   googet -noconfirm remove google-cloud-ops-agent