安装Agent (Windows)

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

安装说明

前提条件

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

• CPU架构：x86
• 操作系统及版本：Windows 10、Windows 2012、Windows 2016、Windows 2019
• 节点类型：单线节点

安装工具

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

Agent版本

Agent的版本如下：

• latest：最新版本
• v1.0.0

安装Agent

通过公网安装Agent

1. 以Administrator用户登录需要安装Agent的边缘实例。
2. （可选）检查边缘实例的运行环境是否支持安装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! <<

3. 执行以下命令安装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

Get-NetRoute -DestinationPrefix 100.64.0.0/10 

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

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

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

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

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

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

$env:vecm_version = "latest"; iex "& { $(irm 100.100.100.101/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的状态。Agent的状态说明如下：

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

相关操作

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

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

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

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

注意事项

自定义镜像说明

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

内网路由说明

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

Agent资源占用说明

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

常见问题

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

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

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