- 表:这是最简单的查询类型,用于以表格形式显示数据。无论是简单查询还是包含聚合函数的复杂查询,都适合作为通用选择。
- 日志:针对构建日志查询进行了优化。在 Explore 视图中,并配合已配置默认值 使用时效果最佳。
- 时间序列:最适合用于构建时间序列查询。支持选择专用时间列并添加聚合函数。
- 链路追踪:针对搜索和查看链路追踪进行了优化。在 Explore 视图中,并配合已配置默认值 使用时效果最佳。
- SQL Editor:当你需要完全控制查询时,可以使用 SQL Editor。在此模式下,可以执行任何 SQL 查询。
表
最灵活的查询类型是表查询。它是一种通用查询类型,涵盖了其他用于处理简单查询和聚合查询的查询构建器。
日志
日志查询类型提供了一个专门用于查询日志数据的查询构建器。 可以在数据源的日志配置中设置默认值,以便查询构建器预加载默认的数据库/表和列。 还可以启用 OpenTelemetry,以根据 schema 版本自动选择列。 默认会添加 Time 和 Level 过滤器,以及基于 Time 列的 Order By。 这些过滤器与各自的字段相关联,并会随着列的变化而更新。 Level 过滤器默认不会包含在 SQL 中,只有将其从IS ANYTHING 选项改为其他值后才会启用。
日志查询类型支持数据链接。

此查询类型会将数据显示在日志面板中,并在顶部附带一个日志直方图面板。 查询中选取的额外列可在展开的日志行中查看:

- 专门的 Time 字段。
- 在 Aggregate mode 下,会自动应用时间间隔宏,并对 Time 字段执行 Group By。
- 在 Aggregate mode 下,“列”字段会被隐藏。
- 会自动为 Time 字段添加时间范围过滤器和 Order By。

IS ANYTHING 选项改为其他值时才会启用。
链路追踪查询类型支持数据链接。


数据链接
Grafana 的 数据链接 可用于跳转到新的查询。 ClickHouse 插件已启用此功能,可在 trace 和日志之间相互跳转。如果在数据源配置中同时为日志和链路追踪配置了 OpenTelemetry,则效果最佳。表中 trace 链接示例

日志中 trace 链接示例

如何创建数据链接
你可以通过在查询中选择一个名为traceID 的列来创建数据链接。该名称不区分大小写,也支持在 “ID” 前添加下划线。例如:traceId、TraceId、TRACE_ID 和 tracE_iD 都是有效的。
如果在日志或trace查询中启用了 OpenTelemetry,则会自动包含一个 trace ID 列。
存在 trace ID 列时,插件可以在数据中添加“View Trace”和“View Logs”链接。
这些开关默认启用。当前查询类型的链接无需配置默认值;跨信号链接仅会在数据源为目标信号配置了默认值时显示。你可以在数据源的 trace 和日志配置部分中,使用 Show “View trace” links 和 Show “View logs” links 开关隐藏这些链接。
配置了数据链接后,你可以使用提供的 trace ID 打开 trace 和日志。
“View Trace”会在分栏面板中打开该 trace,“View Logs”则会打开一个按 trace ID 过滤的日志查询。
如果该链接是从仪表板而不是 Explore 视图中点击的,则会在 Explore 视图的新标签页中打开。
跨查询类型跳转时 (日志到链路追踪,以及链路追踪到日志) ,必须同时为 logs 和 链路追踪 配置默认值。打开相同查询类型的链接时则不需要默认值,因为可以直接复制该查询。
从日志查询 (左侧面板) 查看 trace (右侧面板) 的示例
宏是一种为查询添加动态 SQL 的简便方式。
在查询发送到 ClickHouse server 之前,插件会先展开宏,并将其替换为完整的表达式。
SQL Editor 和 Query Builder 中的查询都可以使用宏。
宏可在查询中的任意位置使用,必要时可多次使用。
下面是使用 
$__timeFilter 宏的示例:
输入:
log_time 列。
该插件还支持使用花括号 {} 的记法。当需要在参数中嵌入查询时,请使用这种记法。
以下是插件中所有可用宏的列表: