Anota las visualizaciones

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 anotaciones proporcionan una forma de marcar puntos en una visualización con eventos detallados. Se visualizan como líneas verticales e íconos en todos los paneles de gráficos. Al pasar el ratón sobre una anotación, puedes ver la descripción y las etiquetas del evento. El campo de texto puede incluir enlaces a otros sistemas con más detalle.

Puede anotar las visualizaciones de tres maneras:

• Directamente en el panel, mediante la consulta de anotaciones integrada.

• Uso de la API HTTP de Grafana.

• Configurar las consultas de anotación en la configuración del panel de control.

En los dos primeros casos, se crean nuevas anotaciones, mientras que en el último se consultan las anotaciones existentes de las fuentes de datos. La consulta de anotaciones integrada también lo admite.

En esta sección se explican las opciones primera y tercera; para obtener información sobre el uso de la API HTTP de Grafana, consulte. API de anotaciones

Las anotaciones son compatibles con los siguientes tipos de visualización:

• Serie temporal

• Cronología estatal

• Velas

Crea anotaciones en los paneles

Grafana incluye la posibilidad de añadir eventos de anotación directamente desde un panel mediante la consulta de anotaciones integrada que existe en todos los paneles. Las anotaciones que cree de esta manera se almacenan en Grafana.

Para añadir anotaciones directamente en el panel:

• El panel de control ya debe estar guardado.

• La consulta integrada debe estar habilitada.

Para añadir una anotación

1. En el panel, seleccione el panel al que va a añadir la anotación. Aparecerá un menú contextual.

2. En el menú contextual, selecciona Añadir anotación.

3. (Opcional) Añada una descripción y etiquetas a la anotación.

4. Seleccione Guardar.

Como alternativa, para añadir una anotación, pulse Ctrl (oCmd) mientras selecciona el panel y aparecerá la ventana emergente Añadir anotación.

Anotaciones de región

También puede crear anotaciones que cubran una región o un período de tiempo de una visualización.

Para añadir una anotación de región

1. En el cuadro de mandos, pulse Ctrl (oCmd) mientras selecciona un área del panel.

2. Añada una descripción y etiquetas a la anotación (opcional).

3. Haga clic en Guardar.

Para editar una anotación

1. En el tablero, pase el ratón sobre un indicador de anotación de un panel.

2. Seleccione el icono Editar (lápiz) en la información sobre herramientas de anotación.

3. Modifique la descripción o las etiquetas.

4. Seleccione Guardar.

Para eliminar una anotación

1. En el tablero, pase el ratón sobre un indicador de anotación de un panel.

2. Seleccione el icono Eliminar (papelera) en la descripción emergente de la anotación.

Obtenga anotaciones a través de la configuración del panel

En la configuración del panel, en Anotaciones, puede añadir nuevas consultas para obtener anotaciones utilizando cualquier fuente de datos, incluida la fuente de datos de anotaciones de datos integrada. Las consultas de anotación devuelven eventos que se pueden visualizar como marcadores de eventos en los gráficos del panel de control.

Para añadir una consulta de anotación nueva

1. Seleccione el icono de configuración (engranaje) en el encabezado del panel de control para abrir el menú de configuración.

2. Seleccione Anotaciones.

3. Haga clic en Añadir consulta de anotación.

4. Introduzca un nombre para la consulta de anotación.

   Este nombre se le da al conmutador (casilla de verificación) que le permitirá habilitar la visualización de los eventos de anotación de esta consulta.

5. Seleccione la fuente de datos para las anotaciones.

   También puede elegir Abrir el selector avanzado de fuentes de datos para ver más opciones, incluida la adición de una nueva fuente de datos (disponible solo para administradores).

6. Si no desea utilizar la consulta de anotación de inmediato, desactive la casilla Activado.

7. Si no desea que el conmutador de consulta de anotaciones se muestre en el panel de control, active la casilla Oculto.

8. Seleccione un color para los marcadores de eventos.

9. En el menú desplegable Mostrar en, elige una de las siguientes opciones:

   • Todos los paneles: las anotaciones se muestran en todos los paneles que admiten anotaciones.

   • Paneles seleccionados: las anotaciones se muestran en todos los paneles que seleccione.

   • Todos los paneles excepto: las anotaciones se muestran en todos los paneles excepto en los que seleccione.

10. Configure la consulta.

    Las opciones de consulta de anotaciones son diferentes para cada fuente de datos. Para obtener información sobre las anotaciones de una fuente de datos específica, consulte. Conexión con orígenes de datos

Consulta integrada

Después de añadir una anotación, seguirán siendo visibles. Esto se debe a la consulta de anotaciones integrada que existe en todos los paneles. Esta consulta de anotación buscará todos los eventos de anotación que se originan en el panel actual, que están almacenados en Grafana, y los mostrará en el panel en el que se crearon. Esto incluye las anotaciones del historial del estado de las alertas.

De forma predeterminada, la consulta de anotaciones integrada utiliza la fuente de datos Grafana especial, y las anotaciones manuales solo se admiten con esta fuente de datos. Puede usar otra fuente de datos en la consulta de anotación integrada, pero solo podrá crear anotaciones automatizadas con el editor de consultas de esa fuente de datos.

Para añadir anotaciones directamente al panel de control, esta consulta debe estar habilitada.

Para confirmar que la consulta integrada está habilitada

1. Seleccione el icono de configuración del panel (engranaje) en el encabezado del panel para abrir el menú de configuración del panel.

2. Seleccione Anotaciones.

3. Busque la consulta de anotaciones y alertas (integrada).

   Si aparece Desactivado antes del nombre de la consulta, tendrás que seleccionar el nombre de la consulta para abrirla y actualizar la configuración.

Para evitar que las anotaciones se busquen y dibujen

1. Seleccione el icono de configuración del cuadro de mando (engranaje) en el encabezado del cuadro de mando para abrir el menú de ajustes del cuadro de mando.

2. Seleccione Anotaciones.

3. Seleccione la consulta de anotaciones y alertas (integrada).

4. Selecciona el botón Activado para desactivarla.

Al copiar un panel mediante la función Guardar como, obtendrá un nuevo identificador de panel, por lo que las anotaciones creadas en el panel de origen ya no estarán visibles en la copia. Puedes seguir mostrándolas si añades una nueva consulta de anotación y las filtras por etiquetas. Sin embargo, esto solo funciona si las anotaciones del panel de origen tenían etiquetas por las que filtrar.

Filtrar las consultas por etiqueta

Puede crear consultas nuevas para obtener anotaciones de la consulta de anotación integrada mediante la fuente de Grafana datos configurando Filtrar por en. Tags

Por ejemplo, cree un nombre de consulta de anotación outages y especifique una etiqueta. outage Esta consulta mostrará todas las anotaciones (desde cualquier panel o mediante la API) que contengan la outage etiqueta. Si se definen varias etiquetas en una consulta de anotación, Grafana solo mostrará las anotaciones que coincidan con todas las etiquetas. Para modificar el comportamiento, habilita Hacer coincidir cualquier etiqueta y Grafana mostrará las anotaciones que contengan cualquiera de las etiquetas que hayas proporcionado.

También puedes usar variables de plantilla en la consulta de etiquetas. Esto significa que si tienes un panel que muestra las estadísticas de los distintos servicios y una variable de plantilla que indica qué servicios mostrar, puedes usar la misma variable de plantilla en la consulta de anotaciones para mostrar solo las anotaciones de esos servicios.