Connect a una fuente de datos MySQL

Añada la fuente de datos MySQL para poder consultar y visualizar los datos de una base de datos compatible con MySQL.

importante

La versión 8.0 de Grafana cambia la estructura de datos subyacente de los marcos de datos de las fuentes de datos de MySQL, Postgres y Microsoft SQL Server. Como resultado, el resultado de una consulta de series temporales se devuelve en un formato ancho. Para obtener más información, consulte Formato ancho en la documentación de los marcos de datos de Grafana.

Para que las visualizaciones funcionen como lo hacían antes, es posible que tenga que realizar algunas migraciones manuales. Una solución está documentada en Github en Postgres/MySQL/MSSQL: Un cambio radical en la versión 8.0 relacionado con las consultas de series temporales y el orden de las columnas de datos.

Añadir la fuente de datos

1. Abre el menú lateral seleccionando el icono de Grafana en el encabezado superior.

2. En el menú lateral, debajo del enlace de los paneles, encontrarás un enlace denominado Fuentes de datos.

3. Pulse el botón + Añadir fuente de datos en el encabezado superior.

4. Seleccione MySQL en la lista desplegable Tipo.

Opciones de fuente de datos

Nombre	Descripción
Name	El nombre de la fuente de datos. Así es como se ve la fuente de datos en los paneles y las consultas.
Default	La fuente de datos predeterminada significa que se preseleccionará para los nuevos paneles.
Host	La dirección IP/el nombre de host y el puerto opcional de la instancia de MySQL.
Database	Nombre de su base de datos MySQL.
User	Nombre de usuario/nombre de usuario de la base de datos.
Password	Contraseña del usuario de la base de datos.
Max open	El número máximo de conexiones abiertas a la base de datos, predeterminado unlimited (Grafana v5.4+).
Max idle	El número máximo de conexiones en el grupo de conexiones inactivas, predeterminado 2 (Grafana v5.4+).
Max lifetime	El tiempo máximo en segundos que se puede reutilizar una conexión; el valor predeterminado es de /4 horas. 14400 Siempre debe ser inferior al wait_timeout configurado en MySQL (Grafana v5.4+).

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.

Identificador	Descripción
y	Año
M	Mes
w	Semana
d	Día
h	Hora
m	Minuto
s	Segundo
ms	Milisegundos

Permisos de usuario de la base

importante

Al usuario de la base de datos que especifique al agregar la fuente de datos solo se le deben conceder los permisos SELECT en la base de datos y las tablas especificadas que desee consultar. Grafana no valida que la consulta sea segura. La consulta puede incluir cualquier sentencia SQL. Por ejemplo, se DROP TABLE user; ejecutarían sentencias como USE otherdb; y. Para protegerse contra esto, le recomendamos encarecidamente que cree un usuario de MySQL específico con permisos restringidos.

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

 CREATE USER 'grafanaReader' IDENTIFIED BY 'password';
 GRANT SELECT ON mydatabase.mytable TO 'grafanaReader';

Para conceder acceso a más bases de datos y tablas, si lo desea, puede utilizar caracteres comodín (*) en lugar de bases de datos o tablas.

Editor de consultas

Encontrará el editor de consultas MySQL en la pestaña de métricas del modo de edición de un panel. Para entrar en el modo de edición, seleccione el título del panel y, a continuación, seleccione Editar.

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 se encuentran en la base de datos configurada. Para seleccionar una tabla o vista de otra base de datos a la que tenga acceso el usuario de la base de datos, puede introducir manualmente un nombre completo (database.table), como. otherDb.metrics

El campo de la columna Hora 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 (text, tinytext, mediumtext, longtext, varchar, char). Si desea utilizar una columna con un tipo de datos diferente como columna métrica, puede introducir el nombre de la columna con una combinación:. CAST(numericColumn as CHAR) 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, comoCONCAT(column1, " ", CAST(numericColumn as CHAR)).

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

