Documentation
Table of Contents
1 Tipos de medios
Descripción general
Los medios son los canales de entrega utilizados para enviar notificaciones y alertas de Zabbix.
Puede configurar varios tipos de medios:
Los tipos de medios se configuran en Alertas → Tipos de medios.
Algunos tipos de medios vienen predefinidos en el conjunto de datos predeterminado. Solo necesitas para ajustar sus parámetros para que funcionen.
Tipos de medios automatizados de Gmail/Office365
Los usuarios de Gmail u Office365 pueden beneficiarse de una configuración de tipos de medios más sencilla. El campo Proveedor de correo electrónico en la configuración del tipo de medio de correo permite seleccionar Opciones preconfiguradas para Gmail y Office 365.
Al seleccionar las opciones relacionadas con Gmail/Office365, solo es necesario proporcionar la dirección de correo electrónico/contraseña del remitente para crear un tipo de medio que funcione.
Tan pronto como se proporcione la dirección de correo electrónico/contraseña, Zabbix podrá completar automáticamente todas las configuraciones requeridas para los tipos de medios de Gmail/Office365 con los valores reales/recomendados, es decir, servidor SMTP, puerto del servidor SMTP, helo SMTP. y Seguridad de la conexión. Debido a esta automatización, estos campos ni siquiera se muestran; sin embargo, es posible ver el servidor SMTP y los detalles del correo electrónico en la lista de tipos de medios (consulte la columna Detalles).
Tenga en cuenta también que:
- La contraseña no es necesaria para las opciones de retransmisión.
- Para la retransmisión de Office365, el nombre de dominio de la dirección de correo electrónico proporcionada se utilizará para llenar dinámicamente el servidor SMTP (es decir, reemplace "example.com" en
example-com.mail.protection.outlook.comcon el valor real) .
Para probar si un tipo de medio configurado funciona, haga clic en el enlace Probar en la última columna (consulte la prueba de tipo de medio para Correo electrónico, Webhook, o Script para más detalles).
Para crear un nuevo tipo de medio, haga clic en el botón Crear tipo de medio. Se abre un formulario de configuración de tipo de medio.
Configuring media type
Media types are configured in Alerts → Media types.
Some media types come pre-defined in the default dataset. You just need to finetune their parameters to get them working.
To test if a configured media type works, click on the Test link in the last column (see media type testing for Email, Webhook, or Script for more details).
To create a new media type, click on the Create media type button. A media type configuration form is opened.
Parámetros comunes
Algunos parámetros son comunes para todos los tipos de medios.
En la pestaña Tipo de medio, los atributos generales comunes son:
| Parámetro | Descripción |
|---|---|
| Nombre | Nombre del tipo de medio. |
| Tipo | Seleccione el tipo de medio. |
| Descripción | Ingrese una descripción. |
| Habilitado | Marque la casilla de verificación para habilitar el tipo de medio. |
Consulte las páginas individuales de tipos de medios para conocer los parámetros específicos de los medios.
La pestaña Plantillas de mensajes permite configurar la notificación predeterminada mensajes para todos o algunos de los siguientes tipos de eventos:
- Problema
- Recuperación de problemas
- Actualización de problemas
- Servicio
- Recuperación del servicio
- Actualización del servicio
- Descubrimiento
- Autorregistro
- Problema interno
- Recuperación de problemas internos.
Para personalizar plantillas de mensajes:
- En la pestaña Plantillas de mensajes haga clic en
: un Mensaje Se abrirá la ventana emergente de plantilla. - Seleccione el Tipo de mensaje requerido y edite Asunto y Mensaje textos.
- Haga clic en Agregar para guardar la plantilla de mensaje.
Parámetros de la plantilla de mensaje:
| Parámetro | Descripción |
|---|---|
| Tipo de mensaje | Tipo de evento para el cual se debe usar el mensaje predeterminado. Solo se puede definir un mensaje predeterminado para cada tipo de evento. |
| Asunto | Asunto del mensaje predeterminado. El tema puede contener macros. Está limitado a 255 caracteres. El asunto no está disponible para el tipo de medio SMS. |
| Mensaje | El mensaje predeterminado. Está limitado a una cierta cantidad de caracteres según el tipo de base de datos (consulte Envío de mensajes para obtener más información). El mensaje puede contener [macros] compatibles (/manual/appendix/macros/supported_by_location). En los mensajes de problema y de actualización de problema, se admiten macros de expresión (por ejemplo, {?avg(/host/key,1h)}). |
Para realizar cambios en una plantilla de mensaje existente: en la columna Acciones haga clic en 
para editar la plantilla o haga clic en 
para eliminar el plantilla de mensaje.
Es posible definir una plantilla de mensaje personalizada para una acción específica. (ver acción operaciones para detalles). Los mensajes personalizados definidos en la configuración de la acción anular la plantilla de mensaje de tipo de medio predeterminado.
::: nota de advertencia Definir plantillas de mensajes es obligatorio para todos tipos de medios, incluidos webhooks o scripts de alerta personalizados que no utilizan Mensajes predeterminados para notificaciones. Por ejemplo, una acción "Enviar mensaje to Pushover webhook" no enviará notificaciones de problemas, si el El mensaje de problema para el webhook Pushover no está definido. :::
La pestaña Opciones contiene configuraciones de procesamiento de alertas. El mismo conjunto de Las opciones son configurables para cada tipo de medio.
Todos los tipos de medios se procesan en paralelo. Si bien el número máximo de Las sesiones simultáneas se pueden configurar por tipo de medio, el número total de Los procesos de alerta en el servidor solo pueden estar limitados por StartAlerters parámetro. Alertas generadas por un disparador se procesan secuencialmente. Por lo tanto, es posible que se envíen varias notificaciones. procesados simultáneamente sólo si son generados por múltiples desencadenantes.
| Parámetro | Descripción |
|---|---|
| Sesiones simultáneas | Seleccione el número de sesiones de alerta paralelas para el tipo de medio: Uno - una sesión Ilimitado - número ilimitado de sesiones Personalizado - seleccione un número personalizado de sesiones Los valores ilimitados/altos significan más sesiones paralelas y una mayor capacidad para enviar notificaciones. Se deben usar valores ilimitados/altos en entornos grandes donde es posible que sea necesario enviar muchas notificaciones simultáneamente. Si es necesario enviar más notificaciones que sesiones simultáneas, las notificaciones restantes se pondrán en cola; no se perderán. |
| Intentos | Número de intentos para intentar enviar una notificación. Se pueden especificar hasta 100 intentos; el valor predeterminado es '3'. Si se especifica '1', Zabbix enviará la notificación solo una vez y no volverá a intentarlo si falla el envío. |
| Intervalo de intento | Frecuencia de intento de reenviar una notificación en caso de que el envío falle, en segundos (0-3600). Si se especifica '0', Zabbix lo volverá a intentar inmediatamente. Se admiten sufijos de tiempo, por ejemplo, 5 s, 3 m, 1 h. |
Message templates
The Message templates tab allows to set default notification messages for all or some of the following event types:
- Problem
- Problem recovery
- Problem update
- Service
- Service recovery
- Service update
- Discovery
- Autoregistration
- Internal problem
- Internal problem recovery
To customize message templates:
- In the Message templates tab click on : a Message template popup window will open.
- Select required Message type and edit Subject and Message texts.
- Click on Add to save the message template.
Message template parameters:
| Parameter | Description |
|---|---|
| Message type | Type of an event for which the default message should be used. Only one default message can be defined for each event type. |
| Subject | Subject of the default message. The subject may contain macros. It is limited to 255 characters. Subject is not available for SMS media type. |
| Message | The default message. It is limited to certain amount of characters depending on the database type (see Sending messages for more information). The message may contain supported macros. In problem and problem update messages, expression macros are supported (for example, {?avg(/host/key,1h)}). |
To make changes to an existing message template: in the Actions column click on to edit the template or click on to delete the message template.
It is possible to define a custom message template for a specific action (see action operations for details). Custom messages defined in the action configuration will override default media type message template.
Defining message templates is mandatory for all media types, including webhooks or custom alert scripts that do not use default messages for notifications. For example, an action "Send message to Pushover webhook" will fail to send problem notifications, if the Problem message for the Pushover webhook is not defined.
Options
The Options tab contains alert processing settings. The same set of options is configurable for each media type.
All media types are processed in parallel. While the maximum number of concurrent sessions is configurable per media type, the total number of alerter processes on the server can only be limited by the StartAlerters parameter. Alerts generated by one trigger are processed sequentially. So multiple notifications may be processed simultaneously only if they are generated by multiple triggers.
| Parameter | Description |
|---|---|
| Concurrent sessions | Select the number of parallel alerter sessions for the media type: One - one session Unlimited - unlimited number of sessions Custom - select a custom number of sessions Unlimited/high values mean more parallel sessions and increased capacity for sending notifications. Unlimited/high values should be used in large environments where lots of notifications may need to be sent simultaneously. If more notifications need to be sent than there are concurrent sessions, the remaining notifications will be queued; they will not be lost. |
| Attempts | Number of attempts for trying to send a notification. Up to 100 attempts can be specified; the default value is '3'. If '1' is specified, Zabbix will send the notification only once and will not retry if the sending fails. |
| Attempt interval | Frequency of trying to resend a notification in case the sending failed, in seconds (0-3600). If '0' is specified, Zabbix will retry immediately. Time suffixes are supported, e.g., 5s, 3m, 1h. |
Medios de usuario
Para recibir notificaciones de un tipo de medio, un medio (dirección de correo electrónico/teléfono número/ID de usuario de webhook, etc.) para este tipo de medio debe definirse en el perfil del usuario. Por ejemplo, una acción que envía mensajes al usuario "Admin" El uso del webhook "X" siempre no enviará nada si el webhook "X" El medio no está definido en el perfil de usuario.
Para definir los medios de usuario:
- Vaya a su perfil de usuario, o vaya a Usuarios → Usuarios y abra el formulario de propiedades del usuario.
- En la pestaña Medios, haga clic en .
Atributos de medios de usuario:
| Parámetro | Descripción |
|---|---|
| Tipo | La lista desplegable contiene los nombres de los tipos de medios habilitados. Tenga en cuenta que al editar un medio de un tipo de medio deshabilitado, el tipo se mostrará en rojo. |
| Enviar a | Proporcione la información de contacto requerida a dónde enviar mensajes. Para un tipo de medio de correo electrónico, es posible agregar varias direcciones haciendo clic en  debajo del campo de dirección. En este caso, la notificación se enviará a todas las direcciones de correo electrónico proporcionadas. También es posible especificar el nombre del destinatario en el campo Enviar a del destinatario del correo electrónico en el formato 'Nombre del destinatario <direcció[email protected]>'. Tenga en cuenta que si se proporciona el nombre de un destinatario, la dirección de correo electrónico debe estar entre corchetes angulares (<>). Se admiten caracteres UTF-8 en el nombre, pero no los pares entrecomillados ni los comentarios. Por ejemplo: John Abercroft <[email protected]> y [email protected] son ambos formatos válidos. Ejemplos incorrectos: John Doe [email protected], %%"Zabbix\@\<H(comment)Q\>" [email protected] %%. |
| Cuando está activo | Puede limitar el tiempo en que se envían los mensajes, por ejemplo, configurar solo los días hábiles (1-5,09:00-18:00). Tenga en cuenta que este límite se basa en la [zona horaria] del usuario (/manual/web_interface/time_zone). Si la zona horaria del usuario cambia y es diferente de la zona horaria del sistema, es posible que sea necesario ajustar este límite en consecuencia para no perder mensajes importantes. Consulte la página Especificación del período de tiempo para obtener una descripción del formato. Se admiten macros de usuario. |
| Utilice si la gravedad | Marque las casillas de verificación de las gravedades de activación para las que desea recibir notificaciones. Tenga en cuenta que la gravedad predeterminada ('No clasificada') debe estar marcada si desea recibir notificaciones para eventos que no son desencadenantes. Después de guardar, las gravedades de los desencadenantes seleccionados se mostrarán en los colores de gravedad correspondientes, mientras que los no seleccionados aparecerán atenuados. |
| Estado | Estado de los medios del usuario. Enabled - está en uso. Disabled - no está en uso. |