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.
Anotación de 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 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 anotaciones proporcionan una forma de marcar puntos en una visualización con eventos detallados. Se visualizan como líneas verticales e iconos en todos los paneles de gráficos. Cuando pasa el ratón sobre una anotación, puede acceder a la descripción y las etiquetas del evento. El campo de texto puede incluir enlaces a otros sistemas con más detalles.
Puede anotar las visualizaciones de tres formas:
-
Directamente en el panel, mediante la consulta de anotaciones integrada.
-
Mediante la API HTTP de Grafana.
-
Mediante la configuración de 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 los orígenes 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
-
Línea temporal de estado
-
Velas
Creación de anotaciones en paneles
Grafana incluye la posibilidad de agregar eventos de anotaciones 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.
Adición de anotaciones directamente en el panel:
-
El panel de control ya debe estar guardado.
-
Debe habilitarse la consulta integrada.
Adición de una anotación
-
En el panel, seleccione el panel al que va a agregar la anotación. Aparecerá un menú contextual.
-
En el menú contextual, seleccione Agregar anotación.
-
(Opcional) Agregue una descripción y etiquetas de la anotación.
-
Seleccione Guardar.
Como alternativa, para agregar una anotación, pulse Ctrl (o Cmd) mientras selecciona el panel y aparecerá el elemento emergente Agregar anotación.
Anotaciones de región
También puede crear anotaciones que cubran una región o un periodo de una visualización.
Adición de una anotación de región
-
En el panel, pulse
Ctrl(oCmd) mientras selecciona un área del panel. -
Agregue una descripción y etiquetas de la anotación (opcional).
-
Haga clic en Guardar.
Edición de una anotación
-
En el panel de control, pase el ratón sobre un indicador de anotación en un panel.
-
Seleccione el icono Editar (lápiz) en la información sobre herramientas de anotación.
-
Modifique la descripción o las etiquetas.
-
Seleccione Guardar.
Eliminación de una anotación
-
En el panel de control, pase el ratón sobre un indicador de anotación en un panel.
-
Seleccione el icono Eliminar (papelera) en la información sobre herramientas de la anotación.
Obtención de anotaciones a través de la configuración del panel de control
En la configuración del panel de control, en Anotaciones, puede agregar nuevas consultas para obtener anotaciones mediante el uso de cualquier origen de datos, lo que incluye el origen de datos de anotaciones de datos integrada. Las consultas de anotaciones devuelven eventos que se pueden visualizar como marcadores de eventos en los gráficos del panel.
Adición de una consulta de anotaciones
-
Seleccione el icono Configuración (engranaje) en el encabezado del panel para abrir el menú de configuración.
-
Seleccione Anotaciones.
-
Haga clic en Agregar consulta de anotación.
-
Ingrese un nombre para la consulta de anotaciones.
Este nombre se le asigna al conmutador (casilla de verificación) que le permitirá habilitar la visualización de los eventos de anotación de esta consulta.
-
Seleccione el origen de datos para las anotaciones.
También puede elegir Abrir el selector avanzado de orígenes de datos para ver más opciones, incluida la adición de un nuevo origen de datos (disponible solo para administradores).
-
Si no quiere utilizar la consulta de anotación de inmediato, desactive la casilla Habilitado.
-
Si no quiere que el conmutador de consulta de anotaciones se muestre en el panel, seleccione la casilla Oculto.
-
Seleccione un color para los marcadores de eventos.
-
En el menú desplegable Mostrar en, elija 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.
-
-
Configure la consulta.
Las opciones de consulta de anotaciones son diferentes para cada origen de datos. Para obtener información sobre las anotaciones de un origen de datos específico, consulte Conexión con orígenes de datos.
Consulta integrada
Después de agregar una anotación, seguirán siendo visibles. Esto se debe a la consulta de anotación 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 manera predeterminada, la consulta de anotaciones integrada utiliza el origen de datos Grafana especial, y las anotaciones manuales solo se admiten con este origen de datos. Puede utilizar otro origen de datos en la consulta de anotación integrada, pero solo podrá crear anotaciones automatizadas con el editor de consultas de ese origen de datos.
Para agregar anotaciones directamente al panel, esta consulta debe estar habilitada.
Confirmación de que la consulta integrada está habilitada
-
Seleccione el icono de Configuración (engranaje) del panel en el encabezado del panel para abrir el menú de configuración del panel de control.
-
Seleccione Anotaciones.
-
Busque la consulta Anotaciones y alertas (integrada).
Si aparece Deshabilitado antes del nombre de la consulta, tendrá que seleccionar el nombre de la consulta para abrirla y actualizar la configuración.
Para evitar que se busquen y dibujen las anotaciones
-
Seleccione el icono de Configuración (engranaje) del panel en el encabezado del panel para abrir el menú de configuración del panel de control.
-
Seleccione Anotaciones.
-
Seleccione la consulta Anotaciones y alertas (integrada).
-
Seleccione el conmutador Habilitado para desactivarla.
Al copiar un panel mediante la característica Guardar como, obtendrá un nuevo ID de panel de control, por lo que las anotaciones creadas en el panel de origen no se verán en la copia. Puede seguir mostrándolas si agrega una nueva consulta de anotación y las filtra por etiquetas. Sin embargo, esto solo funciona si las anotaciones del panel de origen tienen etiquetas por las que filtrar.
Filtrado de las consultas por etiqueta
Puede crear consultas nuevas para buscar anotaciones a partir de la consulta de anotación integrada con el origen de datos Grafana mediante el establecimiento de Filtrar por en Tags.
Por ejemplo, cree una consulta de anotación con el nombre outages y especifique una etiqueta outage. Esta consulta mostrará todas las anotaciones (desde cualquier panel o mediante la API) que contengan la etiqueta outage. 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, habilite Coincidir con cualquiera y Grafana mostrará las anotaciones que contengan cualquiera de las etiquetas que haya proporcionado.
También puede utilizar variables de plantilla en la consulta de etiquetas. Esto significa que, si tiene un panel que muestra las estadísticas de distintos servicios y una variable de plantilla que dicta qué servicios mostrar, puede utilizar la misma variable de plantilla en la consulta de anotaciones para mostrar solo las anotaciones de esos servicios.
