用于 Grafana 的 Hydrolix 数据源

Hydrolix 数据源插件将 Hydrolix 与 Grafana 集成，实现 Hydrolix 数据的无缝查询、分析和可视化。

安装插件

要安装 Hydrolix 数据源插件

1. 打开 Grafana 插件目录。
2. 搜索 Hydrolix 数据源。
3. 选择插件并单击安装插件。

安装后

1. 在 Grafana 中，导航到连接 > 数据源 > 添加新数据源。
2. 从列表中选择 Hydrolix。

有关安装的更多详细信息，请参阅 Grafana 的插件管理文档。

配置数据源

您可以直接在 Grafana 中或通过配置文件配置 Hydrolix 数据源。

以下是 Hydrolix 配置选项列表

配置数据源

要使用 Grafana 的 Provisioning 系统配置 Hydrolix 数据源，请在 YAML 配置文件中进行定义。

以下是一些配置示例。

使用 HTTPS 协议

apiVersion: 1
datasources:
  - name: "Hydrolix"
    type: "hydrolix-hydrolix-datasource"
    jsonData:
      host: localhost
      port: 443
      protocol: http
      secure: true
      username: username
      path: /query
    secureJsonData:
      password: password

使用原生协议

apiVersion: 1
datasources:
  - name: "Hydrolix"
    type: "hydrolix-hydrolix-datasource"
    jsonData:
      host: localhost
      port: 9440
      protocol: native
      secure: true
      username: username
    secureJsonData:
      password: password

使用包含默认值和即席过滤器的 HTTPS 协议

apiVersion: 1
datasources:
  - name: "Hydrolix"
    type: "hydrolix-hydrolix-datasource"
    jsonData:
      host: localhost
      port: 443
      protocol: http
      secure: true
      username: username
      path: /query
      defaultDatabase: database
      defaultRound: 60s
      adHocTableVariable: table
      adHocTimeColumnVariable: timeColumn
      adHocKeysQuery: DESCRIBE $${table}
      adHocValuesQuery: >
        SELECT $${column}, COUNT(*) as count FROM $${table}
        WHERE $$__timeFilter($${timeColumn}) AND $$__adHocFilter()
        GROUP BY $${column}
        ORDER BY count DESC
        LIMIT 100
    secureJsonData:
      password: password

有关 Provisioning 的更多详细信息，请参阅 Grafana 的Provisioning 文档。

查询数据源

Grafana 中的查询编辑器通过宏和模板提供了强大的 SQL 查询能力以及便捷的语法增强功能。

SQL 查询编辑器

该编辑器提供了广泛的 SQL 功能，包括

• 数据库、表、列和 SQL 语法的智能自动补全。
• 支持模板变量和宏。
• 代码格式化。

键盘快捷键

• Cmd/Ctrl + Return – 运行查询。

宏

为了简化语法并允许动态部分（如日期范围过滤器），查询可以包含宏。

以下是使用 $__timeFilter 宏的查询示例

SELECT $__timeInterval(log_time) AS time, avg(cpu_usage) AS value
FROM logs
WHERE $__timeFilter(log_time)
GROUP BY time
ORDER BY time

即席过滤器

即席过滤器允许灵活的键值过滤，可以动态地应用于跨查询。这些过滤器通过 $__adHocFilter 宏注入到查询中，并且必须明确包含在 WHERE 子句中

SELECT $__timeInterval(log_time) AS time, avg(cpu_usage) AS value
FROM logs
WHERE $__timeFilter(log_time) AND $__adHocFilter()
GROUP BY time
ORDER BY time

该插件确保仅在对选定的表有效时应用过滤器。

配置即席过滤器

要启用即席过滤器，数据源和仪表盘都必须正确配置

1. 在数据源设置中（在高级设置下）

   • 即席过滤表变量名称：定义用于检索过滤器键和值的表的仪表盘变量名称。
   • 即席过滤时间列变量名称：定义在值查询中用于时间过滤的列的仪表盘变量名称。
   • 即席过滤键查询：用于列出可能键的查询模板。
   • 即席过滤值查询：用于列出可能值的查询模板。
   • 即席过滤默认时间范围：当仪表盘时间范围不可用时使用的默认时间范围。

2. 在目标仪表盘中，使用数据源设置中定义的精确名称创建两个变量

   • 一个用于表名的变量。
   • 一个用于时间列的变量。

注意：除非数据源和仪表盘都配置正确，否则即席过滤器将不起作用。务必精确匹配变量名称。

查询模板

这些模板用于动态生成可用于过滤的键和值列表。

键查询

DESCRIBE ${table}

值查询

SELECT ${column}, COUNT(${column}) AS count
FROM ${table}
WHERE $__timeFilter(${timeColumn}) AND $__adHocFilter()
GROUP BY ${column}
ORDER BY count DESC
LIMIT 100

在查询模板中，某些占位符会在运行时动态替换为实际值。以下是每个变量的含义

有关即席过滤器的更多详细信息，请参阅 Grafana 的即席过滤器文档。

舍入时间戳

为了控制时间范围的对齐方式，$from 和 $to 时间戳可以四舍五入到查询编辑器或数据源设置中设置的舍入值的最近倍数。

如果在查询编辑器中设置了舍入值，它将优先使用。如果在查询编辑器中未设置舍入值，则数据源将回退到默认舍入值（如果已配置且非零）。如果两者都未设置，或者查询编辑器中的舍入值明确设置为 0，则不应用舍入，并直接使用原始时间戳。

支持的舍入时间单位有：ms（毫秒）、s（秒）、m（分钟）和 h（小时）。

示例

模板变量

Hydrolix 查询完全支持 Grafana 的模板变量，可以创建动态可重用的仪表盘。

有关模板变量的更多详细信息，请参阅 Grafana 的模板变量文档。