Configuración de un trigger
Esta página describe cómo configurar un trigger en el frontend de Zabbix.
Tenga en cuenta que las templates oficiales de Zabbix contienen triggers predefinidos. Consulte la guía para aplicar la template a monitor Linux. También es posible actualizar en masa los triggers configurados.
Otros recursos:
- Detección de problemas con triggers (introducción general)
- Ejemplos de triggers (según el caso de uso)
- Expresión y funciones de trigger (detalles de sintaxis)
- Buenas prácticas
Configuración
Para configurar un trigger, haga lo siguiente:
- Vaya a Recopilación de datos > Hosts.
- Haga clic en Triggers en la fila del host.
- Haga clic en Crear trigger a la derecha (o en el nombre del trigger para editar un trigger existente).
- Introduzca los parámetros del trigger en el formulario.
La pestaña Trigger contiene todos los atributos esenciales del trigger.
Todos los campos de entrada obligatorios están marcados con un asterisco rojo.
| Parámetro | Descripción |
|---|---|
| Nombre | Nombre del trigger. Las macros compatibles son: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {ITEM.LOG.*} y las macros de usuario {$MACRO}. Las macros $1, $2...$9 se pueden utilizar para hacer referencia a la primera, segunda... novena constante de la expresión. Nota: las macros $1-$9 se resolverán correctamente si hacen referencia a constantes en expresiones relativamente sencillas y directas. Por ejemplo, el nombre "Carga del procesador superior a $1 en {HOST.NAME}" cambiará automáticamente a "Carga del procesador superior a 5 en New host" si la expresión es last(/New host/system.cpu.load[percpu,avg1])>5. |
| Nombre del evento | Cuando se define, este nombre se utilizará para crear el nombre del evento de problema. De forma predeterminada, el nombre del evento es el mismo que el nombre del trigger. El nombre del evento se puede utilizar para crear alertas significativas que contengan datos del problema (consulte el ejemplo). Se admite el mismo conjunto de macros que en el nombre del trigger, además de las macros de expresión {TIME}, {TIMESTAMP} y {?EXPRESSION}. |
| Datos operativos | Introduzca una cadena (de hasta 2048 caracteres) con macros para mostrar datos dinámicos en tiempo real en Supervisión > Problemas. Como alternativa, deje este campo vacío para mostrar los valores más recientes de todos los items de la expresión del trigger. Se admite el mismo conjunto de macros que en el nombre del trigger, con la posibilidad de resolverlas dinámicamente. Por ejemplo: {ITEM.VALUE<1-9>} se resuelve en los valores de los items en el momento en que cambia el estado del trigger (cuando se crea, resuelve o cierra manualmente un problema, o cuando se cierra mediante correlación). {ITEM.LASTVALUE<1-9>} se resuelve en los valores más recientes de los items. Tenga en cuenta que cerrar un problema manualmente no produce un valor nuevo, por lo que ambas macros seguirán mostrando el valor correspondiente al momento del problema. Tenga también en cuenta que ambas macros se resuelven en UNKNOWN si el valor más reciente es anterior a Periodo máximo de visualización del historial (consulte Administración > General). La función de macro jsonpath no es compatible con el frontend, por lo que se resuelve en UNKNOWN en Supervisión > Problemas; solo la resuelve el Zabbix server, por ejemplo, cuando se utiliza {EVENT.OPDATA} en las notificaciones. |
| Gravedad | Establezca la gravedad requerida del trigger haciendo clic en los botones. |
| Expresión | Expresión lógica utilizada para definir las condiciones de un problema. Se admiten sufijos de tiempo y sufijos de tamaño de memoria. Se crea un problema después de que se cumplan todas las condiciones incluidas en la expresión, es decir, cuando la expresión se evalúa como TRUE. El problema se resolverá en cuanto la expresión se evalúe como FALSE, a menos que se especifiquen condiciones de recuperación adicionales en Expresión de recuperación. |
| Generación de eventos OK | Opciones de generación de eventos OK: Expresión: los eventos OK se generan según la misma expresión que los eventos de problema; Expresión de recuperación: los eventos OK se generan si la expresión del problema se evalúa como FALSE y la expresión de recuperación se evalúa como TRUE; Ninguna: en este caso, el trigger nunca volverá por sí solo al estado OK. |
| Expresión de recuperación | Expresión lógica (opcional) que define condiciones adicionales que deben cumplirse antes de resolver el problema, después de que la expresión original del problema ya se haya evaluado como FALSE. La expresión de recuperación resulta útil para la histéresis del trigger. No es posible resolver un problema únicamente mediante la expresión de recuperación si la expresión del problema sigue siendo TRUE. Este campo solo está disponible si se selecciona 'Expresión de recuperación' en Generación de eventos OK. |
| Modo de generación de eventos PROBLEM | Modo de generación de eventos de problema: Único: se genera un único evento cuando un trigger entra por primera vez en el estado 'Problem'; Múltiple: se genera un evento en cada evaluación 'Problem' del trigger. |
| El evento OK cierra | Seleccione qué cierra el evento OK: Todos los problemas: todos los problemas de este trigger; Todos los problemas si los valores de las etiquetas coinciden: solo los problemas de este trigger cuyos valores de etiquetas de evento coincidan. |
| Etiqueta para la coincidencia | Introduzca el nombre de la etiqueta de evento que se utilizará para la correlación de eventos. Este campo se muestra si se selecciona 'Todos los problemas si los valores de las etiquetas coinciden' para la propiedad El evento OK cierra y es obligatorio en ese caso. |
| Permitir cierre manual | Marque esta opción para permitir el cierre manual de los eventos de problema generados por este trigger. El cierre manual es posible al reconocer eventos de problema. |
| Nombre de la entrada de menú | Si no está vacío, el nombre introducido aquí (de hasta 64 caracteres) se utiliza en varias ubicaciones del frontend como etiqueta para la URL del trigger especificada en el parámetro URL de la entrada de menú. Si está vacío, se utiliza el nombre predeterminado URL del trigger. Se admite el mismo conjunto de macros que en el nombre del trigger, además de {EVENT.ID}, {HOST.ID} y {TRIGGER.ID}. |
| URL de la entrada de menú | Si no está vacía, la URL introducida aquí (de hasta 2048 caracteres) estará disponible como enlace en el menú de eventos en varias ubicaciones del frontend, por ejemplo, al hacer clic en el nombre del problema en Supervisión > Problemas o en el widget de panel Problemas. Se admite el mismo conjunto de macros que en el nombre del trigger, además de {EVENT.ID}, {HOST.ID} y {TRIGGER.ID}. Nota: las macros de usuario con valores secretos no se resolverán en la URL. |
| Descripción | Campo de texto utilizado para proporcionar más información sobre este trigger. Puede contener instrucciones para solucionar un problema específico, datos de contacto del personal responsable, etc. Se admite el mismo conjunto de macros que en el nombre del trigger. |
| Habilitado | Desmarque esta casilla para deshabilitar el trigger si es necesario. Los problemas de un trigger deshabilitado ya no se muestran en el frontend, pero no se eliminan. |
La pestaña Etiquetas permite definir etiquetas a nivel del trigger.
Todos los problemas de este trigger se etiquetarán con los valores introducidos aquí.
Además, la opción Etiquetas heredadas y del trigger permite ver las etiquetas definidas a nivel del template si el trigger procede de ese template. Si hay varios templates con la misma etiqueta, estas etiquetas se muestran una sola vez y los nombres de los templates se separan mediante comas. Un trigger no "hereda" ni muestra las etiquetas a nivel del host.
| Parámetro | Descripción |
|---|---|
| Nombre/Valor | Establezca etiquetas personalizadas para marcar los eventos del trigger. Las etiquetas son un par formado por un nombre y un valor. Puede utilizar solo el nombre o combinarlo con un valor. Un trigger puede tener varias etiquetas con el mismo nombre, pero con valores diferentes. Las macros de usuario, las macros de usuario con contexto, las macros de descubrimiento de bajo nivel y las funciones de macros con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} son compatibles con las etiquetas de eventos. Las macros de descubrimiento de bajo nivel se pueden utilizar dentro del contexto de una macro.La macro {TRIGGER.ID} es compatible con los valores de las etiquetas del trigger. Puede resultar útil para identificar triggers creados a partir de prototipos de trigger y, por ejemplo, suprimir los problemas de estos triggers durante el mantenimiento. Si la longitud total del valor expandido supera los 255 caracteres, se truncará a 255 caracteres. Consulte todas las macros compatibles con las etiquetas de eventos. Las etiquetas de eventos se pueden utilizar para la correlación de eventos y en las condiciones de las acciones, y también se mostrarán en Supervisión > Problemas o en el widget Problemas. |
La pestaña Dependencias contiene todas las dependencias del trigger.
Haga clic en Añadir para añadir una dependencia nueva.
También puede configurar un trigger abriendo uno existente, haciendo clic en el botón Clonar y guardándolo con un nombre diferente.
Prueba de la expresión del trigger
Es posible probar cuál sería el resultado de la expresión en función del valor recibido.
La siguiente expresión de una template oficial se toma como ejemplo:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Para probar la expresión, haga clic en Constructor de expresiones debajo del campo de expresión.
En el Constructor de expresiones, se enumeran todas las expresiones individuales. Para abrir la ventana de prueba, haga clic en Probar debajo de la lista de expresiones.
En la ventana de prueba puede introducir valores de ejemplo ('80', '70', '0', '1' en este ejemplo) y luego ver el resultado de la expresión, haciendo clic en el botón Probar.
Se puede ver el resultado de las expresiones individuales, así como de la expresión completa.
"TRUE" significa que la expresión especificada es correcta.
En este caso A, "80" es mayor que el valor especificado {$TEMP_WARN}, "70" en este ejemplo.
Como era de esperar, aparece un resultado "TRUE".
"FALSE" significa que la expresión especificada es incorrecta.
En este caso B, {$TEMP_WARN_STATUS} "1" debe ser igual al valor especificado, "0" en este ejemplo.
Como era de esperar, aparece un resultado "FALSE".
El tipo de expresión elegido es "OR". Si al menos una de las condiciones especificadas (A o B en este caso) es TRUE, el resultado global también será TRUE. Esto significa que el valor actual supera el valor de advertencia y se ha producido un problema.