AI 助理
文档备案控制台
官方文档
首页

安装和卸载云监控插件

更新时间：
复制 MD 格式
产品详情
我的收藏

云监控插件用于采集主机操作系统的监控指标数据，并将数据上传至云监控进行统计分析。可以通过可视化图表查看主机状态，并为关键指标设置报警规则，以便及时发现和处理问题。本文详细介绍如何为主机安装、管理和卸载云监控插件。

重要

云监控仅支持通过管理员账号权限（Linux操作系统使用root用户，Windows操作系统使用Administrator用户）操作云监控插件。使用管理员账号具有一定风险，如果操作不当可能导致系统稳定性问题或数据安全问题，请谨慎操作。

安装前须知

安装须知

  • 安装云监控插件通常不会影响业务运行，无需重启 ECS 实例，插件会自动启动并采集数据。如有顾虑，建议在业务低峰期操作。

  • 通过控制台自动安装时，系统使用云助手 Agent 以 root 身份执行，不会改变 root 账号的登录状态（如 noLogin 配置）。即使 root 账号配置了禁止登录，仍可通过云助手 Agent 完成自动安装。

  • 云监控插件（argusagent）与日志服务采集插件（loongcollector）相互独立，不存在依赖关系，可分别安装和卸载。

  • 基础监控（CPU、网络流量等）由宿主机直接采集，无需安装插件；内存、磁盘使用率等操作系统级监控指标需依赖插件采集。轻量应用服务器等非 ECS 主机如需在控制台查看内存、磁盘等操作系统级监控指标，必须安装云监控插件。

插件版本

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

Java/Go语言版本的插件已停止维护，并且C++版本插件的资源占用明显低于Go和Java版本，因此建议使用C++版本插件安装。

新旧版本的 Agent 使用不同的控制脚本路径，请根据已安装的版本使用正确的命令：

版本

控制脚本路径

说明

旧版（Java/Go）

/usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh

已停止维护，/wrapper/ 目录仅旧版存在

新版（C++）

/usr/local/cloudmonitor/cloudmonitorCtl.sh

推荐使用，C++ 版本无 /wrapper/ 目录
说明

C++ 版本安装后不存在 /usr/local/cloudmonitor/wrapper/ 目录。如果执行旧版路径的命令时提示目录不存在，说明当前安装的是 C++ 版本，请改用 cloudmonitorCtl.sh 进行操作。

  • 费用说明：安装云监控插件、查看主机监控图表、为监控指标设置报警规则均为免费。

  • 系统要求

    操作系统

    硬件架构

    Windows 7、Windows Server 2008 R2及以上版本

    i386、AMD64

    Linux 2.6.23及以上版本（必须包括Glibc库）

    i386、AMD64、ARM64

    更多信息：关于C++插件支持的安装路径、资源消耗和日志等详细信息，请参见云监控插件概览。

主机网络要求

  • 主机需要具备访问公网的能力，或已配置NAT网关、代理服务器。

  • 防火墙白名单配置

    如果主机配置了防火墙或ECS安全组，需将云监控的服务器地址和端口加入白名单。

    说明

    非阿里云主机通过公网上报数据和心跳检测，统一使用443端口。

    云监控服务器地址

    查询获取IP地址方式

    云监控服务器端口

    说明

    心跳服务

    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

    获取实例信息（仅阿里云主机）

云监控插件安装方式对比

您可以根据主机类型和网络环境，选择自动或手动方式安装插件。

安装方式

适用场景

优点

控制台自动安装

阿里云ECS实例、已通过云助手托管的非阿里云主机。

推荐。操作简单，支持批量操作，无需登录主机。

手动安装

无法使用自动安装的场景、未托管的非阿里云主机、内网或离线环境、需要通过自动化脚本（如Ansible）部署的场景。

灵活性高，适用于所有复杂环境。

自动安装（推荐）

此方式适用于阿里云主机和阿里云托管实例。

  1. 进入主机监控。

  2. 在主机监控页面，选中待安装或升级插件的主机，单击左下角的批量安装或升级插件。单击确定。

    说明

    • 对于新购阿里云主机，您可以打开右上角的新购ECS自动安装云监控开关。打开开关后，您新购买的ECS主机将自动安装云监控插件，否则需要手动安装。

    • 安装或升级插件大约需要5分钟。当目标主机的Agent状态由安装中变为运行中时，表示安装或升级成功。

手动安装

说明

如果自动安装失败，或需要在特殊环境下安装，请使用手动安装。若主机上已存在旧版本或损坏的插件，必须先执行卸载操作，再重新安装。

  1. 进入主机监控。

  2. 在主机监控页面，请单击主机列表上方主机与插件操作，在弹出的下拉菜单里单击手动安装。

  3. 在弹出的手动安装对话框中，根据需求参考以下步骤完成安装。

阿里云主机

Linux

  1. 请选择Region：选择阿里云主机所在地域。

  2. 在安装命令区域，单击命令正后方的image.png图标，复制命令。选择操作系统为Linux或Windows，在安装命令区域获取对应的安装命令。

  3. 以root用户登录待安装云监控插件的主机。

  4. 粘贴并执行云监控插件安装命令。

  5. 执行以下命令，查看云监控插件状态。

    ps aux | grep argusagent | grep -v grep

    显示如下信息，说明云监控插件状态正常。

    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. 请选择Region：选择阿里云主机所在地域。

  2. 根据主机的操作系统版本，下载32位或64位插件包。

  3. 以Administrator用户登录待安装云监控插件的主机。

  4. 创建目录C:\Program Files\Alibaba\cloudmonitor。上传插件包到主机，并解压到目录C:\Program Files\Alibaba\cloudmonitor。

  5. 打开命令提示符页面。通过键盘快捷键Win+R打开运行对话框，输入命令cmd，单击确定。

  6. 执行以下命令，安装云监控插件。

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. 执行命令net start argusagent，启动云监控插件。

  8. 查看云监控插件状态。

    1. 打开服务页面。可以通过键盘快捷键Win+R打开运行对话框，输入命令services.msc，单击确定。

    2. 查看服务argusagent service的状态。当服务状态为正在运行时，插件状态正常。

