Áú»¢¶Ä²©

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 combinarlo con un valor (por ejemplo, mysql, jira, target:mysql, service:jira, etc.).

Las etiquetas se pueden definir para varias entidades:

  • Plantillas
  • Equipos
  • ²Ñ¨¦³Ù°ù¾±³¦²¹s
  • Escenarios web
  • Iniciadores
  • Servicios
  • Plantillas de ³¾¨¦³Ù°ù¾±³¦²¹²õ e iniciadores
  • Prototipos de equipo, m¨¦trica e iniciador

Consulte las pautas oficiales de Áú»¢¶Ä²© para obtener recomendaciones generales sobre la definici¨®n de etiquetas, junto con una gu¨ªa espec¨ªfica para plantillas, ³¾¨¦³Ù°ù¾±³¦²¹²õ, iniciadores y reglas de descubrimiento de bajo nivel.

Las etiquetas tienen m¨²ltiples prop¨®sitos, principalmente, marcar eventos. Cuando se etiquetan entidades, cualquier evento nuevo relacionado con una entidad etiquetada heredar¨¢ sus etiquetas. Por ejemplo:

  • con plantillas etiquetadas - cualquier problema de equipo (creado por iniciadores de la plantilla) heredar¨¢ las etiquetas de la plantilla;
  • con equipos etiquetados - cualquier problema de equipo heredar¨¢ las etiquetas de equipo;
  • con ³¾¨¦³Ù°ù¾±³¦²¹²õ/escenarios web etiquetados: cualquier problema de m¨¦trica/escenario web heredar¨¢ las etiquetas de m¨¦trica/escenario web;
  • con iniciadores etiquetados: cualquier problema creado por el iniciador heredar¨¢ las etiquetas del iniciador.

Un evento de problema hereda todas las etiquetas de toda la cadena de entidades: plantillas, equipos, ³¾¨¦³Ù°ù¾±³¦²¹²õ/escenarios web, iniciadores. Las combinaciones id¨¦nticas de etiqueta:valor (despu¨¦s de las macros resueltas) se fusionan en una, evitando as¨ª la duplicaci¨®n.

Las etiquetas de evento personalizadas ofrecen m¨¢s flexibilidad. Por ejemplo:

  • correlaci¨®n de eventos se puede configurar en ´Ú³Ü²Ô³¦¾±¨®²Ô de las etiquetas de eventos;
  • condiciones de acci¨®n se pueden configurar en ´Ú³Ü²Ô³¦¾±¨®²Ô de las etiquetas de eventos;
  • los problemas de elementos se pueden agrupar en ´Ú³Ü²Ô³¦¾±¨®²Ô de las etiquetas de eventos;
  • las etiquetas de problemas se pueden usar para asignar problemas a servicios.

Las entidades pueden tener 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 un valor y la misma etiqueta con un valor (por ejemplo, database y database:postgresql). Dichas etiquetas no se consideran duplicadas.

