Consulta y transforma datos - Amazon Managed Grafana

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 9.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 8.x de Grafana, consulte. Trabajando en Grafana versión 8

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.

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, consulte su documentación:

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 Fuentes 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ñade una consulta

Una consulta devuelve datos que Grafana visualiza en los paneles del tablero. Al crear un panel, Grafana selecciona automáticamente la fuente de datos predeterminada.

Para añadir una consulta
  1. Edita el panel al que vas a añadir una consulta.

  2. Elija la pestaña Queries (Consultas).

  3. Selecciona el menú desplegable Fuente de datos y selecciona una fuente de datos.

  4. 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.

  5. Escriba la consulta con el editor de consultas.

  6. 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. Por ejemplo, Loki transmite datos en su modo de seguimiento en directo.

  • 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 raspado. 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, en la esquina superior derecha del panel. 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

    ¿El último año entero

    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.