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.
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 los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte Uso de la versión 10 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.
Los paneles de los espacios de trabajo de Grafana usan consultas para comunicarse con los orígenes de datos a fin de obtener datos para la visualización. Una consulta es una pregunta escrita en el lenguaje de consulta que utiliza el origen de datos. Si la consulta tiene el formato correcto, el origen de datos responde. En las opciones del origen de datos del panel, puede ajustar la frecuencia con la que se envía la consulta al origen de datos y el número de puntos de datos que se recopilan.
Los espacios de trabajo de Grafana admiten hasta 26 consultas por panel.
Editores de consultas
Los editores de consultas son formularios que lo ayudan a escribir consultas. Según el origen de datos, el editor de consultas puede proporcionar finalización automática, nombres de métricas o sugerencias de variables.
Debido a las diferencias entre los lenguajes de consulta, los orígenes de datos pueden tener editores de consultas con aspectos diferentes.
Sintaxis de la consulta
Los orígenes de datos utilizan diferentes lenguajes de consulta y sintaxis para solicitar los datos. A continuación se muestran dos ejemplos de consultas.
PostgreSQL
SELECT hostname FROM host WHERE region IN($region)
PromQL
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Para obtener más información sobre cómo escribir una consulta para el origen de datos, consulte la documentación de ese origen de datos. Los orígenes de datos se enumeran en Conexión con orígenes de datos.
Interfaz de usuario de la pestaña Consulta
La pestaña Consulta consta de los siguientes elementos:
-
Selector de orígenes de datos
-
Opciones de consulta
-
Botón del inspector de consultas
-
Lista de editores de consultas
Selector de orígenes de datos
El selector de orígenes de datos es una lista desplegable. Elíjalo para seleccionar un origen de datos que haya agregado. Al crear un panel, Amazon Managed Grafana selecciona automáticamente el origen de datos predeterminado. Para obtener más información sobre orígenes de datos, consulte Conexión con orígenes de datos.
Además de los orígenes de datos que ha configurado en su espacio de trabajo de Grafana, hay disponibles tres orígenes de datos especiales.
-
TestDataDB: una fuente de datos integrada que genera datos de recorridos aleatorios. El origen de datos de Grafana resulta útil para probar visualizaciones y hacer experimentos.
-
Mixto: un origen de datos para consultar varios orígenes de datos en el mismo panel. Cuando se selecciona este origen de datos, puede elegir un origen de datos para cada nueva consulta que agregue.
-
La primera consulta utilizará el origen de datos que se seleccionó antes de seleccionar Mixto.
-
No puede cambiar una consulta existente para usar un origen de datos mixto.
-
-
Panel: origen de datos para usar un conjunto de resultados de otro panel del mismo panel.
Opciones de consulta
Para ver la configuración del origen de datos seleccionado, elija Opciones de consulta junto al selector de orígenes de datos. Los cambios que haga aquí solo afectarán a las consultas ejecutadas en este panel.
Amazon Managed 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.
Puede utilizar las siguientes opciones de consulta de orígenes de datos del panel:
-
Máximo de puntos de datos: si el origen de datos lo admite, 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 máximo de puntos de datos, el origen de datos los consolida (reduce el número de puntos devueltos al agregarlos por promedio, por máximo o por otra función).
Existen dos motivos principales para limitar el número de puntos: el rendimiento y la suavización de la línea. El valor predeterminado es el ancho (o el número de píxeles) del gráfico, lo que evita tener más puntos de datos de los que puede mostrar el panel del gráfico.
Con los datos de transmisión, se utiliza el valor de 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 es una forma de dividir 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 extracción. Si se guarda un punto de datos cada 15 segundos, no será necesario tener un intervalo inferior a ese. Otro caso de uso implica establecerlo en un intervalo mínimo superior al intervalo de extracción para recuperar consultas más imprecisas y que funcionen bien.
-
Intervalo: intervalo de tiempo que puede utilizar para agregar o agrupar puntos de datos por tiempo.
Amazon Managed Grafana calcula automáticamente un intervalo apropiado que puede usar como variable en las consultas con plantillas. La variable se mide en segundos (
$__interval) o milisegundos ($__interval_ms). Por lo general, se usa en funciones de agregación comosumoaverage. 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. Si el usuario se aleja mucho, el intervalo se vuelve mayor, lo que da como resultado una agregación más imprecisa. Si el usuario se acerca, 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: anule el intervalo de tiempo relativo de los paneles individuales, lo que hace que sean diferentes de lo que está seleccionado en el selector de tiempo del panel, en la esquina superior derecha. Le permite mostrar métricas de diferentes periodos de tiempo o días en el mismo panel.
-
Cambio de tiempo: proporciona otra forma de anular el intervalo de tiempo de los paneles individuales. Esta función solo sirve para intervalos de tiempo relativos; puede ajustar el intervalo de tiempo.
Por ejemplo, puede cambiar el intervalo de tiempo del panel para que sea 2 horas antes que el selector de tiempo del panel. Para obtener más información, consulte Controles de intervalo de tiempo.
-
Tiempo de espera de la caché: (este campo solo está visible si está disponible en el origen de datos). Anula el tiempo de espera predeterminado de la caché si el almacén de series temporales tiene una caché de consultas. Se especifica como un valor numérico en segundos.
Botón del inspector de consultas
Puede elegir Inspector de consultas para abrir la pestaña Consultas del inspector del panel. En la pestaña Consulta, puede ver la solicitud de consulta que envió el panel y la respuesta correspondiente.
Seleccione Actualizar para ver el texto completo de la solicitud que envió este panel al servidor.
nota
Debe agregar al menos una consulta para que el inspector de consultas pueda devolver los resultados.
Para obtener más información acerca del inspector del panel, consulte Inspección de un panel.
Lista de editores de consultas
En la interfaz de usuario, las consultas se organizan en filas de consultas plegables. Cada fila de consulta contiene un editor de consultas y se identifica con una letra (A, B, C, etc.).
Uso compartido de los resultados de las consultas entre paneles
Con Amazon Managed Grafana, puede usar el resultado de la consulta de un panel para cualquier otro panel del panel. Al compartir los resultados de las consultas en todos los paneles, se reduce la cantidad de consultas que se hacen al origen de datos, lo que puede mejorar el rendimiento del panel.
El origen de datos del panel le permite seleccionar un panel que contenga las consultas con las que desea compartir los resultados. En lugar de enviar una consulta independiente para cada panel, Amazon Managed Grafana envía una consulta y los demás paneles utilizan los resultados de la consulta para crear visualizaciones.
Esta estrategia puede reducir drásticamente la cantidad de consultas que se hacen cuando, por ejemplo, hay varios paneles para visualizar los mismos datos.
Uso compartido de las consultas del origen de datos con otro panel
-
Crear un panel de control. Para obtener más información, consulte Creación de un panel.
-
Agregue un panel. Para obtener más información, consulte Cómo agregar un panel.
-
Cambie el título a
Source panel. Utilizará este panel como origen para los demás paneles. Defina la consulta o consultas que se compartirán. Si por el momento no tiene un origen de datos disponible, puede usar el origen de datos de Grafana, que devuelve una serie temporal aleatoria que puede utilizar para hacer pruebas. -
Agregue un segundo panel y a continuación seleccione el origen de datos del panel en el editor de consultas.
-
En Usar los resultados de la lista de paneles, seleccione el primer panel que haya creado.
Todas las consultas definidas en el panel de origen están ahora disponibles en el nuevo panel. Las consultas hechas en el panel de origen se pueden compartir en varios paneles.
Para ir a un panel en el que se define una consulta, selecciónela.
