3 Scripts

Descripción general

En la sección Alertas → Scripts se pueden configurar y mantener scripts globales definidos por el usuario.

Los scripts globales, según el alcance configurado y también los permisos del usuario, están disponibles para su ejecución:

• desde el menú de equipo en varias ubicaciones de la interfaz (Tablero, Problemas, Últimos datos, Mapas, etc.)
• desde el menú de eventos
• se puede ejecutar como una operación de acción

Los scripts se ejecutan únicamente en el agente Zabbix, el servidor Zabbix (proxy) o el servidor Zabbix. Consulte también Ejecución de comando.

Tanto el agente de Zabbix como los scripts remotos del proxy de Zabbix están deshabilitados de forma predeterminada. Pueden habilitarse mediante:

• Para comandos remotos ejecutados en el agente Zabbix:
  • agregar un parámetro AllowKey=system.run[<command>,*] para cada comando permitido en la configuración del agente, * representa el modo de espera y no espera;
• Para comandos remotos ejecutados en el proxy Zabbix:
  • Advertencia: no es necesario habilitar los comandos remotos en el proxy Zabbix si se ejecutan comandos remotos en el agente Zabbix que es monitoreado por el proxy Zabbix. Sin embargo, si es necesario ejecutar comandos remotos en el proxy Zabbix, establezca el parámetro EnableRemoteCommands en '1' en la configuración del proxy.

La ejecución de script global en el servidor Zabbix se puede deshabilitar estableciendo EnableGlobalScripts=0 en la configuración del servidor. Para instalaciones nuevas, desde Zabbix 7.0, la ejecución de script global en el servidor Zabbix está deshabilitada de forma predeterminada.

Se muestra una lista de scripts existentes con sus detalles.

Datos mostrados:

Para configurar un nuevo script, haga clic en el botón Crear script en la esquina superior derecha.

Opciones de edición masiva

Un botón debajo de la lista ofrece una opción de edición masiva:

• Eliminar - eliminar los scripts

Para usar esta opción, marque las casillas de verificación antes de los scripts respectivos y haga clic en Eliminar.

Usando el filtro

Puede utilizar el filtro para mostrar sólo los scripts que le interesan. Para un mejor rendimiento de la búsqueda, los datos se buscan con las macros sin resolver.

El enlace Filtro está disponible encima de la lista de scripts. Si hace clic en él, aparecerá un filtro disponible donde podrá filtrar scripts por nombre y alcance.

Configurar un script global

Atributos del guión:

Configuración avanzada

Las opciones de configuración avanzada están disponibles en una sección plegable Configuración avanzada:

|Parámetro|Descripción| |----------|-------------------------------------- --| |Habilitar entrada de usuario|Marque la casilla de verificación para habilitar la entrada manual del usuario antes de ejecutar el script.
La entrada manual del usuario reemplazará el valor de la macro {MANUALINPUT} en el script.
Consulte también: Entrada manual del usuario.| |Mensaje de entrada|Ingrese un texto personalizado que solicite la entrada personalizada del usuario. Este texto se mostrará encima del campo de entrada en la ventana emergente Entrada manual.
Para ver una vista previa de la ventana emergente Entrada manual, haga clic en Probar entrada del usuario. La vista previa también permite probar si la cadena de entrada cumple con la regla de validación de entrada (consulte los parámetros a continuación).
La compatibilidad con macros y macros de usuario depende del alcance del script (consulte Alcance en los parámetros generales de configuración del script).| |Tipo de entrada|Seleccione el tipo de entrada manual:
Cadena - cadena única;
Desplegable - el valor se selecciona entre múltiples opciones desplegables.| |Opciones desplegables|Ingrese valores únicos para el menú desplegable de entrada del usuario en una lista delimitada por comas.
Para incluir una opción vacía en el menú desplegable, agregue una coma adicional al principio, en el medio o al final de la lista.< br>Este campo se muestra sólo si se selecciona 'Desplegable' como Tipo de entrada.| |Cadena de entrada predeterminada|Ingrese la cadena predeterminada para la entrada del usuario (o ninguna).
Este campo se validará con la expresión regular proporcionada en el campo Regla de validación de entrada.
El valor ingresado aquí será se muestra de forma predeterminada en la ventana emergente Entrada manual.
Este campo se muestra solo si se selecciona 'Cadena' como Tipo de entrada.| |Regla de validación de entrada|Ingrese una expresión regular para validar la cadena de entrada del usuario.
Se admiten expresiones regulares globales.
Este campo se muestra solo si se selecciona 'Cadena' como Tipo de entrada.| |Habilitar confirmación|Marque la casilla de verificación para mostrar un mensaje de confirmación antes de ejecutar el script. Esta característica puede ser especialmente útil con operaciones potencialmente peligrosas (como un script de reinicio) o aquellas que pueden llevar mucho tiempo.| |Texto de confirmación|Ingrese un texto de confirmación personalizado para la ventana emergente de confirmación habilitada con la casilla de verificación anterior (por ejemplo, El sistema remoto se reiniciará. ¿Está seguro?). Para ver cómo se verá el texto, haga clic en Confirmación de prueba junto al campo.
Macros y [macros de usuario] personalizadas(/manual/config/macros/ user_macros) son compatibles.
Nota: las macros no se expandirán al probar el mensaje de confirmación.|

