Cloud Monitor：安裝和卸載CloudMonitor外掛程式

安裝須知

• 安裝CloudMonitor外掛程式通常不會影響業務運行，無需重啟 ECS 執行個體，外掛程式會自動啟動並採集資料。如有顧慮，建議在業務低峰期操作。

• 通過控制台自動安裝時，系統使用雲助手 Agent 以 root 身份執行，不會改變 root 帳號的登入狀態（如 noLogin 配置）。即使 root 帳號配置了禁止登入，仍可通過雲助手 Agent 完成自動安裝。

• CloudMonitor外掛程式（argusagent）與Log Service採集外掛程式（loongcollector）相互獨立，不存在依賴關係，可分別安裝和卸載。

• 基礎監控（CPU、網路流量等）由宿主機直接採集，無需安裝外掛程式；記憶體、磁碟使用率等作業系統級監控指標需依賴外掛程式採集。Simple Application Server等非 ECS 主機如需在控制台查看記憶體、磁碟等作業系統級監控指標，必須安裝CloudMonitor外掛程式。

外掛程式版本

推薦使用C++3.X版本。

Java/Go語言版本的外掛程式已停止維護，並且C++版本外掛程式的資源佔用明顯低於Go和Java版本，因此建議使用C++版本外掛程式安裝。

新舊版本的 Agent 使用不同的控制指令碼路徑，請根據已安裝的版本使用正確的命令：

• 費用說明：安裝CloudMonitor外掛程式、查看主機監控圖表、為監控指標設定警示規則均為免費。

• 系統要求

  作業系統	硬體架構
  Windows 7、Windows Server 2008 R2及以上版本	i386、AMD64
  Linux 2.6.23及以上版本（必須包括Glibc庫）	i386、AMD64、ARM64

  CloudMonitor外掛程式相容所有滿足以下條件的 Linux 發行版：核心版本為 2.6.23 及以上，且系統包含 Glibc 庫。常見相容發行版包括（但不限於）CentOS、Ubuntu、Debian、Alibaba Cloud Linux、Anolis OS、Rocky Linux、AlmaLinux、麒麟 OS 等。

  基礎監控（CPU、網路流量等）由宿主機直接採集，無需安裝外掛程式，不區分作業系統發行版。記憶體、磁碟使用率等作業系統級監控指標需安裝CloudMonitor外掛程式後採集。

  更多資訊：關於C++外掛程式支援的安裝路徑、資源消耗和日誌等詳細資料，請參見CloudMonitor外掛程式概覽。

主機網路要求

• 主機需要具備訪問公網的能力，或已配置NAT Gateway、Proxy 伺服器。

• 防火牆白名單配置

  如果主機配置了防火牆或ECS安全性群組，需將CloudMonitor的伺服器位址和連接埠加入白名單。

  說明

  非阿里雲主機通過公網上報資料和心跳檢測，統一使用443連接埠。

  CloudMonitor伺服器位址	查詢擷取IP地址方式	CloudMonitor伺服器連接埠	說明
  心跳服務	nslookup cms-cloudmonitor.aliyun.com或 ping cms-cloudmonitor.aliyun.com	8080, 3128，443	用於外掛程式心跳檢測
  資料上報	VPC網路：nslookup metrichub-<regionid>.aliyun.com 公網：nslookup metrichub-cms-<regionid>.aliyuncs.com	80, 443	用於上報監控資料 <regionid>是阿里雲主機的地區ID，可通過命令擷取：curl http://100.100.100.200/latest/meta-data/region-id。 公網資料上報地址目前僅支援cn-hangzhou、cn-shanghai、cn-beijing和cn-shenzhen地區。
  中繼資料服務	固定位址區段：100.100.0.0/16	0-65535	擷取執行個體資訊（僅阿里雲主機）

DNS 解析損毀修復