Si utiliza funciones de agregación, debe agrupar el conjunto de resultados. El editor añadirá automáticamente una GROUP BY time si añades una función de agregación.

Puede añadir más columnas de valores pulsando el botón con el signo más y Column seleccionándolas 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. Puede eliminar los filtros seleccionándolos y seleccionándolosRemove. 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 con el 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. Puede eliminar el grupo seleccionando el elemento y, a continuación, seleccionándoloRemove.

Si agrega alguna agrupación, todas las columnas seleccionadas deben tener aplicada una función de agregación. 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 puede rellenar los valores faltantes cuando los agrupa por tiempo. La función de tiempo 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 (sin procesar)

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.

nota

Si utilizas el editor de consultas sin procesar, asegúrate de que la consulta tengaORDER BY time, como mínimo, un filtro en función del intervalo de tiempo devuelto.

Macros

Para simplificar la sintaxis y permitir partes dinámicas, como los filtros de intervalo de fechas, la consulta puede contener macros.

Ejemplo de macro	Descripción
$__time(dateColumn)	Se reemplazará por una expresión para convertirla en una marca de tiempo de UNIX y cambiar el nombre de la columna atime_sec; por ejemplo, UNIX_TIMESTAMP (DateColumn) como time_sec.
$__timeEpoch(dateColumn)	Se reemplazará por una expresión para convertirla en una marca de tiempo de UNIX y cambiar el nombre de la columna a; por ejemplo, UNIX_TIMESTAMP (DateColumn) como time_sec. time_sec
$__timeFilter(dateColumn)	Se sustituirá por un filtro de intervalo de tiempo con el nombre de columna especificado. Por ejemplo, DateColumn BETWEEN FROM_UNIXTIME (1494410783) Y FROM_UNIXTIME (1494410983).
$__timeFrom()	Se sustituirá por el inicio de la selección de hora actualmente activa. Por ejemplo, FROM_UNIXTIME (1494410783).
$__timeTo()	Se sustituirá por el final de la selección de tiempo actualmente activa. Por ejemplo, FROM_UNIXTIME (1494410983).
$__timeGroup(dateColumn,'5m')	Se reemplazará por una expresión utilizable en la cláusula GROUP BY. Por ejemplo, cast (cast (UNIX_TIMESTAMP (DateColumn)/(300) as signed) 300 as signed), *
$__timeGroup(dateColumn,'5m', 0)	Igual que en la fila anterior, pero con un parámetro de relleno, por lo que grafana añadirá los puntos que falten en esa serie y usará 0 como valor.
$__timeGroup(dateColumn,'5m', NULL)	Igual que el anterior, pero se usará NULL como valor para los puntos faltantes.
$__timeGroup(dateColumn,'5m', previous)	Igual que el anterior, pero el valor anterior de esa serie se utilizará como valor de relleno si no se ha visto ningún valor, pero se utilizará NULL (solo disponible en Grafana 5.3+).
$__timeGroupAlias(dateColumn,'5m')	Se reemplazará de forma idéntica $__timeGroup pero con un alias de columna agregado (disponible solo en Grafana 5.3+).
$__unixEpochFilter(dateColumn)	Se sustituirá por un filtro de intervalo de tiempo que utilice el nombre de columna especificado y las horas se representarán como una marca de tiempo de Unix. Por ejemplo, dateColumn > 1494410783 AND dateColumn < 1494497183.
$__unixEpochFrom()	Se reemplazará por el inicio de la selección de tiempo actualmente activa como marca de tiempo de Unix. Por ejemplo, 1494410783.
$__unixEpochTo()	Se sustituirá por el final de la selección de tiempo actualmente activa como marca de tiempo de Unix. Por ejemplo, 1494497183.
$__unixEpochNanoFilter(dateColumn)	Se reemplazará por un filtro de intervalo de tiempo con el nombre de columna especificado y los tiempos se representarán como una marca de tiempo de nanosegundos. Por ejemplo, dateColumn > 1494410783152415214 AND dateColumn < 1494497183142514872.
$__unixEpochNanoFrom()	Se sustituirá por el inicio de la selección de tiempo actualmente activa como marca de tiempo de nanosegundos. Por ejemplo, 1494410783152415214.
$__unixEpochNanoTo()	Se sustituirá por el final de la selección de tiempo actualmente activa como marca de tiempo de nanosegundos. Por ejemplo, 1494497183142514872.
$__unixEpochGroup(dateColumn,"5m", [fillmode])	Igual que $__timeGroup pero para las horas almacenadas como marca de tiempo de Unix (disponible solo en Grafana 5.3+).
$__unixEpochGroupAlias(dateColumn,"5m", [fillmode])`	Igual que el anterior, pero también agrega un alias de columna (disponible solo en Grafana 5.3+).

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

Consultas de tabla

Si la opción Formatear como consulta está establecida en 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.

El siguiente código muestra un ejemplo de consulta.

SELECT
  title as 'Title',
  user.login as 'Created By' ,
  dashboard.created as 'Created On'
 FROM dashboard
INNER JOIN user on user.id = dashboard.created_by
WHERE $__timeFilter(dashboard.created)

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 serie temporal, para su uso en un panel de gráficos, por ejemplo, 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 nombremetric, esta columna se utiliza como prefijo para el nombre de la serie (disponible solo en Grafana 5.3+).

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

En el siguiente ejemplo de código se muestra la 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_double) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter(createdAt)
GROUP BY time, measurement
ORDER BY time

El siguiente ejemplo de código 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

No se admite un grupo dinámico por tiempo en función del intervalo de tiempo y el ancho del panel.

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 MySQL que devuelva datos como nombres de medidas, nombres clave o valores clave 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 my_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 my_host.hostname, my_other_host.hostname2 FROM my_host JOIN my_other_host ON my_host.city = my_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 para que pueda tener un nombre descriptivo como texto y un identificador como valor.

El siguiente ejemplo de código muestra una consulta con hostname como texto y id como valor.

SELECT hostname AS __text, id AS __value FROM my_host

También puede crear variables anidadas. Por ejemplo, si tuviera otra variable llamadaregion. A continuación, puede hacer que la variable hosts muestre solo los hosts de la región actualmente seleccionada con una consulta como esta (si region es una variable con varios valores, utilice el operador de IN comparación en lugar de = compararla con varios valores).

SELECT hostname FROM my_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%.

nota

Es importante que rodees la __searchFilter expresión entre comillas, ya que Grafana no lo hace por ti.

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

Desde Grafana 4.3.0 hasta 4.6.0, las variables de plantilla siempre se citan automáticamente, por lo que si se trata de un valor de cadena, no las ponga entre comillas en las cláusulas where.

A partir de Grafana 4.7.0, los valores de las variables de plantilla solo se citan cuando la variable de plantilla es a. multi-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
  UNIX_TIMESTAMP(atimestamp) as time,
  aint as value,
  avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

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

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

Desactivar las comillas para variables con varios valores

Grafana 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, consulteOpciones avanzadas de formato variable.

Annotations

Puede utilizar las anotaciones para superponer información detallada sobre los eventos sobre 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 .

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(tag1, ',', tag2) 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.

nota

Disponible solo en Grafana v6.6+.

SELECT
  epoch_time as time,
  epoch_timeend as timeend,
  metric1 as text,
  CONCAT(tag1, ',', tag2) 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(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

Nombre	Descripción
time	El nombre del campo de fecha y hora. Puede ser una columna con un tipo de datos de fecha y hora nativo de SQL o un valor de época.
timeend	Nombre opcional del campo de fecha y hora de finalización. Puede ser una columna con un tipo de datos de fecha y hora de SQL nativo o un valor de época.
text	Campo de descripción del evento.
tags	Nombre de campo opcional para usar en las etiquetas de eventos como cadena separada por comas.

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.