6 Etiquetado

Descripción general

Las etiquetas constan de un nombre de etiqueta y un valor de etiqueta. Al etiquetar entidades, puede usar solo el nombre o emparejarlo con un valor (por ejemplo, mysql, jira, target:mysql, service:jira, etc.).

Las etiquetas pueden definirse para varias entidades:

• Plantillas
• Equipos
• Métricas
• Escenarios web
• Disparadores
• Servicios
• Métricas y disparadores de plantilla
• Prototipos de equipo, métrica y disparador

Las etiquetas tienen múltiples propósitos, principalmente marcar eventos. Cuando las entidades están etiquetadas, cualquier nuevo evento relacionado con una entidad etiquetada heredará sus etiquetas. Por ejemplo:

• con plantillas etiquetadas: cualquier problema de equipo (creado por disparadores de la plantilla) heredará las etiquetas de la plantilla;
• con equipos etiquetados: cualquier problema de equipo heredará las etiquetas del equipo;
• con métricas/escenarios web etiquetados: cualquier problema de métrica/escenario web heredará las etiquetas de la métrica/escenario web;
• con disparadores etiquetados: cualquier problema creado por el disparador heredará las etiquetas del disparador.

Un evento de problema hereda todas las etiquetas de toda la cadena de entidades: plantillas, equipos, métricas/escenarios web, disparadores. Las combinaciones idénticas de etiqueta:valor (después de resolver macros) se fusionan en una sola, evitando así duplicaciones.

Las etiquetas de evento personalizadas ofrecen mayor flexibilidad. Por ejemplo:

• la correlación de eventos puede configurarse en función de las etiquetas de evento;
• las condiciones de acción pueden configurarse en función de las etiquetas de evento;
• los problemas de métricas pueden agruparse en función de las etiquetas de evento;
• las etiquetas de problema pueden usarse para asignar problemas a servicios.

Las entidades pueden etiquetarse con el mismo nombre de etiqueta pero diferentes valores de etiqueta (por ejemplo, component:memory y component:storage). De manera similar, una entidad puede tener una etiqueta sin valor y la misma etiqueta con un valor (por ejemplo, database y database:postgresql). Tales etiquetas no se consideran duplicadas.

Casos de uso

Algunos casos de uso comunes para el etiquetado son los siguientes:

1. Marcar eventos de disparadores:
   • Definir una etiqueta de disparador (por ejemplo, scope:performance).
   • Los problemas creados por este disparador tendrán la etiqueta de disparador.
2. Marcar problemas heredados de plantillas:
   • Definir una etiqueta de plantilla (por ejemplo, target:mysql).
   • Los problemas creados por disparadores de esta plantilla tendrán la etiqueta de plantilla.
3. Marcar problemas de equipos:
   • Definir una etiqueta de equipo (por ejemplo, service:jira).
   • Los problemas creados por disparadores de este equipo tendrán la etiqueta de equipo.
4. Filtrar métricas relacionadas:
   • Definir una etiqueta de métrica (por ejemplo, component:cpu).
   • En Supervisión → Últimos datos, las métricas pueden filtrarse por la etiqueta component:cpu.
5. Usar información extraída del valor de la métrica como valor de la etiqueta:
   • Definir una etiqueta con una macro como valor de la etiqueta (por ejemplo, tag-name:{{ITEM.VALUE<N>}.regsub()} ).
   • En Supervisión → Problemas, los problemas tendrán el valor de la etiqueta resuelto con los datos extraídos del valor de la métrica.
6. Identificar problemas en un archivo de registro y cerrarlos por separado:
   • Definir una etiqueta de disparador para el disparador de la métrica de supervisión de registros que extraerá valores del valor de la métrica usando una macro (por ejemplo, service:{{ITEM.VALUE<N>}.regsub()} ).
   • En la configuración del disparador, configurar la correlación de eventos:
     • establecer el modo de generación de eventos PROBLEM en "Múltiples";
     • establecer OK cierra eventos en "Todos los problemas si los valores de las etiquetas coinciden";
     • establecer la etiqueta para la coincidencia.
   • Los problemas creados por el disparador de la métrica de registro tendrán la etiqueta de disparador y se cerrarán individualmente.
7. Filtrar notificaciones:
   • Definir etiquetas de disparador (por ejemplo, scope:security para el disparador1 y scope:availability para el disparador2).
   • Usar el filtrado de etiquetas en las condiciones de acción para recibir notificaciones solo en los eventos que coincidan con los datos de la etiqueta.
8. Identificar problemas en las notificaciones:
   • Definir etiquetas de disparador.
   • Usar la macro {EVENT.TAGS} en la notificación de problema.
   • La notificación de problema contendrá las etiquetas de disparador, facilitando la identificación de a qué aplicación/servicio pertenece la notificación.