執行 nslookup cms-cloudmonitor.aliyun.com 或 ping cms-cloudmonitor.aliyun.com 時，如果返回 Name or service not known 或 no servers could be reached 等解析失敗資訊，說明主機 DNS 無法解析CloudMonitor心跳服務網域名稱，導致外掛程式離線、無法採集資料。請按以下步驟修複：

1. 編輯 /etc/resolv.conf，添加阿里雲內網 DNS 伺服器：

   nameserver 100.100.2.136
   nameserver 100.100.2.138

2. 重啟CloudMonitor外掛程式：

   cd /usr/local/cloudmonitor && ./cloudmonitorCtl.sh restart

3. 驗證外掛程式進程：

   ps aux | grep argusagent

   正常顯示 2~3 個進程（daemon、wrapper、main process）。

4. 再次測試 DNS 解析：

   nslookup cms-cloudmonitor.aliyun.com

   能解析出 IP 位址，說明 DNS 已恢複，外掛程式可正常上報資料。

CloudMonitor外掛程式安裝方式對比

您可以根據主控件類型和網路環境，選擇自動或手動方式安裝外掛程式。

1. 進入主機監控。

2. 在主機監控頁面，選中待安裝或升級外掛程式的主機，單擊左下角的大量安裝或升級外掛程式。單擊確定。

   說明

   • 對於新購阿里雲主機，您可以開啟右上方的新購ECS自動安裝Cloud Monitor開關。開啟開關後，您新購買的ECS主機將自動安裝CloudMonitor外掛程式，否則需要手動安裝。

   • 安裝或升級外掛程式大約需要5分鐘。當目標主機的Agent状态由安裝中變為運行中時，表示安裝或升級成功。

以 root 使用者登入Simple Application Server執行個體後，執行以下命令安裝CloudMonitor外掛程式：

ARGUS_VERSION=4.0.0 /bin/bash -c "$(curl -s https://cms-agent-cn-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/Argus/agent_install-2.0.3.sh)"

請將命令中的 cn-shenzhen 替換為執行個體所在的地區 ID；ARGUS_VERSION 用於指定待安裝的外掛程式版本。安裝完成後，執行 ps aux | grep argusagent 確認外掛程式進程已運行。

安裝成功後，Simple Application Server的監控資料不會顯示在主機監控中，請在CloudMonitor控制台依次選擇雲產品監控 > 計算 > Simple Application Server查看（對應 Namespace acs_swas）。

1. 進入主機監控。

2. 在主機監控頁面，請單擊主機列表上方主機與外掛程式操作，在彈出的下拉式功能表裡單擊手動安裝。

3. 在彈出的手動安裝對話方塊中，根據需求參考以下步驟完成安裝。

啟用外掛程式

• Linux

  執行以下命令，啟動CloudMonitor外掛程式。

  bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start

• Windows

  執行以下命令，啟動CloudMonitor外掛程式。

  net start argusagent

查看外掛程式狀態

• Linux

  執行以下命令，查看CloudMonitor外掛程式狀態。

  ps aux | grep argusagent | grep -v grep

  顯示如下資訊，說明CloudMonitor外掛程式狀態正常。

  root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
  root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

• Windows

  1. 開啟服務頁面。可以通過鍵盤快速鍵Win+R開啟运行對話方塊，輸入命令services.msc，單擊確定。

  2. 查看服務argusagent service的狀態。

     當服務狀態為正在運行時，外掛程式狀態正常。

停用外掛程式

• Linux

  執行以下命令，停止CloudMonitor外掛程式。

  bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop

• Windows

  執行以下命令，停止CloudMonitor外掛程式。

  net stop argusagent

卸載外掛程式

卸載CloudMonitorC++版本外掛程式後，您不能通過CloudMonitor控制台即時監控該主機，但是可以查看其歷史監控資料。

