全部產品
Search
文件中心

Cloud Monitor:如何處理在阿里雲主機上自動安裝CloudMonitor外掛程式失敗問題?

更新時間:Jul 08, 2026

如果您在阿里雲主機上自動安裝CloudMonitor外掛程式失敗,請按照以下方法逐步排查。

操作步驟

  1. 以root使用者登入CloudMonitor外掛程式所在的阿里雲主機。

    重要

    CloudMonitor僅支援通過管理員帳號root操作CloudMonitor外掛程式。使用管理員帳號具有一定風險,如果操作不當可能導致系統穩定性問題或資料安全問題,請謹慎操作。

  2. 執行以下命令,檢查是否能擷取到阿里雲主機的地區ID。

    curl http://100.100.100.200/latest/meta-data/region-id
  3. 執行以下命令,檢查阿里雲主機與Object Storage Service之前的網路是否正常。

    ping cms-agent-${region-id}.oss-${region-id}.aliyuncs.com
    說明

    {region-id}是阿里雲主機的地區ID,例如:{region-id}cn-hangzhou,命令為ping cms-agent-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com

    • 是:網路正常,但外掛程式仍未成功安裝。請繼續執行步驟 4,查看安裝日誌定位具體失敗原因;若日誌排查後仍無法解決,請給CloudMonitor提交工單

    • 否:網路異常,可能是Object Storage Service的網路問題。請給Object Storage Service提交工單

  4. 登入CloudMonitor外掛程式所在伺服器,查看安裝日誌,定位具體失敗原因。

    根據作業系統查看對應位置的記錄檔:

    • Linux 系統:查看 /var/log 目錄下的CloudMonitor安裝記錄檔,從中擷取具體報錯資訊。

    • Windows 系統:查看CloudMonitor外掛程式安裝目錄下的記錄檔,或開啟事件檢視器eventvwr.msc),在應用程式日誌中查看相關錯誤記錄。

    若步驟 3 的 ping 命令檢測網路連通正常,但控制台自動安裝仍失敗,可嘗試手動執行安裝命令進行驗證:

    Linux 系統(以 root 使用者執行以下命令):

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

    <region-id> 替換為主機所在地區的 ID(例如 cn-hangzhou)。安裝成功後,需等待一段時間讓監控資料收集生效。

    Windows 系統:請參考下方「Windows 系統專屬排查」中的對應情境進行手動安裝處理。

Windows 系統專屬排查

若 ECS 執行個體作業系統為 Windows,且完成上述步驟排查後外掛程式仍安裝失敗,請根據具體失敗情境參考以下處理方法。

情境一:檔案佔用導致手動安裝失敗

若安裝過程中提示 C 盤已有檔案無法刪除或替換,請按以下步驟處理:

  1. 以管理員身份開啟命令提示字元,執行以下命令,嘗試直接啟動CloudMonitor外掛程式服務:

    net start argusagent
  2. 若服務成功啟動,則無需重新安裝,等待監控資料上報正常即可。

  3. 若仍無法啟動,請檢查是否有其他進程佔用了相關檔案,關閉佔用進程後重新嘗試安裝。若問題仍存在,請重啟伺服器後再次嘗試。

情境二:註冊表 SN 緩衝導致安裝失敗

若CloudMonitor外掛程式曾在該伺服器上安裝過,註冊表中殘留的 serial_number 緩衝可能導致重新安裝失敗。請按以下步驟清理後重新安裝:

  1. Win+R,輸入 regedit 後按斷行符號,開啟登錄編輯程式

  2. 導航至以下註冊表路徑:

    HKEY_LOCAL_MACHINE\SOFTWARE\cloudmonitor
  3. 找到 serial_number 索引值,按右鍵,選擇刪除

  4. 關閉登錄編輯程式,然後重新安裝CloudMonitor外掛程式。

情境三:雲助手異常或 Administrator 密碼錯誤導致控制台安裝指令無法下發

若在控制台單擊安裝後無任何響應,或安裝狀態長時間無變化,可能是雲助手服務異常或 ECS 執行個體 Administrator 帳號密碼錯誤所致。請按以下步驟排查:

  1. Win+R,輸入 services.msc 後按斷行符號,開啟服務管理介面,確認 Aliyun Assist Service 處於正在運行狀態。若服務未運行,請按右鍵該服務並選擇啟動,然後在控制台重新觸發安裝。

  2. 確認 ECS 執行個體的 Administrator 帳號密碼設定正確。雲助手通過該帳號下發並執行安裝指令,密碼錯誤將導致指令執行失敗。如需重設密碼,請登入 ECS 控制台操作,重設後在控制台重新觸發安裝。