You need to enable JavaScript to run this app.
导航
手动为单个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

说明

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

  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! <<
  1. 执行以下命令安装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
  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! <<
  1. 执行以下命令安装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约15分钟后,Agent状态会转变为未运行

注意事项

自定义镜像说明

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

内网路由说明

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

Agent资源占用说明

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

常见问题

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

  • 输入安装脚本后,系统长时间(大于30s)无响应。
  • 输入安装脚本后,系统返回如下错误消息:
Invoke-RestMethod:无法连接到远端服务器