Annotations
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte Uso de la versión 10 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.
Las anotaciones proporcionan una forma de marcar los puntos del gráfico con eventos detallados. Cuando hace una pausa en una anotación, puede ver la descripción y las etiquetas de un evento. El campo de texto puede incluir enlaces a otros sistemas para obtener más detalles.
Anotaciones nativas
Amazon Managed Grafana incluye un almacén de anotaciones nativo y la posibilidad de agregar eventos de anotación directamente desde el panel de gráficos.
Adición de anotaciones
Para agregar una anotación, pulse Ctrl o Cmd y elija dónde quiere agregar la anotación. Para que la anotación se pueda buscar en otros paneles, agréguele etiquetas.
Cómo agregar anotaciones de región
Para crear una anotación para una región, pulse Ctrl o Cmd mientras selecciona la región.
Consulta integrada
Después de agregar una anotación, esta permanece visible. Esto se debe a que existe una consulta de anotación integrada en todos los paneles. Esta consulta de anotación busca todos los eventos de anotación que se originan en el panel actual y los muestra en el panel en el que se crearon. Esto incluye las anotaciones del historial del estado de las alertas. Para evitar que las anotaciones se busquen y se muestren, seleccione el icono de Configuración del panel (engranaje), elija Anotaciones y, a continuación, modifique la consulta llamada Annotations & Alerts (Built-in).
Al copiar un panel mediante la característica Guardar como, el nuevo panel tiene un nuevo ID de panel, por lo que las anotaciones creadas en el panel de origen no se ven en la copia. Si las anotaciones del panel de origen tienen etiquetas por las que filtrar, puede mostrar las anotaciones en la copia agregando una nueva consulta de anotación y filtrando por las etiquetas.
Consulta por etiqueta
Puede crear nuevas consultas de anotación que obtengan anotaciones del almacén de anotaciones nativo utilizando el origen de datos -- Grafana -- y configurando Filtrar por en Etiquetas. Especifique al menos una etiqueta. Por ejemplo, cree una consulta de anotación con el nombre outages y especifique una etiqueta llamada outage. Esta consulta mostrará todas las anotaciones que cree (desde cualquier panel o mediante una API) que tengan la etiqueta outage.
De forma predeterminada, si agrega varias etiquetas en la consulta de anotaciones, Amazon Managed Grafana mostrará solo las anotaciones que contengan todas las etiquetas que haya proporcionado. Para mostrar las anotaciones que contienen al menos una de las etiquetas que ha proporcionado, active la opción Coincidir con cualquiera.
En Amazon Managed Grafana, es posible utilizar variables de plantilla en la consulta de etiquetas. Por ejemplo, si tiene un panel que muestra las estadísticas de distintos servicios y una variable de plantilla que controla qué servicios mostrar, puede usar la misma variable de plantilla en la consulta de anotaciones para mostrar solo las anotaciones de esos servicios.
Consultas a otros orígenes de datos
Los eventos de anotación se obtienen mediante consultas de anotación. Para agregar una nueva consulta de anotación a un panel, elija el icono de Configuración del panel (engranaje), elija Annotations y, a continuación, elija Nueva.
Especifique un nombre para la consulta de anotaciones. Este nombre se muestra junto a la casilla de verificación para mostrar u ocultar los eventos de anotación de esta consulta. Por ejemplo, es posible que tenga dos consultas de anotación denominadas Deploys y Outages. Puede activar o desactivar las casillas de verificación para especificar qué anotaciones mostrar.
Detalles de consulta de anotaciones
Las opciones de consulta de anotaciones son diferentes para cada origen de datos.
