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.

Connect a una fuente de datos PostgreSQL

Puede usar la fuente de datos de PostgreSQL para consultar y visualizar datos de sus bases de datos de PostgreSQL de Amazon Aurora.

Añadir la fuente de datos

Opciones de fuente de datos

Intervalo de tiempo mínimo

Límite inferior para las $_interval $_interval_ms variables. Se recomienda configurar la frecuencia de escritura, por ejemplo, 1m si los datos se escriben cada minuto. Esta opción también se puede anular o configurar en un panel de control, en las opciones de fuentes de datos. Este valor debe tener el formato de un número seguido de un identificador de tiempo válido; por ejemplo, 1m (1 minuto) o 30s (30 segundos). Se admiten los siguientes identificadores de tiempo.

Permisos de usuario de la base

El siguiente código de ejemplo muestra la creación de un usuario de PostgreSQL específico con permisos restringidos.

 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;

Asegúrese de que el usuario no reciba ningún permiso no deseado del rol público.

Editor de consultas

Encontrará el editor de consultas de PostgreSQL en la pestaña de métricas del modo de edición del panel Graph o Singlestat. Para entrar en el modo de edición, elija el título del panel y, a continuación, edite.

El editor de consultas tiene un enlace SQL generado que aparece después de ejecutar una consulta, en el modo de edición de panel. Si lo eliges, se expandirá y mostrará la cadena SQL interpolada sin procesar que se ejecutó.

Seleccione la tabla, la columna de tiempo y la columna de métricas (FROM)

Cuando ingreses al modo de edición por primera vez o agregues una nueva consulta, Grafana intentará rellenar previamente el generador de consultas con la primera tabla que tenga una columna de marca de tiempo y una columna numérica.

En el campo FROM, Grafana sugerirá tablas que estén en la base de datos search_path del usuario. Para seleccionar una tabla o vista que no esté en su lista, search_path puede introducir manualmente un nombre completo (schema.table), como. public.metrics

El campo de la columna Tiempo hace referencia al nombre de la columna que contiene los valores de tiempo. La selección de un valor para el campo de la columna métrica es opcional. Si se selecciona un valor, el campo de la columna métrica se utilizará como nombre de la serie.

Las sugerencias de columnas métricas solo contendrán columnas con un tipo de datos de texto (char, varchar, text). Para usar una columna con un tipo de datos diferente como columna métrica, puede introducir el nombre de la columna con una combinación:. ip::text También puede introducir expresiones SQL arbitrarias en el campo de la columna métrica que den como resultado un tipo de datos de texto, comohostname || ' ' || container_name.

Columnas, ventanas y funciones de agregación (SELECT)

En la SELECT fila, puede especificar qué columnas y funciones desea utilizar. En el campo de columnas, puede escribir expresiones arbitrarias en lugar de un nombre de columna, comocolumn1 * column2 / column3.

Las funciones disponibles en el editor de consultas dependen de la versión de PostgreSQL que haya seleccionado al configurar la fuente de datos. Si utiliza funciones agregadas, debe agrupar el conjunto de resultados. Si agrega una función de agregado, el editor agregará automáticamente unaGROUP BY time.

El editor intenta simplificar y unificar esta parte de la consulta.

Puede añadir más columnas de valores pulsando el botón con el signo más y seleccionando Columna en el menú. Las columnas de valores múltiples se trazarán como series independientes en el panel de gráficos.

Filtrar datos (DÓNDE)

Para añadir un filtro, selecciona el icono con el signo más situado a la derecha de la WHERE condición. Para eliminar los filtros, elija el filtro y seleccione Eliminar. Se añade automáticamente un filtro para el intervalo de tiempo seleccionado actualmente a las consultas nuevas.

Agrupar por

Para agrupar por hora o por cualquier otra columna, selecciona el icono del signo más al final de la fila AGRUPAR POR. La lista desplegable de sugerencias solo mostrará las columnas de texto de la tabla actualmente seleccionada, pero puede introducir manualmente cualquier columna. Para eliminar el grupo, selecciona el elemento y, a continuación, selecciona Eliminar.

Si agrega alguna agrupación, todas las columnas seleccionadas deben tener aplicada una función de agregado. El generador de consultas añadirá automáticamente funciones de agregación a todas las columnas sin funciones de agregación cuando añada agrupaciones.

Relleno de huecos

Grafana gestionada por Amazon puede rellenar los valores que faltan al agrupar por tiempo. La función time acepta dos argumentos. El primer argumento es la ventana de tiempo por la que desea agrupar y el segundo argumento es el valor con el que desea que Grafana llene los elementos que faltan.

Modo editor de texto (RAW)

Puede cambiar al modo editor de consultas sin procesar seleccionando el icono de la hamburguesa y seleccionando Cambiar modo editor o seleccionando Editar SQL debajo de la consulta.

Macros

Las macros se pueden usar dentro de una consulta para simplificar la sintaxis y permitir partes dinámicas.

Consultas de tabla

Si la opción de consulta está establecida en Formatear como tabla, básicamente puede realizar cualquier tipo de consulta SQL. El panel de tablas mostrará automáticamente los resultados de las columnas y filas que devuelva la consulta.