• Linux

  # 1.執行以下命令，停止CloudMonitor外掛程式。
  bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
  # 2.執行以下命令，卸載CloudMonitor外掛程式。
  bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall
  # 3/執行以下命令，刪除目錄cloudmonitor。
  rm -rf /usr/local/cloudmonitor

  當 cloudmonitorCtl.sh 指令碼不存在時，按以下步驟卸載：

  1. 尋找外掛程式目錄：

     find / -name cloudmonitor -type d

  2. 停止服務：

     systemctl stop cloudmonitor

  3. 禁用服務：

     systemctl disable cloudmonitor

  4. 終止殘留進程：

     kill -9 $(pgrep argusagent)

     說明

     argusagent 服務配置了 KillMode=none，systemctl stop 不會終止進程。進程存活時會重建 /usr/local/cloudmonitor 目錄，因此必須先終止進程，再刪除目錄。

  5. 刪除外掛程式目錄：

     rm -rf /usr/local/cloudmonitor

  6. 刪除服務檔案：

     rm -f /etc/systemd/system/cloudmonitor.service

  7. 重載 systemd 配置：

     systemctl daemon-reload

  8. 清理配置目錄：

     rm -rf /etc/cloudmonitor

  卸載完成後，執行以下命令驗證卸載是否徹底：

  • systemctl status cloudmonitor 返回 not-found。

  • ls /usr/local/cloudmonitor 提示 No such file or directory。

  • ps aux | grep argusagent 無進程。

  • find / -name cloudmonitor -type d 無結果。

• Windows

  # 1.執行以下命令，停止CloudMonitor外掛程式。
  net stop argusagent
  # 2.執行命令，卸載CloudMonitor外掛程式。
  "C:\Program Files\Alibaba\cloudmonitor\bin\argusagent_service.exe" uninstall
  # 3.執行以下命令，刪除目錄cloudmonitor。
  cd C:\Program Files\Alibaba
  rd /s /q cloudmonitor

  說明

  當安裝路徑包含空格（如預設路徑 C:\Program Files\Alibaba\cloudmonitor）時，必須使用英文雙引號將可執行檔的完整路徑包裹，否則系統會提示"不是內部或外部命令"錯誤。若修改了預設安裝路徑，請將上述命令中的路徑替換為實際安裝路徑。

  若卸載命令執行失敗，請檢查：

  • 目前使用者是否具備 Administrator 許可權（以 Administrator 身份登入，或右鍵以管理員身份運行命令提示字元）。

  • 檔案路徑是否正確（可通過檔案總管確認 argusagent_service.exe 的實際位置）。

控制台安裝或啟動外掛程式多次無效

在控制台多次單擊大量安裝或升級外掛程式或啟動後，外掛程式狀態仍未更新，請登入伺服器執行以下命令啟動雲助手服務，再通過控制台重試：

systemctl start aliyun-service

Simple Application Server安裝外掛程式失敗

以 root 使用者登入伺服器，按以下步驟逐項排查：

1. 檢查中繼資料服務連通性：

   curl http://100.100.100.200/latest/meta-data/region-id

   若無正常返回（如地區 ID 字串），說明中繼資料服務不可達，請檢查網路設定。

2. 測試外掛程式下載地址連通性：

   ping cms-agent-<region>.oss-<region>.aliyuncs.com

   將 <region> 替換為實際地區 ID（如 cn-hangzhou）。若無法連通，請檢查安全性群組規則和防火牆配置。

3. 檢查外掛程式進程是否存在：

   ps -ef | grep cms

   若進程異常，嘗試停止後重啟外掛程式。

4. 若以上均正常但安裝仍失敗，建議改用手動安裝方式。

外掛程式狀態顯示"重裝/升級"或安裝失敗

檢查雲助手 Agent（aliyun-service）服務是否正常運行：

• Linux：執行 systemctl status aliyun-service，確認服務處於 active（running）狀態。

• Windows：在服務管理器中查看 Aliyun Service 是否正常運行。

若雲助手服務異常，請先修複雲助手服務後重試安裝。必要時可卸載現有外掛程式後重新手動安裝。

接入失敗或資料上報異常

1. 卸載外掛程式後重新安裝。

2. 如問題持續，可指定特定版本（如 1.0.6）進行測試安裝。