Etiquetas y anotaciones - Amazon Managed Grafana

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Etiquetas y anotaciones

Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.

Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9

Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8

Las etiquetas y anotaciones contienen información sobre una alerta. Tanto las etiquetas como las anotaciones tienen la misma estructura: un conjunto de valores con nombre; sin embargo, sus usos previstos son diferentes. Un ejemplo de etiqueta, o de anotación equivalente, podría ser. alertname="test"

La principal diferencia entre una etiqueta y una anotación es que las etiquetas se utilizan para diferenciar una alerta de todas las demás alertas, mientras que las anotaciones se utilizan para añadir información adicional a una alerta existente.

Por ejemplo, pensemos en dos alertas de CPU altas: una para server1 y otra para. server2 En este ejemplo, podríamos tener una etiqueta llamada en la server que la primera alerta tenga la etiqueta server="server1" y la segunda alerta tenga la etiquetaserver="server2". Sin embargo, es posible que también deseemos añadir una descripción a cada alerta"The CPU usage for server1 is above 75%.", por ejemplo, dónde server1 75% se sustituyen por el nombre y el uso de la CPU del servidor (consulte la documentación sobre Creación de plantillas de etiquetas y anotaciones cómo hacerlo). Este tipo de descripción sería más adecuada como anotación.

Etiquetas

Las etiquetas contienen información que identifica una alerta. Un ejemplo de etiqueta podría serserver=server1. Cada alerta puede tener más de una etiqueta y el conjunto completo de etiquetas de una alerta se denomina conjunto de etiquetas. Es este conjunto de etiquetas el que identifica la alerta.

Por ejemplo, una alerta puede tener la etiqueta establecida {alertname="High CPU usage",server="server1"} mientras que otra alerta puede tener la etiqueta establecida{alertname="High CPU usage",server="server2"}. Se trata de dos alertas independientes porque, aunque sus alertname etiquetas son las mismas, son diferentes. server

El conjunto de etiquetas para una alerta es una combinación de las etiquetas de la fuente de datos, las etiquetas personalizadas de la regla de alerta y una serie de etiquetas reservadas, como. alertname

Etiquetas personalizadas

Las etiquetas personalizadas son etiquetas adicionales de la regla de alerta. Al igual que las anotaciones, las etiquetas personalizadas deben tener un nombre y su valor puede contener una combinación de texto y código de plantilla que se evalúa cuando se activa una alerta. La documentación sobre cómo crear plantillas de etiquetas personalizadas se encuentra aquí.

Al utilizar etiquetas personalizadas con plantillas, es importante asegurarse de que el valor de la etiqueta no cambie entre evaluaciones consecutivas de la regla de alerta, ya que esto acabará creando un gran número de alertas distintas. Sin embargo, está bien que la plantilla produzca valores de etiqueta diferentes para alertas diferentes. Por ejemplo, no coloque el valor de la consulta en una etiqueta personalizada, ya que esto acabará creando un nuevo conjunto de alertas cada vez que cambie el valor. En su lugar, utilice anotaciones.

También es importante asegurarse de que la etiqueta configurada para una alerta no tenga dos o más etiquetas con el mismo nombre. Si una etiqueta personalizada tiene el mismo nombre que una etiqueta de la fuente de datos, sustituirá a esa etiqueta. Sin embargo, si una etiqueta personalizada tiene el mismo nombre que una etiqueta reservada, la etiqueta personalizada se omitirá de la alerta.

Annotations

Las anotaciones son pares con nombres que añaden información adicional a las alertas existentes. Hay una serie de anotaciones sugeridas en Grafanasummary, description como,runbook_url, dashboardUId y. panelId Al igual que las etiquetas personalizadas, las anotaciones deben tener un nombre y su valor puede contener una combinación de texto y código de plantilla que se evalúa cuando se activa una alerta. Si una anotación contiene código de plantilla, la plantilla se evalúa una vez cuando se activa la alerta. No se vuelve a evaluar, incluso cuando se resuelve la alerta. La documentación sobre cómo crear plantillas para las anotaciones se encuentra aquí.