非阿里云主机

Linux

  1. 请选择Region：选择一个地域用于接收监控数据。

  2. 在安装命令区域，单击命令正后方的image.png图标，复制命令。在手动安装对话框中，选择主机类型为非阿里云主机，操作系统为Linux，机器能否链接公网选择能（系统提示"可以链接公网，无需安装网络代理"）。系统生成安装命令，使用 root 角色执行，命令内容包含设置 CMS_AGENT_ACCESSKEY 和 CMS_AGENT_SECRETKEY 环境变量，并通过 curl 下载执行安装脚本。注意：非阿里云主机必须关闭 Agent 才能删除。单击确定。

  3. 以root用户登录待安装云监控插件的主机。

  4. 粘贴并执行云监控插件安装命令。

  5. 执行以下命令，查看云监控插件状态。

    ps aux | grep argusagent | grep -v grep

    显示如下信息，说明云监控插件状态正常。

    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. 请选择Region：选择一个地域用于接收监控数据。

  2. 根据主机的操作系统版本，下载32位或64位插件包。下载配置文件accesskey.properties。

  3. 以Administrator用户登录待安装云监控插件的主机。

  4. 创建目录C:\Program Files\Alibaba\cloudmonitor。上传插件包到主机，并解压到目录C:\Program Files\Alibaba\cloudmonitor。

  5. 上传配置文件到主机，并将其放置到目录C:\Program Files\Alibaba\cloudmonitor\local_data\conf。

  6. 执行以下命令，安装云监控插件。

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. 执行命令net start argusagent，启动云监控插件。

  8. 查看云监控插件状态。

    1. 打开服务页面。可以通过键盘快捷键Win+R打开运行对话框，输入命令services.msc，单击确定。

    2. 查看服务argusagent service的状态。当服务状态为正在运行时，插件状态正常

常见问题

已安装云监控插件的非阿里云主机若无法访问公网，则插件无法将监控数据上报至云监控服务端。为解决此问题，需要在插件中配置代理服务器以转发数据。具体操作是修改相应操作系统的配置文件 agent.properties。

  • Linux 路径：/usr/local/cloudmonitor/local_data/conf/agent.properties

  • Windows 路径：C:\Program Files\Alibaba\cloudmonitor\local_data\conf\agent.properties

有关配置代理服务器的详细步骤，请参见非阿里云主机如何通过Nginx代理服务器上报监控数据？。

从旧版Agent迁移

如果主机上安装的是旧版 Java 或 Go 版本的 Agent（特征：存在 /usr/local/cloudmonitor/wrapper/ 目录），建议迁移至 C++ 版本，以获得更低的资源占用和持续的功能更新。

迁移步骤（Linux）：

  1. 停止旧版 Agent：

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh stop

  2. 卸载旧版 Agent 并清理安装目录：

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh remove
rm -rf /usr/local/cloudmonitor

  3. 按照手动安装章节的步骤重新安装 C++ 版本插件。

  4. 启动 C++ 版本 Agent：

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

  5. 验证 Agent 运行状态：

    ps aux | grep argusagent | grep -v grep

    显示如下信息，说明 Agent 状态正常：

    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

常用操作

启用插件

  • Linux

    执行以下命令，启动云监控插件。

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

  • Windows

    执行以下命令，启动云监控插件。

    net start argusagent

查看插件状态

  • Linux

    执行以下命令，查看云监控插件状态。

    ps aux | grep argusagent | grep -v grep

    显示如下信息，说明云监控插件状态正常。

    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

    执行以下命令，停止云监控插件。

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

  • Windows

    执行以下命令，停止云监控插件。

    net stop argusagent

卸载插件

卸载云监控C++版本插件后，您不能通过云监控控制台实时监控该主机，但是可以查看其历史监控数据。

  • Linux

    # 1.执行以下命令，停止云监控插件。
bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
# 2.执行以下命令，卸载云监控插件。
bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall
# 3/执行以下命令，删除目录cloudmonitor。
rm -rf /usr/local/cloudmonitor

  • Windows

    # 1.执行以下命令，停止云监控插件。
net stop argusagent
# 2.执行命令，卸载云监控插件。
"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

轻量应用服务器安装插件失败

以 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）进行测试安装。

常见问题

Q：为什么安装了云监控插件但部分监控数据（如内存、磁盘使用率）不显示或缺失？

A：请参考以下步骤排查：

  1. 等待数据同步：数据采集和上报存在短暂延迟，建议等待几分钟后刷新主机监控页面再次查看。

  2. 确认插件运行状态：在主机监控页面查看插件状态列。若状态为已停止，请单击启动，或登录服务器执行 systemctl start aliyun-service 启动云助手服务后再重试。

  3. 区分监控类型：CPU、网络流量等基础监控无需安装插件即可采集；内存、磁盘使用率等操作系统级指标必须依赖插件采集，若插件未安装或状态异常则无数据显示。

  4. 告警触发检查：若设置了磁盘或内存告警规则但未收到通知，请确认插件是否正常运行并成功采集数据。插件正常运行后，告警即可正常触发。

相关文档

常见问题

API
上一篇：云监控插件下一篇：版本说明