在個別 VM 中安裝 Monitoring 代理程式

Linux

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

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

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

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

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

Windows

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

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

3. 執行下列 PowerShell 指令：

   (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
   

Linux

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

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

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

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

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

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

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

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

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

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

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

      例如，如要將服務綁定至代理程式 6.x.x，請執行以下指令：

      sudo bash add-monitoring-agent-repo.sh --also-install \
        --version=6.*.*
      

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

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

5. 啟動代理服務

   sudo service stackdriver-agent start
   

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

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

  sudo service stackdriver-agent status
  

  代理人的狀態應為「OK」。

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

  sudo grep collectd /var/log/{syslog,messages} | tail
  

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

Windows

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

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

   1. 執行下列 PowerShell 指令：

      (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
      & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
      

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

   https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

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

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
   

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

   & "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
   

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

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

Linux

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

   • 針對代理程式 6.0.0 以上版本，請編輯：

     /etc/default/stackdriver-agent
     

   • 如果是 6.0.0 以下的代理程式版本，請依據您的作業系統編輯適當的檔案：

     針對 Debian 和 Ubuntu，請編輯：

     /etc/default/stackdriver-agent
     

     針對 CentOS 和 SLES，請編輯：

     /etc/default/stackdriver-collectd
     

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 stackdriver-agent 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
   

AMAZON LINUX AMI / CENTOS / RHEL

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

DEBIAN / UBUNTU

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

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

SLES / SUSE

在 SUSE 上執行下列指令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

Windows

目前無法判斷在 Windows 上執行的 Monitoring 代理程式版本。

Linux

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

     sudo service stackdriver-agent restart

Windows

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

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

3. 執行下列 PowerShell 指令：

Restart-Service -Name StackdriverMonitoring

Linux

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

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

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

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

Windows

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum list --showduplicates stackdriver-agent

DEBIAN / UBUNTU

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

sudo apt-cache madison stackdriver-agent

SLES / SUSE

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

sudo zypper search -s stackdriver-agent

Windows

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

Linux

執行下列指令：

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

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

Windows

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