Casos de uso

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

  1. Marcar eventos de iniciador:
    • Defina una etiqueta de iniciador (por ejemplo, scope:performance).
    • Los problemas creados por este iniciador tendr¨¢n la etiqueta de iniciador.
  2. Marcar problemas heredados de plantilla:
    • Defina una etiqueta de plantilla (por ejemplo, target:mysql).
    • Los problemas creados por iniciadores de esta plantilla tendr¨¢n la etiqueta de la plantilla.
  3. Marcar problemas de equipo:
    • Defina una etiqueta de equipo (por ejemplo, service:jira).
    • Los problemas creados por iniciadores de este equipo tendr¨¢n la etiqueta del equipo.
  4. Filtrar ³¾¨¦³Ù°ù¾±³¦²¹²õ relacionadas:
    • Defina una etiqueta de m¨¦trica (por ejemplo, component:cpu).
    • En Monitoring ¡ú Latest data, las ³¾¨¦³Ù°ù¾±³¦²¹²õ se pueden filtrar por la etiqueta component:cpu.
  5. Utilice la informaci¨®n extra¨ªda del valor de la m¨¦trica como valor de etiqueta:
    • Defina una etiqueta con una macro como valor de etiqueta (por ejemplo, tag-name:{{ITEM.VALUE<N>}.regsub()} ).
    • En Monitoreo ¡ú Problemas, los problemas tendr¨¢n el valor de etiqueta resuelto en los datos extra¨ªdos del valor de la m¨¦trica.
  6. Identifique los problemas en un archivo de registro y ci¨¦rrelos por separado:
    • Defina una etiqueta de iniciador para el iniciador de la m¨¦trica de monitoreo de registro que extraer¨¢ valores del valor de la m¨¦trica utilizando una macro (por ejemplo, service:{{ITEM.VALUE<N>}.regsub()} ).
    • En la configuraci¨®n del iniciador, configure la correlaci¨®n de eventos:
    • configure PROBLEM event generation mode en "Multiple";
    • configure OK event closes en "All problems if tag values match";
    • configure la etiqueta para la coincidencia.
    • Los problemas creados por el iniciador de la m¨¦trica de registro tendr¨¢n la etiqueta del iniciador y se cerrar¨¢n individualmente.
  7. Filtrar notificaciones:
    • Defina etiquetas del iniciador (por ejemplo, scope:security para el iniciador1 y scope:availability para el iniciador2).
    • Use el filtrado de etiquetas en las conodiciones de acci¨®n para recibir notificaciones solo sobre los eventos que coincidan con los datos de la etiqueta.
  8. Identificar problemas en las notificaciones:
    • Defina etiquetas del iniciador.
    • Utilice la macro {EVENT.TAGS} en la notificaci¨®n del problema.
    • La notificaci¨®n del problema contendr¨¢ las etiquetas del iniciador, lo que facilita la identificaci¨®n de la aplicaci¨®n o el servicio al que pertenece la notificaci¨®n.
  9. Simplifique las tareas de configuraci¨®n mediante el uso de etiquetas de plantilla:
    • Defina una etiqueta de plantilla de iniciador.
    • Los iniciadores creados a partir de esta plantilla de iniciador tendr¨¢n su etiqueta.
  10. Cree iniciadores con etiquetas de detecci¨®n de bajo nivel (LLD):
    • Defina una etiqueta de prototipo de iniciador con una macro LLD en el nombre o el valor de la etiqueta (por ejemplo, scope:{#FSNAME}).
    • Los iniciadores creados a partir del prototipo de iniciador tendr¨¢n su etiqueta.
  11. Haga coincidir los servicios mediante etiquetas de servicio:
  12. Vincule servicios a problemas mediante etiquetas de problemas de servicio:
    • Defina una etiqueta de problema en configuraci¨®n de 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 del estado del servicio configuradas.
  13. Suprima problemas cuando un equipo est¨¦ en modo de mantenimiento:
  14. Otorgar acceso a grupos de usuarios:

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô

Las etiquetas se pueden definir en una pesta?a dedicada, por ejemplo, en la configuraci¨®n de iniciadores:

Compatibilidad con macros

Las macros integradas y de usuario en las etiquetas se resuelven en el momento del evento. Hasta que se produzca el evento, estas macros se mostrar¨¢n sin resolver en la interfaz de Áú»¢¶Ä²©.

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

Las siguientes macros se pueden utilizar en los nombres y valores de las etiquetas de iniciador:

  • Macros integradas {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} y {HOST.ID}
  • Macros integradas {INVENTORY.*} (para hacer referencia a los valores de inventario de host de uno o varios hosts en una expresi¨®n de activaci¨®n)
  • Macros de usuario y macros de usuario con contexto (el contexto puede incluir macros de detecci¨®n de bajo nivel)
  • Macros de detecci¨®n de bajo nivel (solo en las etiquetas de prototipo de activaci¨®n)

Las siguientes macros se pueden utilizar en los nombres y valores de las etiquetas de plantilla, equipo y elemento/escenario web:

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

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

  • Macros integradas {EVENT.TAGS} y {EVENT.RECOVERY.TAGS} (estas macros se resolver¨¢n en una lista separada por comas de etiquetas de eventos o etiquetas de eventos de recuperaci¨®n)
  • Macros integradas {EVENT.TAGSJSON} y {EVENT.RECOVERY.TAGSJSON} (estas macros se resolver¨¢n en una matriz JSON que contiene objetos de etiquetas de eventos u objetos de etiquetas de eventos de recuperaci¨®n)
Extracci¨®n de subcadenas en etiquetas de iniciador

La extracci¨®n de subcadenas es compatible para completar el nombre o el valor de la etiqueta mediante una ´Ú³Ü²Ô³¦¾±¨®²Ô de macro. La ´Ú³Ü²Ô³¦¾±¨®²Ô aplica una expresi¨®n regular al valor obtenido por la macro compatible. Por ejemplo:

{{ITEM.VALUE}.regsub(pattern, output)}
       {{ITEM.VALUE}.iregsub(pattern, output)}
       
       {{#LLDMACRO}.regsub(pattern, output)}
       {{#LLDMACRO}.iregsub(pattern, output)}

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 detecci¨®n de bajo nivel para el etiquetado de eventos.

Visualizaci¨®n de etiquetas de eventos

Las etiquetas, si est¨¢n definidas, se pueden visualizar con nuevos eventos en:

El orden y la cantidad de etiquetas mostradas se determina mediante las opciones de filtrado Prioridad de visualizaci¨®n de etiquetas y Mostrar etiquetas en Monitoreo ¡ú Problemas o en el widget de tablero Problemas. Tenga en cuenta que se puede 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.