6 Etiquetado

Descripción general

Hay una opción para etiquetar varias entidades en Zabbix. Las etiquetas pueden ser definidas para:

• plantillas
• equipos
• métricas
• escenarios web
• iniciadores
• servicios
• plantillas de métricas e iniciadores
• prototipos de equipos, métricas e iniciadores

Las etiquetas tienen varios usos, sobre todo para marcar eventos. Si las entidades son etiquetadas, los nuevos eventos correspondientes se marcan en consecuencia:

• con plantillas etiquetadas - cualquier problema de equipo creado por entidades relevantes (métricas, iniciadores, etc.) de esta plantilla se marcarán
• con equipos etiquetados - cualquier problema del equipo será marcado
• con métricas etiquetadas, escenarios web - cualquier dato/problema de esta métrica o escenario web estará marcado.
• con iniciadores etiquetados - cualquier problema con este iniciador será marcado

Un evento de problema hereda todas las etiquetas de toda la cadena de plantillas, equipos, métricas, escenarios web, iniciadores. Las combinaciones completamente idénticas de Etiqueta:valor (después de resolver las macros) se fusionan en una en lugar de ser duplicadas, cuando se marca el evento.

Tener etiquetas de eventos personalizadas permite una mayor flexibilidad. En tono rimbombante, los eventos se pueden correlacionar según las etiquetas de eventos. En otros usos, las acciones se pueden definir en función de etiquetas de eventos. Los problemas de las métricas se pueden agrupar según las etiquetas. Las etiquetas de problemas también se pueden utilizar para asignar problemas a servicios.

El etiquetado se realiza como un par de nombre de etiqueta y valor. Puede usar solo el nombre o emparejarlo con un valor:

MySQL, Servicio:MySQL, Servicios, Servicios:Cliente, Aplicaciones, Aplicación:Java, Prioridad:Alta

Una entidad (plantilla, equipo, métrica, escenario web, iniciador o evento) puede ser etiquetada con el mismo nombre, pero con valores diferentes; estas etiquetas no serán considerados "duplicados". De manera similar, una etiqueta sin valor y la misma etiqueta con valor se pueden utilizar simultáneamente.

Casos de uso

Algunos casos de uso de esta funcionalidad son los siguientes:

1. Marque los eventos de iniciador en la interfaz:
   • Defina una etiqueta en el nivel de activación, por ejemplo alcance:rendimiento;
   • Todos los problemas creados por este iniciador se marcarán con esta etiqueta.
2. Marque todos los problemas heredados de plantilla:
   • Defina una etiqueta a nivel de plantilla, por ejemplo target:MySQL;
   • Todos los problemas del equipo creados por iniciadores de esta plantilla se marcarán con esta etiqueta.
3. Marque todos los problemas del equipo:
   • Defina una etiqueta a nivel de equipo, por ejemplo service:Jira;
   • Todos los problemas de los iniciadores del equipo se marcarán con esta etiqueta.
4. Métricas relacionadas con el grupo:
   • Defina una etiqueta a nivel de métrica, por ejemplo componente:cpu;
   • En la sección Últimos datos, use el filtro de etiquetas para ver todas las métricas etiquetados como componente:cpu.
5. Identifique los problemas en un archivo de registro y ciérrelos por separado:
   • Defina etiquetas en el iniciador de registro que identificarán eventos mediante la extracción de valores mediante la macro {{ITEM.VALUE<N>}.regsub()};
   • En la configuración del iniciador, establezca el modo de generación de eventos de problemas múltiples;
   • En la configuración del iniciador, utilice la correlación de eventos: seleccione la opción que Aceptar evento cierra solo los eventos coincidentes y elija la etiqueta para coincidir;
   • Ver eventos de problemas creados con una etiqueta y cerrados individualmente.
6. Úselo para filtrar notificaciones:
   • Defina etiquetas en el nivel de iniciador para marcar eventos mediante diferentes etiquetas;
   • Utilice el filtrado de etiquetas en condiciones de acción para recibir notificaciones solo sobre los eventos que coincidan con los datos de la etiqueta.
7. Utilice información extraída del valor de la métrica como valor de etiqueta:
   • Utilice una macro {{ITEM.VALUE<N>}.regsub()} en el valor de la etiqueta;
   • Ver valores de etiquetas en Monitoreo → Problemas como datos extraídos del valor del artículo.
8. Identifique mejor los problemas en las notificaciones:
   • Defina etiquetas en el nivel de activación;
   • Utilice una macro {EVENT.TAGS} en la notificación del problema;
   • Identifique más fácilmente a qué aplicación/servicio pertenece la notificación.
9. Simplifique las tareas de configuración utilizando etiquetas a nivel de plantilla:
   • Defina etiquetas en el nivel de activación de la plantilla;
   • Vea estas etiquetas en todos los iniciadores creados a partir de iniciadores de plantilla.
