Consultas grabadas

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 ver los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte. Trabajando en Grafana versión 10

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

Puede ver las tendencias a lo largo del tiempo tomando una instantánea de un punto de datos en un intervalo establecido mediante consultas grabadas. Esto puede darte una idea de las tendencias históricas.

Para los complementos que no devuelven series temporales, puede ser útil trazar datos históricos. Por ejemplo, es posible que desees consultar ServiceNowun historial de los tiempos de respuesta de las solicitudes, pero que solo devuelva point-in-time las métricas actuales.

Cómo funcionan las consultas grabadas

Las consultas grabadas solo funcionan con los complementos de fuentes de datos de fondo. Para obtener más información, consulta el complemento de fuente de datos de backend. Puedes grabar tres tipos de consultas:

• fila y columna únicas: consulta que devuelve una sola fila y columna.

• recuento de filas: consulta que devuelve filas significativas para ser contadas.

• expresión: cualquier expresión. Para obtener más información sobre la creación y el uso de expresiones, consulte Expresiones.

Una vez creada o habilitada una consulta grabada, crea inmediatamente una instantánea y continúa creando instantáneas en el intervalo establecido. La consulta grabada deja de tomar instantáneas cuando se deshabilita, se elimina o cuando Grafana no se está ejecutando. Los puntos de datos se recopilan en el backend ejecutando la consulta grabada y reenviando cada resultado a una instancia de Prometheus con capacidad de escritura remota.

nota

Debe configurar una fuente de datos de Prometheus y asociarla a un destino de escritura remota antes de poder utilizar las consultas grabadas.

Cree una consulta grabada

Para crear una consulta grabada, siga estos pasos:

1. Busque o cree una consulta que desee registrar en un panel de control en un panel de edición. La consulta solo debe devolver una fila y una columna. Si devuelve más, puede seguir registrando el número de resultados devueltos mediante la opción de recuento. La fuente de datos de la consulta debe ser una fuente de datos secundaria. Las expresiones se pueden usar para agregar datos de una consulta de series temporales. Para obtener más información sobre la creación y el uso de expresiones, consulte Expresiones.

2. Elija el menú de consulta de registros ubicado en el editor de consultas.

3. Introduzca la información de la consulta grabada. Todos los campos son obligatorios a menos que se indique lo contrario.

   • Nombre: nombre de la consulta grabada.

   • Descripción: (opcional) Describa la consulta grabada tal como desea que aparezca en la lista de consultas grabadas.

   • Intervalo: intervalo en el que se tomará la instantánea. El intervalo comienza cuando se crea la consulta grabada y se detiene si se detiene o se elimina la consulta grabada. Para obtener más información sobre cómo pausar y eliminar las consultas grabadas, consulte Administración de consultas grabadas.

   • Intervalo: el intervalo de tiempo relativo de la consulta. Si selecciona un rango de 30 m y un intervalo de 1 hora, la consulta tomará una instantánea cada hora de los últimos 30 minutos.

   • Contar los resultados de la consulta: si quieres contar las filas devueltas por la consulta, activa esta opción. Si esta opción está desactivada, la consulta debe devolver una fila con un valor.

4. Pruebe la consulta grabada pulsando el botón Probar consulta grabada.

5. Selecciona Empezar a grabar la consulta.

Añadir una consulta grabada

Puede añadir las consultas grabadas existentes a los paneles de un panel de control. Para cada consulta grabada que agregue, se crea una consulta de Prometheus:. generated_recorded_query_name{id="generated_id", name="recorded query name"} La consulta creada por Prometheus devuelve todas las instantáneas recopiladas de la consulta grabada.

1. Navegue hasta el panel del panel de control en el que desee añadir una consulta grabada.

2. Seleccione el menú + Consulta grabada.

3. Si desea filtrar las consultas grabadas por fuente de datos, seleccione una fuente de datos en el menú desplegable Filtrar por fuente de datos.

4. Seleccione el menú Añadir en la consulta grabada para añadirla al panel.

Tras añadir la consulta grabada al panel, se convertirá en la fuente de datos del panel-- Mixed --. La consulta grabada se representa mediante una Prometheus consulta con una etiqueta de nombre que coincide con el nombre de la consulta grabada. Consulte Prometheus para obtener más información sobre la fuente de datos de Prometheus.

Si después de añadir una consulta grabada, aparece una consulta con una fuente de -- Mixed -- datos en lugar de una fuente de datos de Prometheus, esto podría significar que no se configuró Prometheus un destino de escritura remoto para las consultas grabadas. Consulte Destino de escritura remoto para configurar un punto de escritura remoto.

Uso de una consulta grabada

Para usar una consulta grabada, cree una y agréguela a un panel. Después de eso, se puede administrar en las Preferencias desde la pestaña Consultas grabadas.

Gestión de consultas grabadas

Las consultas grabadas se pueden pausar o activar y eliminar desde la pestaña Consultas grabadas de las Preferencias. Al eliminar una consulta grabada, se eliminará de Grafana, pero la información recopilada en Prometheus seguirá ahí. Al pausar una consulta grabada, ya no se recopilarán nuevos puntos de datos hasta que se reanude.

Objetivo de escritura remota

El objetivo de escritura remota es la fuente de datos de Prometheus en la que se escriben los puntos de datos de consulta registrados. Necesitará un Prometheus con la escritura remota habilitada y tendrá que crear una fuente de datos para este Prometheus.

Para editar el objetivo de escritura remota, seleccione Editar destino de escritura remota en el menú de la consola, en la pestaña Consultas grabadas de las preferencias. Seleccione la fuente de datos de Prometheus que tenga habilitada la escritura remota e introduzca la ruta de escritura remota.