Puede ejecutar scripts personalizados en la máquina virtual de endpoint 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 virtual de endpoint. 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 junto a la máquina virtual de endpoint 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 al archivo de script en la máquina virtual del dispositivo. Ejemplo:
Para máquinas virtuales de endpoint Linux:
/opt/vmware/scripts/customscript.pyPara máquinas virtuales de endpoint Windows: c:\scripts\customscript.ps1 |
| Prefijo | Introduzca un prefijo si es necesario. Ejemplo: Para máquinas virtuales de endpoint Linux: python2.7, /bin/bash, o perl, etc. Para máquinas virtuales de endpoint 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 de endpoint. |
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 virtual de endpoint en la pestaña Todas las métricas. Las métricas de script se crean en un objeto llamado Script personalizado, que es un único objeto por máquina virtual de endpoint. Todas las métricas de los scripts de la máquina virtual de endpoint se colocan en 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.
