Cualquier consulta puede ejecutarse con el plugin de ClickHouse.
El constructor de consultas es una opción práctica para las consultas más simples, pero para las más complejas tendrás que usar el SQL Editor.
Todas las consultas del constructor de consultas tienen un tipo de consulta y requieren seleccionar al menos una columna.
Los tipos de consulta disponibles son:
- Tabla: el tipo de consulta más sencillo para mostrar datos en formato de tabla. Funciona bien como opción general tanto para consultas simples como para consultas complejas que incluyen funciones de agregación.
- Logs: optimizado para crear consultas de logs. Funciona mejor en la vista Explore con los valores predeterminados configurados.
- Series temporales: ideal para crear consultas de series temporales. Permite seleccionar una columna de tiempo específica y añadir funciones de agregación.
- Trazas: optimizado para buscar y visualizar trazas. Funciona mejor en la vista Explore con los valores predeterminados configurados.
- SQL Editor: el SQL Editor puede usarse cuando necesitas un control total sobre la consulta. En este modo, se puede ejecutar cualquier consulta SQL.
La configuración Tipo de consulta cambiará el diseño del constructor de consultas para ajustarlo al tipo de consulta que se esté creando.
El tipo de consulta también determina qué panel se utiliza al visualizar los datos.
El tipo de consulta más flexible es la consulta de tabla. Sirve como opción general para los demás constructores de consultas, diseñados para manejar consultas simples y de agregación.
Este tipo de consulta mostrará los datos en forma de tabla.
El tipo de consulta de logs ofrece un constructor de consultas centrado en consultar datos de logs.
Los valores predeterminados pueden configurarse en la configuración de logs de la fuente de datos para que el constructor de consultas se cargue previamente con una base de datos/tabla y columnas predeterminadas.
OpenTelemetry también puede habilitarse para seleccionar automáticamente las columnas según una versión del esquema.
Los filtros de Tiempo y Nivel se agregan de forma predeterminada, junto con un ORDER BY para la columna Tiempo.
Estos filtros están vinculados a sus respectivos campos y se actualizarán a medida que cambien las columnas.
El filtro de Nivel se excluye del SQL de forma predeterminada; al cambiarlo desde la opción IS ANYTHING, se habilitará.
El tipo de consulta de logs admite enlaces de datos.
Este tipo de consulta mostrará los datos en el panel de logs, junto con un panel de histograma de logs en la parte superior.
Las columnas adicionales seleccionadas en la consulta pueden verse en la fila de log expandida:
El tipo de consulta de series temporales es similar a tabla, pero se centra en datos de series temporales.
Ambas vistas son prácticamente iguales, con estas diferencias principales:
- Un campo Time específico.
- En Aggregate mode, se aplica automáticamente una macro de intervalo de tiempo junto con un Group By para el campo Time.
- En Aggregate mode, el campo “Columns” se oculta.
- Se añaden automáticamente un filtro de rango temporal y Order By para el campo Time.
¿Faltan datos en tu visualización?En algunos casos, el panel de series temporales puede parecer recortado porque el límite predeterminado es 1000.Prueba a eliminar la cláusula LIMIT estableciéndola en 0 (si tu conjunto de datos lo permite).
IS ANYTHING, se habilitará.
El tipo de consulta de trazas admite enlaces de datos.
Este tipo de consulta mostrará los datos con la vista de tabla para el modo Búsqueda de trazas y con el panel de trazas para el modo Trace ID.
Para las consultas que sean demasiado complejas para el constructor de consultas, puede usar el SQL Editor.
Esto le da control total sobre la consulta, ya que le permite escribir y ejecutar ClickHouse SQL directamente.
El SQL Editor se puede abrir seleccionando “SQL Editor” en la parte superior del editor de consultas.
Las funciones macro también se pueden usar en este modo.
Puede cambiar entre tipos de consulta para obtener la visualización que mejor se adapte a su consulta.
Este cambio también surte efecto en la vista de dashboard, especialmente con datos de series temporales.
Los enlaces de datos
de Grafana pueden usarse para enlazar con nuevas consultas.
Esta función se ha habilitado en el plugin de ClickHouse para enlazar una traza con los logs y viceversa. Funciona mejor con OpenTelemetry configurado tanto para logs como para trazas en la configuración de la fuente de datos
Ejemplo de enlaces de trazas en una tabla
Ejemplo de enlaces de trazas en logs
Cómo crear un enlace de datos
traceID en tu consulta. Este nombre no distingue entre mayúsculas y minúsculas y admite añadir un guion bajo antes de “ID”. Por ejemplo, traceId, TraceId, TRACE_ID y tracE_iD serían válidos.
Si OpenTelemetry está habilitado en una consulta de logs o traza, se incluirá automáticamente una columna de ID de traza.
Al incluir una columna de ID de traza, los enlaces “Ver traza” y “Ver logs” se añadirán a los datos.
Con los enlaces de datos disponibles, puedes abrir trazas y logs con el ID de traza proporcionado.
“View Trace” abrirá un panel dividido con la traza, y “View Logs” abrirá una consulta de logs filtrada por el ID de traza.
Si se hace clic en el enlace desde un dashboard en lugar de la vista Explore, el enlace se abrirá en una pestaña nueva de la vista Explore.
Es necesario tener valores predeterminados configurados tanto para logs como para traces al cambiar entre tipos de consulta (de logs a trazas y de trazas a logs). Los valores predeterminados no son necesarios al abrir un enlace del mismo tipo de consulta, ya que basta con copiar la consulta.
Ejemplo de visualización de una traza (panel derecho) desde una consulta de logs (panel izquierdo)
Las macros son una forma sencilla de añadir SQL dinámico a la consulta.
Antes de que una consulta se envíe al servidor de ClickHouse, el plugin expandirá la macro y la sustituirá por la expresión completa.
Las consultas tanto del SQL Editor como del constructor de consultas pueden usar macros.
Las macros pueden incluirse en cualquier parte de la consulta, varias veces si es necesario.
A continuación se muestra un ejemplo de uso de la macro $__timeFilter:
Entrada:
Resultado final de la consulta:
En este ejemplo, el intervalo de tiempo del dashboard de Grafana se aplica a la columna log_time.
El plugin también admite la notación con llaves {}. Use esta notación cuando se necesiten consultas dentro de los parámetros.
Esta es una lista de todas las macros disponibles en el plugin:
