Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

3 Scripts de alerta personalizados

Descripción general

Si no está satisfecho con los tipos de medios existentes para enviar alertas, hay una forma alternativa de hacerlo. Puede crear un script que manejará la notificación a su manera.

Los scripts de alerta se ejecutan en el servidor Zabbix. Estos scripts deben estar ubicados en el directorio especificado en el parámetro AlertScriptsPathdel archivo de configuración del servidor.

A continuación se muestra un ejemplo de un script de alerta personalizado:

#!/bin/bash
       
       to=$1
       subject=$2
       body=$3
       
       cat <<EOF | mail -s "$subject" "$to"
       $body
       EOF

A partir de la versión 3.4, Zabbix comprueba el código de salida de los comandos y scripts ejecutados. Cualquier código de salida que sea diferente de 0 se considera como un error de ejecución del comando. En tal caso Zabbix intentará repetir la ejecución fallida.

Las variables de entorno no se conservan ni se crean para el script, por lo que deben tratarse explícitamente.

Configuración

Para configurar scripts de alerta personalizados como tipo de medio:

  • Vaya a Administración → Tipos de medios
  • Haz clic en Crear tipo de medio

La pestaña Tipo de medio contiene atributos generales de tipo de medio:

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

Los siguientes parámetros son específicos para el tipo de medio de secuencia de comandos:

Parámetro Descripción
Nombre del script Ingrese el nombre del script.
Parámetros de la secuencia de comandos Agregue parámetros de línea de comandos a la secuencia de comandos.
Se admiten {ALERT.SENDTO}, {ALERT.SUBJECT} y {ALERT.MESSAGE} macros. en los parámetros del script.
La personalización de los parámetros del script es compatible desde Zabbix 3.0.

Ver [parámetros común de tipo de medio] (/manual/config/notifications/media#common_parameters) para detalles sobre cómo configurar los mensajes predeterminados y las opciones de procesamiento de alertas

::: nota de advertencia Incluso si un script de alerta no usa mensajes predeterminados, plantillas de mensajes para tipos de operaciones utilizadas por este tipo de medios aún debe definirse, de lo contrario no se enviará una notificación.

:::

Como el procesamiento paralelo de tipos de medios es implementado desde Zabbix 3.4.0, es importante tener en cuenta que con más de un tipo de medio de secuencia de comandos configurado, estas secuencias de comandos se pueden procesar en paralelo por procesos de alerta. El número total de procesos de alerta es limitado por el [parámetro] (/manual/appendix/config/zabbix_server) StartAlerters.

Medios de usuario

Una vez configurado el tipo de medio, vaya a Administración → Usuarios y edite el perfil de usuario para asignar medios de este tipo al usuario. Los pasos para configurar los medios de usuario, que son comunes para todos los tipos de medios, son descritos en la página [Tipos de medios] (/manual/config/notifications/media#user_media).

Tenga en cuenta que al definir un medio de usuario, el campo Enviar a no puede estar vacío. Si este campo no se usa en un script de alerta, ingrese cualquier combinación de caracteres admitidos para eludir los requisitos de validación.