10. Cree iniciadores con etiquetas de descubrimiento de bajo nivel (LLD):
    • Definir etiquetas en prototipos de activación;
    • Utilice macros LLD en el nombre o valor de la etiqueta;
    • Vea estas etiquetas en todos los iniciadores creados a partir de prototipos de iniciadores.
11. Haga coincidir los servicios usando las etiquetas de servicio:
    • Defina acciones de servicio para servicios con etiquetas coincidentes;
    • Utilice etiquetas de servicio para asignar un servicio a un SLA para cálculos de SLA.
12. Asigne servicios a problemas usando etiquetas de problema:
    • En la configuración del servicio, especifique la etiqueta de problema, por ejemplo target:MySQL;
    • Los problemas con la etiqueta coincidente se correlacionarán automáticamente con el servicio;
    • El estado del servicio cambiará al estado del problema con mayor gravedad.
13. Suprima problemas cuando un equipo está en modo de mantenimiento:
    • Defina etiquetas en Períodos de mantenimiento para suprimir solo los problemas con etiquetas coincidentes.
14. Otorgue acceso a grupos de usuarios:
    • Especifique etiquetas en la configuración del grupo de usuarios para permitir ver solo problemas con etiquetas coincidentes.

Configuración

Las etiquetas se pueden ingresar en una pestaña dedicada, por ejemplo, en disparador configuración:

Soporte de macros

Las macros integradas y de usuario en las etiquetas se resuelven en el momento del evento. Hasta que ocurra el evento, estas macros se mostrarán en la interfaz de Zabbix sin resolver. Las macros de descubrimiento de bajo nivel se resuelven durante el proceso de descubrimiento.

Las siguientes macros se pueden utilizar en etiquetas de activación:

• {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y { ID.HOST} Se pueden utilizar macros para completar el nombre de la etiqueta o el valor de la etiqueta.
• Se puede utilizar las macros {INVENTORY.*} para hacer referencia a valores de inventario de equipos de uno o varios equipos en una expresión de iniciador.
• Se admiten las macros de usuario y macros de usuario con contexto para el nombre/valor de la etiqueta; El contexto puede incluir macros de descubrimiento de bajo nivel.
• Se pueden utilizar macros de descubrimiento de bajo nivel para el nombre/valor de la etiqueta en desencadenar prototipos.

Las siguientes macros se pueden utilizar en notificaciones basadas en iniciadores:

• Las macros {EVENT.TAGS} y {EVENT.RECOVERY.TAGS} se resolverán en una lista separada por comas de etiquetas de eventos o etiquetas de eventos de recuperación.
• Las macros {EVENT.TAGSJSON} y {EVENT.RECOVERY.TAGSJSON} se resolverán a una matriz JSON que contiene una etiqueta de objetos de evento u objetos de recuperación de etiqueta de evento

Las siguientes macros se pueden utilizar en las etiquetas de plantilla, equipo, métrica y escenario web:

• Las Macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y {HOST.ID}
• Las macros {INVENTORY.*}
• Las macros de usuario
• Se pueden utilizar macros de descubrimiento de bajo nivel en etiquetas de prototipos de métricas

Se pueden utilizar las siguientes macros en etiquetas de prototipo de equipo:

• Las macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y {HOST.ID}
• Las macros {INVENTORY.*}
• Las macros de usuario
• Las macros de descubrimiento de bajo nivel se resuelven durante el proceso de descubrimiento y luego se agregan al equipo descubierto

Extracción de subcadenas en etiquetas desencadenantes

Se admite la extracción de subcadenas para completar el nombre de la etiqueta o la etiqueta valor, usando una macro función - aplicando una expresión regular al valor obtenido por {ITEM.VALUE}, {ITEM.LASTVALUE} macro o una macro de descubrimiento de bajo nivel. Por ejemplo:

{{ARTÍCULO.VALOR}.regsub(patrón, salida)}
       {{ARTÍCULO.VALOR}.iregsub(patrón, salida)}
       
       {{#LLDMACRO}.regsub(patrón, salida)}
       {{#LLDMACRO}.iregsub(patrón, salida)}

El nombre y el valor de la etiqueta se reducirán a 255 caracteres si su longitud excede 255 caracteres después de la resolución macro.

Ver también: Uso de funciones de macro en descubrimiento de bajo nivel macros para etiquetado de eventos.

Ver etiquetas de eventos

El etiquetado, si está definido, se puede ver con nuevos eventos en:

• Monitoreo → Problemas
• Monitoreo → Problemas → Detalles del evento
• Monitoreo → Tablero → widget Problemas

Sólo se pueden mostrar las tres primeras entradas de etiquetas. Si hay más de tres entradas de etiquetas, se indica con tres puntos. Si mueve el mouse sobre estos tres puntos, todas las entradas de etiquetas se muestran en una ventana emergente.

Tenga en cuenta que el orden en el que se muestran las etiquetas se ve afectado por el filtrado de etiqueta y la opción Prioridad de visualización de etiquetas en el filtro de Monitoreo → Problemas o el widget de tablero Problemas.