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.
# Consultas registradas
****
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 12.x de Grafana, consulte. [Trabajando en Grafana versión 12](using-grafana-v12.md)
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](using-grafana-v10.md).
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](using-grafana-v9.md).
Puede ver las tendencias a lo largo del tiempo tomando una instantánea de un punto de datos en un intervalo establecido mediante consultas registradas. Esto puede darle 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 un historial de los tiempos de respuesta **ServiceNow**a las solicitudes, pero que solo devuelva las métricas puntuales actuales.
## Cómo funcionan las consultas registradas
Las consultas registradas solo funcionan con los complementos de orígenes de datos de backend. Para obtener más información, consulte [Backend data source plugin](https://grafana.com/tutorials/build-a-data-source-backend-plugin/). Puede registrar 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 uso de expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).
Una vez creada o habilitada una consulta registrada, crea inmediatamente una instantánea y continúa creando instantáneas en el intervalo establecido. La consulta registrada 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 registrada y reenviando cada resultado a una instancia de Prometheus con capacidad de escritura remota.
**nota**
Debe configurar un origen de datos de Prometheus y asociarlo a un destino de escritura remota antes de poder utilizar las consultas registradas.
## Creación de una consulta registrada
Para crear una consulta registrada, 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*. El origen de datos de la consulta debe ser un origen de datos de backend. 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 uso de expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).
1. Elija el menú de **consulta de registros** ubicado en el editor de consultas.
1. Ingrese la información de la consulta registrada. Todos los campos son obligatorios a menos que se indique lo contrario.
+ Nombre: nombre de la consulta registrada.
+ Descripción: (opcional) describa la consulta registrada tal como desea que aparezca en la lista de consultas registradas.
+ Intervalo: intervalo en el que se tomará la instantánea. El intervalo comienza cuando se crea la consulta registrada y se detiene si se detiene o se elimina la consulta registrada. Para obtener más información sobre cómo pausar y eliminar las consultas registradas, consulte [Managing recorded queries](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries).
+ Rango: rango de tiempo relativo de la consulta. Si selecciona un rango de 30 minutos 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 quiere contar las filas devueltas por la consulta, active esta opción. Si esta opción está desactivada, la consulta debe devolver una fila con un valor.
1. Pruebe la consulta registrada pulsando el botón Probar consulta registrada.
1. Seleccione **Iniciar consulta registrada**.
## Cómo agregar una consulta registrada
Puede agregar las consultas registradas existentes a los paneles de un panel. Para cada consulta registrada 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 registrada.
1. Navegue hasta el panel en el que desee agregar una consulta registrada.
1. Seleccione el menú **\+ Consulta registrada**.
1. Si desea filtrar las consultas registradas por origen de datos, seleccione un origen de datos en el menú desplegable Filtrar por origen de datos.
1. Seleccione el menú **Agregar** en la consulta registrada para agregarla al panel.
Tras agregar la consulta registrada al panel, el origen de datos del panel se convertirá en `-- Mixed --`. La consulta registrada se representa mediante una consulta `Prometheus` con una etiqueta de nombre que coincide con el nombre de la consulta registrada. Consulte [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) para obtener más información sobre el origen de datos de Prometheus.
Si después de agregar una consulta registrada, aparece una consulta con un origen de datos `-- Mixed --` en lugar de un origen de datos de Prometheus, esto podría significar que no se configuró un destino de escritura remoto de `Prometheus ` para las consultas registradas. Consulte [Remote write target](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) para configurar un punto de escritura remoto.
## Uso de una consulta registrada
Para usar una consulta registrada, cree una y agréguela a un panel. Después de eso, se puede administrar en **Preferencias** desde la pestaña **Consultas registradas**.
## Administración de consultas registradas
Las consultas registradas se pueden pausar o activar y eliminar desde la pestaña Consultas registradas de Preferencias. Al eliminar una consulta registrada, se eliminará de Grafana, pero la información recopilada en Prometheus seguirá ahí. Al pausar una consulta registrada, ya no se recopilarán nuevos puntos de datos hasta que se reanude.
## Objetivo de escritura remota
El objetivo de escritura remota es el origen de datos de **Prometheus** en el que se escriben los puntos de datos de consulta registrados. Necesitará una instancia de Prometheus con la escritura remota habilitada y tendrá que crear un origen de datos para esta instancia de 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 registradas** de **Preferencias**. Seleccione el origen de datos de **Prometheus** que tenga habilitada la escritura remota e ingrese la ruta de escritura remota.