您可以在端点虚拟机中运行自定义脚本并收集自定义数据,然后将这些数据当作衡量指标来使用。
必备条件
- 使用自定义脚本运行的所有脚本都必须输出单个整数值。如果输出的不是单个整数值,用户界面中将显示错误。
- 自定义脚本使用 Telegraf 的 exec 插件在端点虚拟机操作系统上运行脚本。在 Linux 操作系统中,将创建一个名为 arcuser 且具有特定特权的特殊用户用于安装 Telegraf 代理。因此,exec 插件将使用该 arcuser 用户运行脚本。请确保 arcuser 可运行使用自定义脚本的脚本(arcuser 必须具有运行该脚本的权限)。例如,由云代理自动创建的 arcuser 无权运行存储在 /root 目录下的脚本。
- 在Windows操作系统中,系统用户用于安装 Telegraf 代理。因此,exec 插件将使用该系统用户运行脚本。确保系统用户具有 特权并可以运行自定义脚本。
- 脚本必须存放在 /opt/vmware 文件夹中。
- 如果用户使用 powershell -File 前缀,则必须设置环境变量 PATH,才能在 Windows 操作系统上执行 PowerShell 脚本。例如,环境变量 PATH 中的 "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\"。
如何运行自定义脚本
- 从管理 Telegraf 代理选项卡中,按 进行筛选。
- 展开安装了代理的端点虚拟机对应的下拉箭头。将显示自定义监控部分。
- 单击自定义脚本选项旁边的垂直省略号,然后单击添加。
- 在管理自定义服务对话框中,可以添加和配置要监控的 Windows 服务。
实例设置
选项 | 描述 |
---|---|
状态 | 激活自定义脚本执行。 |
显示名称 | 为脚本添加适当名称。* 是一个无效字符,不得在名称中使用。 |
文件路径 | 输入指向端点虚拟机上脚本文件的路径。 例如:
对于 Linux 端点虚拟机:
/opt/vmware/scripts/customscript.py对于 Windows 端点虚拟机: c:\scripts\customscript.ps1 |
前缀 | 如有必要,请输入前缀。 例如: 对于 Linux 端点虚拟机:python2.7、/bin/bash 或 perl 等 对于 Windows 端点虚拟机:powershell -File |
Args | 列出脚本中的参数。 |
超时 | 输入在端点虚拟机上执行脚本的超时限制。 |
保存脚本后,该脚本将显示在自定义脚本下。可以通过单击已添加的自定义脚本旁边的垂直省略号并选择编辑或删除选项来编辑或删除脚本。添加并保存脚本后,单击自定义脚本旁边的下拉箭头可查看脚本列表及其状态。
注:
- 自定义脚本必须以 ERROR|<Error_message> 的格式引发所有错误,以使错误传播生效。如果脚本未以给定格式引发错误,VMware Aria Operations 将在用户界面中显示错误消息 Unable to parse the error message. Please check the endpoint。这是设计使然,直到云代理传播确切的错误消息才会解决此错误。
- Bash 脚本必须以
shebang (#!/bin/bash)
开头。
所有衡量指标选项卡
成功收集数据后,可以在所有衡量指标选项卡中,作为端点虚拟机的衡量指标查看脚本。脚本衡量指标在名为 Custom Script 的对象下创建,每个端点虚拟机会有一个这样的对象。端点虚拟机脚本中的所有衡量指标都放在 Custom Script 对象下,该对象包含已创建的所有自定义脚本。您可以查看特定衡量指标的输出。Scripts 文件夹下的衡量指标名称是用户在创建脚本配置时指定的显示名称。例如,如果将显示名称设置为 Python 脚本,如果成功收集到数据,则会使用名称 Python 脚本创建衡量指标。