Puede controlar el nombre de las columnas del panel Tabla mediante la sintaxis normal de selección de columnas de as SQL.

Consultas de series temporales

Si establece Formato como, por ejemploTime series, para su uso en un panel de gráficos, la consulta debe devolver una columna con un nombre time que devuelva una fecha y hora de SQL o cualquier tipo de datos numéricos que representen la época de Unix. Cualquier columna excepto time y metric se trata como una columna de valores. Puede devolver un nombre de columna metric que se utilice como nombre de métrica para la columna de valores. Si devuelve varias columnas de valores y una columna con un nombremetric, esta columna se utiliza como prefijo para el nombre de la serie.

Los conjuntos de resultados de las consultas de series temporales se deben ordenar por hora.

El siguiente código de ejemplo muestra una metric columna.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

En el siguiente ejemplo de código, se muestra el uso del parámetro fill de la macro $__TimeGroup para convertir valores nulos en cero en su lugar.

SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time

El siguiente código de ejemplo muestra varias columnas.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

Creación de plantillas

En lugar de codificar elementos como el nombre del servidor, la aplicación y el sensor en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puedes usar estos cuadros desplegables para cambiar los datos que se muestran en tu panel de control.

Para obtener más información sobre las plantillas y las variables de plantilla, consulte. Plantillas

Variable de consulta

Si añade una variable de plantilla de este tipoQuery, puede escribir una consulta de PostgreSQL que devuelva datos como los nombres de las medidas, los nombres de las claves o los valores de las claves que se muestran en un cuadro de selección desplegable.

Por ejemplo, puede tener una variable que contenga todos los valores de la hostname columna de una tabla si especifica una consulta como esta en la configuración de consulta de la variable de plantilla.

SELECT hostname FROM host

Una consulta puede devolver varias columnas y Grafana creará automáticamente una lista a partir de ellas. Por ejemplo, la siguiente consulta devolverá una lista con los valores de hostname yhostname2.

SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city

Para utilizar macros que dependen del intervalo de tiempo, como $__timeFilter(column) en la consulta, el modo de actualización de la variable de plantilla debe estar establecido en Al cambiar el intervalo de tiempo.

SELECT event_name FROM event_log WHERE $__timeFilter(time_column)

Otra opción es una consulta que puede crear una variable clave/valor. La consulta debe devolver dos columnas __text denominadas y. __value El valor de la __text columna debe ser único (si no lo es, se utiliza el primer valor). Las opciones de la lista desplegable tendrán un texto y un valor que te permitirán tener un nombre descriptivo como texto y un identificador como valor. Un ejemplo de consulta con hostname como texto y id como valor:

SELECT hostname AS __text, id AS __value FROM host

También puede crear variables anidadas. Si utiliza una variable denominadaregion, puede hacer que la variable hosts muestre solo los hosts de la región seleccionada actualmente. En el siguiente ejemplo de código se muestra una consulta como esta (si region se trata de una variable con varios valores, utilice el operador de IN comparación en lugar de = compararla con varios valores).

SELECT hostname FROM host  WHERE region IN($region)

Se utiliza __searchFilter para filtrar los resultados en la variable de consulta

Si se utiliza __searchFilter en el campo de consulta, se filtrará el resultado de la consulta en función de lo que escriba el usuario en el cuadro de selección desplegable. Si el usuario no ha introducido nada, el valor predeterminado __searchFilter es%.

El siguiente ejemplo muestra cómo usarlo __searchFilter como parte del campo de consulta para permitir la búsqueda hostname mientras el usuario escribe en el cuadro de selección desplegable.

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

Uso de variables en las consultas

Los valores de las variables de plantilla solo se citan cuando la variable de plantilla es amulti-value.

Si la variable es una variable con varios valores, utilice el operador de IN comparación en lugar de = compararla con varios valores.

Hay dos sintaxis:

$<varname>Ejemplo con una variable de plantilla llamadahostname:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

[[varname]]Ejemplo con una variable de plantilla llamadahostname:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC

Desactivar las comillas para variables con varios valores

Grafana gestionada por Amazon crea automáticamente una cadena entrecomillada y separada por comas para variables con varios valores. Por ejemplo: si server02 se selecciona server01 y, se formateará como:. 'server01', 'server02' Para desactivar las comillas, use la opción de formato csv para las variables.

${servers:csv}

Para obtener más información sobre las opciones de formato variable, consultePlantillas y variables.

Annotations

Utilice las anotaciones para superponer información detallada sobre los eventos en la parte superior de los gráficos. Las consultas de anotación se añaden a través del menú del panel de control o la vista de anotaciones. Para obtener más información, consulte Annotations.

El siguiente código de ejemplo muestra una consulta que utiliza una columna de tiempo con valores de época.

SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

El siguiente código de ejemplo muestra una consulta de región que utiliza columnas de hora y fin de tiempo con valores de época.

SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

El siguiente código de ejemplo muestra una consulta que utiliza una columna de tiempo del tipo de datos de fecha y hora nativo de SQL.

SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

Alertas

Las consultas de series temporales deberían funcionar en condiciones de alerta. Las consultas con formato de tabla aún no se admiten en las condiciones de las reglas de alerta.