1 Configurando un trigger
Descripción general
Para configurar un trigger, haga lo siguiente:
- Vaya a: Data collection > Hosts
- Haga clic en Triggers en la fila del host
- Haga clic en Create trigger a la derecha (o en el nombre del trigger para editar un trigger existente)
- Introduzca los parámetros del trigger en el formulario
Consulte también la información general sobre los triggers y sus tiempos de cálculo.
Configuración
La pestaña Trigger contiene todos los atributos esenciales del trigger.
Todos los campos de entrada obligatorios están marcados con un asterisco rojo.
| Parameter | Description |
|---|---|
| Name | Nombre del trigger. Los 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 los macros de usuario {$MACRO}. Los macros $1, $2...$9 se pueden usar para referirse a la primera, segunda...novena constante de la expresión. Nota: los macros $1-$9 se resolverán correctamente si hacen referencia a constantes en expresiones relativamente simples y directas. Por ejemplo, el nombre "Processor load above $1 on {HOST.NAME}" cambiará automáticamente a "Processor load above 5 on New host" si la expresión es last(/New host/system.cpu.load[percpu,avg1])>5. |
| Event name | Cuando se define, este nombre se usará 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 puede usarse para generar 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 los macros de expresión {TIME}, {TIMESTAMP} y {?EXPRESSION}. |
| Operational data | Los datos operativos permiten definir cadenas arbitrarias junto con macros. Los macros se resolverán dinámicamente en datos en tiempo real en Monitoring > Problems. Mientras que los macros en el nombre del trigger (véase arriba) se resolverán según sus valores en el momento en que ocurra un problema y se convertirán en la base de un nombre de problema estático, los macros en los datos operativos mantienen la capacidad de mostrar la información más reciente de forma dinámica. Si no se configura ningún dato operativo a nivel de trigger, se mostrarán los valores más recientes de todos los items de la expresión. Se admite el mismo conjunto de macros que en el nombre del trigger. |
| Severity | Establezca la severidad requerida del trigger haciendo clic en los botones. |
| Expression | Expresión lógica usada 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 Recovery expression. |
| OK event generation | Opciones de generación de eventos OK: Expression - los eventos OK se generan en función de la misma expresión que los eventos de problema; Recovery expression - 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; None - en este caso, el trigger nunca volverá por sí solo a un estado OK. |
| Recovery expression | Expresión lógica (opcional) que define condiciones adicionales que deben cumplirse antes de que se resuelva el problema, después de que la expresión original del problema ya se haya evaluado como FALSE. La expresión de recuperación es útil para la histéresis del trigger. No es posible resolver un problema solo mediante la expresión de recuperación si la expresión del problema sigue siendo TRUE. Este campo solo está disponible si se selecciona 'Recovery expression' para OK event generation. |
| PROBLEM event generation mode | Modo de generación de eventos de problema: Single - se genera un único evento cuando un trigger entra por primera vez en el estado 'Problem'; Multiple - se genera un evento en cada evaluación 'Problem' del trigger. |
| OK event closes | Seleccione si el evento OK cierra: All problems - todos los problemas de este trigger; All problems if tag values match - solo aquellos problemas del trigger con valores de etiqueta de evento coincidentes. |
| Tag for matching | Introduzca el nombre de la etiqueta de evento que se usará para la correlación de eventos. Este campo se muestra si se selecciona 'All problems if tag values match' para la propiedad OK event closes y es obligatorio en este caso. |
| Allow manual close | 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 los eventos de problema. |
| Menu entry name | Si no está vacío, el nombre introducido aquí (hasta 64 caracteres) se usa en varias ubicaciones del frontend como etiqueta para la URL del trigger especificada en el parámetro Menu entry URL. Si está vacío, se usa el nombre predeterminado Trigger URL. Se admite el mismo conjunto de macros que en el nombre del trigger, además de {EVENT.ID}, {HOST.ID} y {TRIGGER.ID}. |
| Menu entry URL | Si no está vacío, la URL introducida aquí (hasta 2048 caracteres) está disponible como enlace en el menú de eventos en varias ubicaciones del frontend, por ejemplo, al hacer clic en el nombre del problema en Monitoring > Problems o en el widget del panel Problems. Se admite el mismo conjunto de macros que en el nombre del trigger, además de {EVENT.ID}, {HOST.ID} y {TRIGGER.ID}. Nota: los macros de usuario con valores secretos no se resolverán en la URL. |
| Description | Campo de texto usado para proporcionar más información sobre este trigger. Puede contener instrucciones para corregir un problema específico, datos de contacto del personal responsable, etc. Se admite el mismo conjunto de macros que en el nombre del trigger. |
| Enabled | Desmarcar esta casilla 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 Tags le permite definir etiquetas a nivel de trigger. Todos los problemas de este trigger se etiquetarán con los valores introducidos aquí.
Además, la opción Inherited and trigger tags permite ver las etiquetas definidas a nivel de 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 con comas. Un trigger no "hereda" ni muestra etiquetas a nivel de host.
| Parameter | Description |
|---|---|
| Name/Value | Establezca etiquetas personalizadas para marcar eventos de trigger. Las etiquetas son un par de nombre y valor de etiqueta. Puede usar solo el nombre o asociarlo con un valor. Un trigger puede tener varias etiquetas con el mismo nombre, pero con valores diferentes. Los macros de usuario, los macros de usuario con contexto, los macros de descubrimiento de bajo nivel y las funciones de macro functions con {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} son compatibles en las etiquetas de evento.Los macros de descubrimiento de bajo nivel se pueden usar dentro del contexto de macro. El macro {TRIGGER.ID} es compatible en los valores de las etiquetas del trigger. Puede ser útil para identificar triggers creados a partir de prototipos de trigger y, por ejemplo, suprimir problemas de estos triggers durante el mantenimiento. Si la longitud total del valor expandido supera 255, se truncará a 255 caracteres. Consulte todos los macros compatibles con las etiquetas de evento. Las etiquetas de evento se pueden usar para la correlación de eventos, en condiciones de acciones y también se verán en Monitoring > Problems o en el widget Problems. |
La pestaña Dependencies contiene todas las dependencias del trigger.
Haga clic en Add para añadir una nueva dependencia.
También puede configurar un trigger abriendo uno existente, haciendo clic en el botón Clone y guardándolo después con un nombre diferente.
Prueba de expresiones
Es posible probar la expresión de trigger configurada para ver 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 Expression constructor debajo del campo de expresión.
En Expression constructor, se enumeran todas las expresiones individuales. Para abrir la ventana de prueba, haga clic en Test 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 Test.
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 concreto 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 concreto 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.