Documentation
Table of Contents
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 las entidades (métricas, iniciadores, etc.) de esta plantilla se marcará
- 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 se marcará
- con iniciadores etiquetados - cualquier problema de 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 combinacionesetiqueta:valor completamente idénticas (después de las macros resueltas) se fusionan en una en lugar de duplicarse, al marcar el evento.
Tener etiquetas de eventos personalizadas permite una mayor flexibilidad. Es importante destacar que los eventos pueden estar correlacionados según las etiquetas de eventos En otros usos, las acciones se pueden definir en función de etiquetas de eventos. Los problemas de elementos se pueden agrupar en función de las etiquetas. Las etiquetas de problemas también se pueden usar para asignar problemas a servicios.
El etiquetado se realiza como una pareja nombre de etiqueta y valor. Puede usar solo el nombre o emparejarlo con un valor:
Una entidad (plantilla, equipo, métrica, escenario web, iniciador o evento) puede ser etiquetada con el mismo nombre, pero con diferentes valores; estas etiquetas no se consideran 'duplicados'. Del mismo modo, 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:
- Marcar los eventos de iniciador en la interfaz:
- Defina una etiqueta en el nivel de iniciador, por ejemplo
alcance:rendimiento; - Todos los problemas creados por este iniciador se marcarán con esta etiqueta.
- Defina una etiqueta en el nivel de iniciador, por ejemplo
- Marque todos los problemas heredados de plantilla:
- Definir 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.
- Definir una etiqueta a nivel de plantilla, por ejemplo
- Marque todos los problemas del equipo:
- Definir una etiqueta a nivel de equipo, por ejemplo
service:Jira; - Todos los problemas de los iniciadores del equipo se marcarán con esta etiqueta.
- Definir una etiqueta a nivel de equipo, por ejemplo
- Métricas relacionadas con el grupo:
- Definir 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.
- Definir una etiqueta a nivel de métrica, por ejemplo
- 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.
- Defina etiquetas en el iniciador de registro que identificarán eventos mediante la extracción de valores mediante la macro
- Úselo para filtrar notificaciones:
- Definir 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.
- 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 de la métrica.
- Utilice una macro
- Identificar mejor los problemas en las notificaciones:
- Definir etiquetas en el nivel de iniciador;
- Utilice una macro {EVENT.TAGS} en la notificación del problema;
- Identificar más fácilmente a qué aplicación/servicio pertenece la notificación.
- Simplifique las tareas de configuración utilizando etiquetas a nivel de plantilla:
- Definir etiquetas en el nivel de la plantilla de iniciadores;
- Vea estas etiquetas en todos los iniciadores creados a partir de la plantilla de iniciadores.
- Cree iniciadores con etiquetas de descubrimiento de bajo nivel (LLD):
- Definir etiquetas en prototipos de iniciador;
- 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.
- Haga coincidir los servicios usando etiquetas de servicio:
- Definir acciones de servicio para servicios con etiquetas coincidentes;
- Utilice etiquetas de servicio para asignar un servicio a un SLA para cálculos de SLA.
- Asigne servicios a problemas usando etiquetas de problema:
- En la configuración del servicio, especifique 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.
- En la configuración del servicio, especifique etiqueta de problema, por ejemplo
- Suprimir problemas cuando un equipo está en modo de mantenimiento:
- Defina etiquetas en Períodos de mantenimiento para suprimir solo los problemas con etiquetas coincidentes.
- Otorgar acceso a grupos de usuarios:
- Especifique etiquetas en la configuración del grupo de usuarios para permitir ver solo los 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 macros {INVENTORY.*} para hacer referencia a valores de inventario de equipos de uno o varios equipos en una expresión de activación.
- Se admiten 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 prototipos de iniciadores.
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 o objetos de etiqueta de eventos de recuperación
Las siguientes macros se pueden utilizar en etiquetas de plantilla, equipo, métrica y escenario web:
- {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, Macros {HOST.PORT} y {HOST.ID}
- macros {INVENTORY.*}
- 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:
- {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, Macros {HOST.PORT} y {HOST.ID}
- macros {INVENTORY.*}
- Macros de usuario
- Las macros de descubrimiento de bajo nivel se resolverán durante el proceso de descubrimiento y luego se agregarán 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
- Tableros → 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 del panel de control Problemas.