Puede ejecutar scripts personalizados en la máquina de destino y recopilar datos personalizados que, posteriormente, se pueden consumir como una métrica.
Requisitos previos
- Todos los scripts que se ejecuten con el script personalizado deben generar un valor entero único. Si la salida no es un valor entero único, se muestra un error en la interfaz de usuario.
- El script personalizado utiliza el complemento exec de Telegraf para ejecutar scripts en el sistema operativo de una máquina de destino. En los sistemas operativos Linux, se crea un usuario especial llamado arcuser con privilegios específicos para instalar el agente de Telegraf. Como resultado, el complemento exec ejecuta los scripts con ese usuario arcuser. Asegúrese de que el arcuser pueda ejecutar los scripts que utilizan el script personalizado (el arcuser debe tener permisos para ejecutar el script). Por ejemplo, el arcuser creado automáticamente por el proxy de nube no tiene privilegios para ejecutar scripts que se almacenan en el directorio /root.
- En sistemas operativos Windows se utiliza un usuario del sistema para instalar el agente de Telegraf. Como resultado, el complemento exec ejecuta los scripts con ese usuario de sistema. Asegúrese de que el usuario del sistema tenga privilegios y pueda ejecutar el script personalizado.
- El script debe colocarse en la carpeta /opt/vmware.
- Se debe establecer la variable de entorno PATH para que los scripts de PowerShell se ejecuten en el sistema operativo Windows si el usuario utilizó el prefijo powershell -File. Por ejemplo, "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\" en la variable de entorno PATH.
Cómo ejecutar scripts personalizados
- En la pestaña Administrar agentes de Telegraf, filtre por .
- Expanda la flecha desplegable en la máquina virtual en la que está instalado el agente. Verá la sección Supervisión personalizada.
- En la opción Script personalizado, haga clic en los puntos suspensivos verticales y, a continuación, haga clic en Agregar.
- En el cuadro de diálogo Gestionar servicio personalizado, puede agregar y configurar los servicios de Windows que se supervisarán.
Configuración de instancia
| Opción | Descripción |
|---|---|
| Estado | Active la ejecución del script personalizado. |
| Nombre para mostrar | Añada un nombre adecuado para el script. * es un carácter no válido y no debe utilizarse en el nombre. |
| Ruta de archivos | Introduzca la ruta de acceso al archivo de script en la máquina de destino. Ejemplo:
Para máquinas Linux:
/opt/vmware/scripts/customscript.pyPara máquinas Windows: c:\scripts\customscript.ps1 |
| Prefijo | Introduzca un prefijo si es necesario. Ejemplo: Para máquinas Linux: python2.7, /bin/bash o perl, etc. Para máquinas Windows: powershell -File |
| Argumentos | Enumere los argumentos en el script. |
| Tiempo de espera | Introduzca un tiempo de espera de ejecución de script en la máquina virtual. |
Después de guardar el script, aparece en Script personalizado. Para editar o eliminar scripts, haga clic en las opciones Editar o Eliminar de los puntos suspensivos verticales del script personalizado que agregó. Después de agregar y guardar los scripts, haga clic en la flecha desplegable de Script personalizado para ver la lista de scripts y su estado.
- El script personalizado debe generar todos los errores con el formato ERROR|<Error_message> para que la propagación de errores funcione. Si el script no genera un error con el formato especificado, VMware Aria Operations muestra el mensaje de error Unable to parse the error message. Please check the endpoint en la interfaz de usuario. Esto se debe al diseño, hasta que el proxy de nube propague el mensaje de error exacto.
- El script bash debe comenzar con
shebang (#!/bin/bash).
Pestaña Todas las métricas
Cuando los datos se recopilan correctamente, puede ver el script como una métrica para la máquina de destino en la pestaña Todas las métricas. Las métricas de script se crean bajo un objeto llamado Script personalizado, que es un único objeto por máquina de destino. Todas las métricas de los scripts de la máquina de destino se colocan bajo ese objeto Script personalizado que contiene todos los scripts personalizados que ha creado. Puede ver la salida de la métrica específica. El nombre de la métrica de la carpeta Scripts es el nombre para mostrar que el usuario especifica al crear la configuración del script. Por ejemplo, si establece el nombre para mostrar como Script de Python, se crea una métrica con el nombre Script de Python si los datos se recopilan correctamente.
