安装Agent (Linux)

本文介绍如何为Linux边缘实例安装监控Agent。Agent是边缘监控提供的数据采集组件，用于采集边缘实例的操作系统监控数据。

安装说明

前提条件

• 需要安装Agent的边缘实例需满足以下条件：
  • CPU架构：x86
  • 节点类型：单线节点
• Linux内核版本需高于4.10.0
• 已完成以下基础命令的安装：
  • curl
  • wget
  • ip

Agent版本

Agent的版本如下：

• latest：最新版本
• v1.0.0

安装Agent

通过公网安装Agent

1. 以root用户登录需要安装Agent的边缘实例。

2. （可选）检查边缘实例的运行环境是否支持安装Agent。

   vecm_os=linux && export vecm_version=latest && curl -sfL https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_$vecm_os.sh | bash -s check
   

   如果系统返回“Check install vecloud-monitor finish!”消息，代表运行环境支持Agent的安装。如果系统返回警告消息，您可以选择忽略并继续安装Agent，但是可能出现采集数据不准确的问题。如果系统返回错误消息，则不可安装Agent。

   2023-06-28 14:37:51 >> Check install vecloud-monitor finish! <<
   

3. 执行以下命令安装Agent：

   vecm_os=linux && export vecm_version=latest && curl -sfL https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_$vecm_os.sh | bash -s install
   

   如果系统返回“Install vecloud-monitor succeed!”消息，代表Agent安装成功。如果系统返回错误消息，您可查看 /var/log/vecloud-monitor/vecloud_monitor.log 中的日志来排查。

   2023-06-28 14:37:51 >> Install vecloud-monitor succeed! <<
   

通过内网安装Agent

## eth0代表边缘实例的默认内网网卡名称，请根据实际情况修改
ip route add 100.100.100.0/24 dev eth0

1. 以root用户登录需要安装Agent的边缘实例。

2. （可选）检查边缘实例的运行环境是否支持安装Agent。

   vecm_os=linux && export vecm_version=latest && curl -sfL 100.100.100.101/vecloud_monitor_$vecm_os.sh | bash -s check
   

   如果系统返回“Check install vecloud-monitor finish!”消息，代表运行环境支持Agent的安装。如果系统返回警告消息，您可以选择忽略并继续安装Agent，但是可能出现采集数据不准确的问题。如果系统返回错误消息，则不可安装Agent。

   2023-06-28 14:37:51 >> Check install vecloud-monitor finish! <<
   

3. 执行以下命令安装Agent。

   vecm_os=linux && export vecm_version=latest && curl -sfL 100.100.100.101/vecloud_monitor_$vecm_os.sh | bash -s install
   

   如果系统返回“Install vecloud-monitor succeed!”消息，代表Agent安装成功。如果系统返回错误消息，您可查看 /var/log/vecloud-monitor/vecloud_monitor.log 中的日志来排查。

   2023-06-28 14:37:51 >> Install vecloud-monitor succeed! <<
   

Agent状态说明

为边缘实例安装了监控Agent后，您可以在边缘实例列表中查看Agent的状态。Agent的状态说明如下：

• 运行中：如果边缘实例已安装Agent且平台能正常收到Agent的心跳包，则Agent处于运行中状态。
• 未运行：如果边缘实例未安装Agent或因故障导致平台无法收到Agent的心跳包，则Agent处于未运行状态。

相关操作

如果您需要卸载Agent，请参照以下说明。
执行以下命令卸载通过公网安装的Agent：

vecm_os=linux && export vecm_version=latest && curl -sfL https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_$vecm_os.sh | bash -s uninstall

执行以下命令卸载通过内网安装的Agent：

vecm_os=linux && export vecm_version=latest && curl -sfL 100.100.100.101/vecloud_monitor_$vecm_os.sh | bash -s uninstall

注意事项

自定义镜像说明

通过自定义镜像创建的边缘实例需符合操作系统要求，否则可能无法正常采集监控数据。如果遇到相关问题，您可以提交工单咨询。

内网路由说明

通过公网安装Agent后，会自动在系统中添加以下路由。该条路由用于配置监控数据的出向链路。请勿删除该条路由，否则监控数据将无法正常展示。

100.100.100.0/24 dev eth0 scope link

该条路由中，eth0是一个示例值，代表边缘实例的内网网卡名称。

Agent资源占用说明

• 内存占用：Agent运行时占用的内存约为15MB。
• CPU占用：Agent运行时约占用单核的2%。
• 磁盘空间
  • Agent安装包大小约为15MB。
  • 日志文件/var/log/vecloud-monitor/最大占用100MB（系统默认保留最后2天日志）。

常见问题

1. 当前部分节点不支持Agent。在安装Agent的过程中，如果您遇到以下问题，请提交工单咨询：

   • 输入安装脚本后，系统长时间（大于30s）无响应。
   • 输入安装脚本后，系统返回如下错误消息：

   curl: (7) Failed to connect to 100.100.100.0 port 80: Connection timed out
   2023-06-27 20:34:44  ERROR >> The machine not support push metrics!
   

2. 如果您在创建边缘实例时将Agent安装脚本添加到自定义数据中，该脚本会在边缘实例启动时自动执行。为了使边缘实例能够正常启动，请您进行以下配置：

   • 在安装脚本的末尾添加 & 符号，使安装脚本在后台执行。
     另外，建议您在自定义脚本开始处增加一条sleep命令，使系统等待几秒再执行Agent安装命令。这样，能够尽可能确保Agent安装命令执行时的网络连通性，提高安装成功率。
     通过公网安装Agent的自定义数据示例如下：

   #!/bin/bash
   sleep 5
   vecm_os=linux && export vecm_version=latest && curl -sfL https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_$vecm_os.sh | bash -s install &