9. Simplificar tareas de configuración usando etiquetas de plantilla:
   • Definir una etiqueta de disparador de plantilla.
   • Los disparadores creados a partir de este disparador de plantilla tendrán su etiqueta.
10. Crear disparadores con etiquetas desde el descubrimiento de bajo nivel (LLD):
    • Definir una etiqueta de prototipo de disparador con una macro LLD en el nombre o valor de la etiqueta (por ejemplo, scope:{#FSNAME}).
    • Los disparadores creados a partir del prototipo de disparador tendrán su etiqueta.
11. Vincular servicios usando etiquetas de servicio:
    • Definir etiquetas de servicio.
    • Configurar acciones de servicio para servicios con etiquetas coincidentes.
    • Además, usar etiquetas de servicio para vincular un servicio a un SLA para cálculos de SLA.
12. Vincular servicios a problemas usando etiquetas de problema de servicio:
    • Definir una etiqueta de problema en la configuración del servicio (por ejemplo, target:mysql).
    • Los problemas con una etiqueta coincidente se correlacionarán automáticamente con el servicio, y el estado del servicio cambiará según las reglas de cálculo de estado de servicio configuradas.
13. Suprimir problemas cuando un equipo está en modo de mantenimiento:
    • Definir etiquetas en la configuración del periodo de mantenimiento.
    • Los problemas con las etiquetas definidas serán suprimidos.
14. Conceder acceso a grupos de usuarios:
    • Definir etiquetas en la configuración del grupo de usuarios.
    • Los usuarios del grupo de usuarios solo podrán ver los problemas con las etiquetas definidas.

Configuración

Las etiquetas pueden definirse en una pestaña dedicada, por ejemplo, en la configuración de disparadores:

Soporte de macros

Las macros integradas y macros de usuario en las etiquetas se resuelven en el momento del evento. Hasta que el evento haya ocurrido, estas macros se mostrarán sin resolver en la interfaz de Zabbix.

Las macros de bajo nivel de descubrimiento se resuelven durante el proceso de descubrimiento.

Las siguientes macros pueden usarse en los nombres y valores de etiquetas de disparadores:

• {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}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y {HOST.ID} macros integradas
• {INVENTORY.*} macros integradas (para referenciar valores de inventario de equipo de uno o varios equipos en una expresión de disparador)
• Macros de usuario y macros de usuario con contexto (el contexto puede incluir macros de bajo nivel de descubrimiento)
• Macros de bajo nivel de descubrimiento (solo en etiquetas de prototipo de disparador)

Las siguientes macros pueden usarse en los nombres y valores de etiquetas de plantilla, equipo y métrica/escenario web:

• {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y {HOST.ID} macros integradas
• {INVENTORY.*} macros integradas
• Macros de usuario
• Macros de bajo nivel de descubrimiento (solo en etiquetas de prototipo de equipo y métrica)

Las siguientes macros pueden usarse en notificaciones basadas en disparadores:

• {EVENT.TAGS} y {EVENT.RECOVERY.TAGS} macros integradas (estas macros se resolverán en una lista separada por comas de etiquetas de evento o etiquetas de evento de recuperación)
• {EVENT.TAGSJSON} y {EVENT.RECOVERY.TAGSJSON} macros integradas (estas macros se resolverán en un array JSON que contiene objetos de etiquetas de evento o de recuperación)

Extracción de subcadenas en etiquetas de disparadores

Se admite la extracción de subcadenas para rellenar el nombre o el valor de la etiqueta, utilizando una función de macro. La función aplica una expresión regular al valor obtenido por la macro soportada. Por ejemplo:

{{ITEM.VALUE}.regsub(patrón, salida)}
       {{ITEM.VALUE}.iregsub(patrón, salida)}
       
       {{#LLDMACRO}.regsub(patrón, salida)}
       {{#LLDMACRO}.iregsub(patrón, salida)}

Si el nombre o el valor de la etiqueta supera los 255 caracteres después de la resolución de la macro, se truncará a 255 caracteres.

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

Visualización de etiquetas de eventos

Las etiquetas, si están definidas, pueden visualizarse con los nuevos eventos en:

• Supervisión → Problemas
• Supervisión → Problemas → Detalles del evento
• Cuadros de mando → Widget de Problemas

El orden y el número de etiquetas mostradas se determinan mediante las opciones de filtrado Prioridad de visualización de etiquetas y Mostrar etiquetas en Supervisión → Problemas o en el widget de Problemas del cuadro de mando. Tenga en cuenta que se pueden mostrar un máximo de tres etiquetas; si hay más etiquetas, al pasar el cursor sobre los tres puntos se muestran todas las etiquetas en una ventana emergente.