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 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 la ejecución de comandos.

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.

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:

Advanced configuration

Advanced configuration options are available in a collapsible Advanced configuration section:

If both manual user input and a confirmation message are configured, they will be displayed in consecutive popup windows.

Manual user input

Manual user input allows to supply a custom parameter on each execution of the script. This saves the necessity to create multiple similar user scripts with only a single parameter difference.

For example, you may want to supply a different integer or a different URL address to the script during execution.

To enable manual user input:

• use the {MANUALINPUT} macro in the script (commands, script, script parameter) where required; or in the URL field of URL scripts;
• in advanced script configuration, enable manual user input and configure input options.

With user input enabled, before script execution, a Manual input popup will appear to the user asking to supply a custom value. The supplied value will replace {MANUALINPUT} in the script.

Depending on the configuration, the user will be asked to enter a string value:

Or select the value from a dropdown of pre-determined options:

Manual user input is available only for scripts where the scope is 'Manual host action' or 'Manual event action'.

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 durante la ejecución de un script de shell.

Para evitar este tipo de situaciones, se recomienda optimizar el script en lugar de ajustar el parámetro de tiempo de espera a un valor correspondiente (en el ejemplo anterior, > '5') en la Configuración del agente Zabbix y en la Configuración del servidor Zabbix.

En caso de que el parámetro Tiempo de espera se cambie 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 se ha realizado una modificación en la configuración del agente Zabbix pero también es necesario modificar la configuración del tiempo de espera en la Configuración del servidor Zabbix.

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).