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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte Uso de la versión 9 de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte Uso de la versión 8 de Grafana.
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 agregar información adicional a una alerta existente.
Por ejemplo, pensemos en dos alertas de uso elevado de la CPU: una para server1 y otra para server2. En este ejemplo, podríamos tener una etiqueta denominada server en la que la primera alerta tenga la etiqueta server="server1" y la segunda alerta tenga la etiqueta server="server2". Sin embargo, es posible que también queramos agregar una descripción a cada alerta, como "The CPU usage for server1 is above 75%.", dónde server1 y 75% se sustituyen por el nombre y el uso de la CPU del servidor (consulte la documentación sobre Plantillas de etiquetas y anotaciones para ver 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 ser server=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 el conjunto de etiquetas {alertname="High CPU usage",server="server1"}, mientras que otra alerta puede tener el conjunto de etiquetas {alertname="High CPU usage",server="server2"}. Son dos alertas independientes porque, aunque sus etiquetas alertname son las mismas, las etiquetas server son diferentes.
El conjunto de etiquetas de una alerta es una combinación de las etiquetas del origen 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 etiquetas personalizadas de plantillas se encuentra aquí.
Al utilizar etiquetas personalizadas con las 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, no importa 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 del origen de datos, la sustituirá. Sin embargo, si una etiqueta personalizada tiene el mismo nombre que una etiqueta reservada, la etiqueta personalizada se omitirá en la alerta.
Anotaciones
Las anotaciones son pares con nombres que agregan información adicional a las alertas existentes. Hay una serie de anotaciones sugeridas en Grafana, como description, summary, 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, aunque se resuelva la alerta. La documentación sobre cómo crear anotaciones de plantillas se encuentra aquí.
Temas
