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

文档中心

立即注册

导航

手动为单个Windows实例安装Agent

最近更新时间：2024.05.29 10:16:55首次发布时间：2023.07.31 14:18:00

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

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

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

安装说明

前提条件

需要安装Agent的边缘实例需满足以下条件：

实例类型：虚拟机
节点类型：单线节点
操作系统及版本：Windows 10、Windows Server 2012、Windows Server 2016、Windows Server 2019

安装工具

需使用PowerShell脚本来执行检查、安装或卸载Agent的操作。

Agent版本

Agent的版本如下：

latest：最新版本
v1.0.0

安装Agent

通过公网安装Agent

说明

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

以Administrator用户登录需要安装Agent的边缘实例。
（可选）检查边缘实例的运行环境是否支持安装Agent。

$env:vecm_version = "latest"; iex "& { $(irm https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_windows.ps1) } check"

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

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

执行以下命令安装Agent：

$env:vecm_version = "latest"; iex "& { $(irm https://vecloud.tos-cn-beijing.volces.com/vecloud-monitor/vecloud_monitor_windows.ps1) } install"

如果系统返回“Install vecloud-monitor succeed!”消息，代表Agent安装成功。如果系统返回错误消息，您可查看 C:\Program Files\VECloud\Logs\vecloud-monitor.<时间戳>.log 中的日志来排查。

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

通过内网安装Agent

说明

如果边缘实例无法访问公网，您只能通过内网为其安装Agent。安装Agent前，您需要在边缘实例中执行如下命令检查是否存在100.100.100.96/27相关路由：

Get-NetRoute -DestinationPrefix 100.100.100.96/27

如果系统提示“Get-NetRoute：找不到任何DestinationPrefix属性等于100.64.0.0的MSFT_Net
Route”，那么您需要执行如下命令来手动配置该条路由：

## eth0代表边缘实例的默认内网网卡名称，请根据实际情况修改
New-NetRoute -DestinationPrefix "100.100.100.96/27" -InterfaceAlias "Ethernet0" -NextHop "0.0.0.0" -RouteMetric 1

以Administrator用户登录需要安装Agent的边缘实例。
（可选）检查边缘实例的运行环境是否支持安装Agent。

$env:vecm_version = "latest"; iex "& { $(irm 100.100.100.101/vecloud_monitor_windows.ps1) } check"

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

执行以下命令安装Agent：

$env:vecm_version = "latest"; iex "& { $(irm 100.100.100.101/vecloud_monitor_windows.ps1) } install"

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

Agent状态说明

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

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

注意事项

自定义镜像说明

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

内网路由说明

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

Agent资源占用说明

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

常见问题

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

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

Invoke-RestMethod：无法连接到远端服务器

边缘计算节点