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.
Consulta y transforma datos
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
Amazon Managed Grafana admite muchos tipos de fuentes de datos. Las consultas a las fuentes de datos devuelven datos que Grafana puede transformar y visualizar. Cada fuente de datos usa su propio lenguaje de consulta, y cada uno de los complementos de fuentes de datos implementa una interfaz de usuario para generar consultas llamada editor de consultas.
Temas
Acerca de las consultas
Los paneles de Grafana se comunican con las fuentes de datos mediante consultas, que recuperan datos para la visualización. Una consulta es una pregunta escrita en el lenguaje de consulta utilizado por la fuente de datos.
Puede configurar la frecuencia de las consultas y los límites de recopilación de datos en las opciones de fuentes de datos del panel. Grafana admite hasta 26 consultas por panel.
Puedes encontrar más información sobre el lenguaje de consulta de cada fuente de datos en la sección Fuentes de datos.
Editores de consultas
El editor de consultas de cada fuente de datos proporciona una interfaz de usuario personalizada que le ayuda a escribir consultas que aprovechen sus capacidades únicas.
Debido a las diferencias entre los lenguajes de consulta, cada editor de consultas de fuentes de datos tiene un aspecto y un funcionamiento diferentes. Según la fuente de datos, el editor de consultas puede proporcionar funciones de autocompletado, nombres de métricas, sugerencias de variables o una interfaz visual de creación de consultas.
Para obtener más información sobre las funciones exclusivas del editor de consultas de una fuente de datos específica, incluida información sobre las consultas y la sintaxis, consulte la documentación de la fuente de datos:
-
Para ver las fuentes de datos incluidas en Amazon Managed Grafana, consulte Fuentes de datos integradas.
-
Para ver las fuentes de datos incluidas en Grafana Enterprise, consulte. Conéctese a fuentes de datos empresariales
-
Para otros complementos de fuentes de datos que se instalan a través deEncuentra complementos con el catálogo de complementos, la documentación está vinculada a la lista del catálogo de complementos.
Sintaxis de la consulta
Las fuentes de datos utilizan diferentes lenguajes de consulta para solicitar datos. Para obtener más información sobre el lenguaje de consulta exclusivo de una fuente de datos específica, consulte su documentación.
Ejemplo de PostgreSQL:
SELECT hostname FROM host WHERE region IN($region)
Ejemplo de ProMQL:
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Fuentes de datos especiales
Grafana también incluye tres fuentes de datos especiales: Grafana, Mixed y Dashboard. Para obtener más información, consulte Conexión con orígenes de datos.
Navegue por la pestaña de consultas
La pestaña de consultas de un panel consta de los siguientes elementos:
-
Selector de fuentes de datos: selecciona la fuente de datos que se va a consultar.
-
Opciones de consulta: establece los parámetros máximos de recuperación de datos y los intervalos de tiempo de ejecución de las consultas.
-
Botón inspector de consultas: abre el panel inspector de consultas, donde puede ver y optimizar la consulta.
-
Lista de editores de consultas: muestra las consultas que ha escrito.
-
Expresiones: utiliza el generador de expresiones para crear expresiones de alerta. Para obtener más información sobre las expresiones, consulte Escribe consultas de expresión.
Añadir una consulta
Una consulta devuelve datos que Grafana visualiza en los paneles del panel de control. Al crear un panel, Grafana selecciona automáticamente la fuente de datos predeterminada.
Para añadir una consulta
-
Edita el panel al que vas a añadir una consulta.
-
Elija la pestaña Queries (Consultas).
-
Selecciona el menú desplegable Fuente de datos y selecciona una fuente de datos.
-
Elija las opciones de consulta para configurar el número máximo de puntos de datos que necesita. Para obtener más información sobre las opciones de consulta, consulteOpciones de consulta.
-
Escriba la consulta con el editor de consultas.
-
Seleccione Apply.
Grafana consulta la fuente de datos y visualiza los datos.
Gestione las consultas
Grafana organiza las consultas en filas de consultas plegables. Cada fila de consulta contiene un editor de consultas y se identifica con una letra (A, B, C, etc.).
Para administrar las consultas, puede copiarlas, ocultarlas, eliminarlas, reordenarlas y activar la ayuda del editor de consultas.
Opciones de consulta
Seleccione las opciones de consulta junto al selector de fuentes de datos para ver la configuración de la fuente de datos seleccionada. Los cambios que realice aquí solo afectarán a las consultas realizadas en este panel.
Grafana establece valores predeterminados que se muestran en texto gris oscuro. Los cambios se muestran en texto blanco. Para devolver un campo a la configuración predeterminada, elimine el texto blanco del campo.
Las opciones de consulta de fuentes de datos del panel incluyen:
-
Puntos de datos máximos: si la fuente de datos lo admite, se establece el número máximo de puntos de datos para cada serie devuelta. Si la consulta devuelve más puntos de datos que la configuración de puntos de datos máximos, la fuente de datos reduce el número de puntos devueltos al agregarlos por promedio, máximo u otra función.
Puede limitar el número de puntos para mejorar el rendimiento de la consulta o suavizar la línea visualizada. El valor predeterminado es el ancho (o el número de píxeles) del gráfico, ya que solo puede visualizar tantos puntos de datos como el espacio disponible en el panel del gráfico.
Con los datos de transmisión, Grafana utiliza el valor máximo de puntos de datos para el búfer móvil. La transmisión es un flujo continuo de datos, y el almacenamiento en búfer divide la transmisión en partes.
-
Intervalo mínimo: establece un límite mínimo para el intervalo que se calcula automáticamente, que suele ser el intervalo mínimo de almacenamiento. Si se guarda un punto de datos cada 15 segundos, no se beneficiará de tener un intervalo inferior a ese intervalo. También puedes establecerlo en un intervalo mínimo superior al intervalo de extracción para recuperar consultas más detalladas y que funcionen bien.
-
Intervalo: establece un intervalo de tiempo que puede utilizar para agregar o agrupar puntos de datos por tiempo.
Grafana calcula automáticamente un intervalo apropiado que puedes usar como variable en las consultas con plantillas. La variable se mide en segundos (
$__interval
) o en milisegundos ($__interval_ms
).Los intervalos se utilizan normalmente en funciones de agregación, como la suma o el promedio. Por ejemplo, esta es una consulta de Prometheus que usa la variable de intervalo:.
rate(http_requests_total[$__interval])
Este intervalo automático se calcula en función del ancho del gráfico. A medida que el usuario se aleja de una visualización, el intervalo aumenta, lo que da como resultado una agregación más gruesa. Del mismo modo, si el usuario amplía la imagen, el intervalo disminuye, lo que da como resultado una agregación más detallada.
Para obtener más información, consulte Variables globales.
-
Tiempo relativo: anula el intervalo de tiempo relativo de los paneles individuales, lo que hace que sean diferentes del seleccionado en el selector de tiempo del panel de control, situado en la esquina superior derecha del cuadro de mando. Puedes usarlo para mostrar métricas de diferentes períodos de tiempo o días en el mismo panel.
nota
Las anulaciones de tiempo del panel no tienen efecto cuando el rango de tiempo del panel es absoluto.
Ejemplo Campo de tiempo relativo Últimos 5 minutos
now-5m
¿El día hasta ahora
now/d
Últimos 5 días
now-5d/d
Esta semana hasta ahora
now/w
Últimos 2 años
now-2y/y
-
Cambio de hora: anula el intervalo de tiempo de los paneles individuales cambiando el inicio y el final en relación con el selector de tiempo. Por ejemplo, puede cambiar el intervalo de tiempo del panel para que esté dos horas antes que el selector de tiempo del panel.
nota
Las anulaciones de tiempo del panel no tienen efecto cuando el rango de tiempo del panel es absoluto.
Ejemplo Campo de cambio de hora La última semana entera
1w/w
Hace dos semanas enteras
2w/w
Último mes entero
1M/M
Todo este año
1d/y
¿Durante todo el año
1y/y
-
Tiempo de espera de la caché: (visible solo si está disponible en la fuente de datos) anula el tiempo de espera de la caché predeterminado si el almacén de series temporales tiene una caché de consultas. Especifique este valor como un valor numérico en segundos.