Si se configuran tanto la entrada manual del usuario como un mensaje de confirmación, se mostrarán en ventanas emergentes consecutivas.

Entrada manual del usuario

La entrada manual del usuario permite proporcionar un parámetro personalizado en cada ejecución del script. Esto ahorra la necesidad de crear múltiples scripts de usuario similares con una sola diferencia de parámetro.

Por ejemplo, es posible que desee proporcionar un número entero diferente o una dirección URL diferente al script durante la ejecución.

Para habilitar la entrada manual del usuario:

• utilizar la macro {MANUALINPUT} en el script (comandos, script, parámetro de script) cuando sea necesario; o en el campo URL de los scripts de URL;
• en la configuración de script avanzada, habilite la entrada manual del usuario y configure las opciones de entrada.

Con la entrada del usuario habilitada, antes de la ejecución del script, aparecerá una ventana emergente de Entrada manual al usuario solicitándole que proporcione un valor personalizado. El valor proporcionado reemplazará a {MANUALINPUT} en el script.

Dependiendo de la configuración, se le pedirá al usuario que ingrese un valor de cadena:

O seleccione el valor de un menú desplegable de opciones predeterminadas:

La entrada manual del usuario está disponible solo para secuencias de comandos cuyo alcance es "Acción manual del equipo" o "Acción manual del evento".

Ejecución del script y resultado

Los scripts ejecutados por el servidor Zabbix se ejecutan en el orden descrito en la página Ejecución de comandos (incluida la verificación del código de salida). El resultado del script se mostrará en una ventana emergente que aparecerá después de ejecutar el script.

El valor de retorno del script es una salida estándar junto con un error estándar.

El valor de retorno está limitado a 16 MB (incluidos los espacios en blanco finales truncados); También se aplican límites de la base de datos. Cuando los datos tienen que pasar a través del proxy Zabbix, deben almacenarse en la base de datos, sometiéndolos así a los mismos [límites de la base de datos] (/manual/config/items/item#text-data-limits).

Vea un ejemplo de un script y la ventana de resultados a continuación:

uname -v
       /tmp/non_existing_script.sh
       echo "Este script fue iniciado por {USER.USERNAME}"

El resultado del script no muestra el script en sí.

Tiempo de espera del script

Agente de Zabbix

Es posible que se produzca una situación en la que se agote el tiempo de espera al ejecutar un script.

Vea un ejemplo de un script que se ejecuta en el agente Zabbix y la ventana de resultados a continuación:

sleep 5
       df -h

El mensaje de error, en este caso, es el siguiente:

Tiempo de espera al ejecutar un script de shell.

Para evitar tales situaciones, se recomienda optimizar el script en sí (en el ejemplo anterior, "5") en lugar de ajustar el parámetro Timeout en la Configuración del agente Zabbix y Configuración del servidor Zabbix. Sin embargo, para el agente Zabbix en modo activo, el parámetro Timeout en configuración del servidor Zabbix debe ser al menos varios segundos más largo que el parámetro RefreshActiveChecks en configuración del agente Zabbix. Esto garantiza que el servidor tenga tiempo suficiente para recibir los resultados de la verificación activa del agente. Tenga en cuenta que la ejecución de scripts en un agente activo se admite desde el agente Zabbix 7.0.

En caso de que se haya cambiado el parámetro Timeout en la Configuración del agente Zabbix, aparecerá el siguiente mensaje de error:

Error al obtener valor del agente: se agotó el tiempo de espera de ZBX_TCP_READ().

Significa que la modificación se ha realizado en la configuración del agente Zabbix, pero es necesario modificar el parámetro Timeout en la configuración del servidor Zabbix también.

Servidor/proxy Zabbix

Vea un ejemplo de un script que se ejecuta en el servidor Zabbix y la ventana de resultados a continuación:

sleep 11
       df -h

También se recomienda optimizar el script en sí (en lugar de ajustar el parámetro TrapperTimeout al valor correspondiente (en nuestro caso, > ‘11’) modificando la configuración del servidor Zabbix).