手动为单个Linux实例安装Agent--边缘计算节点-火山引擎

文档中心

立即注册

导航

手动为单个Linux实例安装Agent

最近更新时间：2024.05.29 10:16:55首次发布时间：2023.05.29 10:21:04

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

本文描述的方法适用于以下场景：

已有的某个Linux边缘实例未安装Agent。您需要在不重启该实例的情况下为其安装Agent。

安装说明

前提条件

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

Agent版本

Agent的版本如下：

latest：最新版本
v1.0.0

安装Agent

通过公网安装Agent

说明

边缘实例需要能够访问公网。

以root用户登录需要安装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 check
```
如果系统返回“Check install vecloud-monitor finish!”消息，代表运行环境支持Agent的安装。如果系统返回警告消息，您可以选择忽略并继续安装Agent，但是可能出现采集数据不准确的问题。如果系统返回错误消息，则不可安装Agent。
```
2023-06-28 14:37:51 >> Check install vecloud-monitor finish! <<
```
执行以下命令安装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

说明

如果边缘实例无法访问公网，您只能通过内网为其安装Agent。安装Agent前，您需要手动在边缘实例中添加一条路由：

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

以root用户登录需要安装Agent的边缘实例。
（可选）检查边缘实例的运行环境是否支持安装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! <<
```
执行以下命令安装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后，会自动在系统中添加以下路由。该条路由用于配置监控数据的出向链路。请勿删除该条路由，否则监控数据将无法正常展示。

100.100.100.96/27 dev eth0 scope link

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

Agent资源占用说明

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

常见问题

当前部分节点不支持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!
```
如果您在创建边缘实例时将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 &
```

边缘计算节点