适用于 Grafana 的 Astra DB 数据源插件

Astra DB 插件允许直接连接到 Astra DB，以便在 Grafana 中查询和可视化数据。

此插件提供了一个 CQL 编辑器，用于格式化和颜色标注您的 CQL 语句，并在输入键空间、表和字段时提供自动补全功能。

测试版

此插件目前处于测试版开发阶段。可能会发生破坏性变更，但预计不会。

安装

有关如何在 Grafana Cloud 或本地安装插件的详细说明，请参阅插件安装文档。

配置

在您的 Grafana 实例上安装插件后，请按照这些说明添加新的 Astra DB 数据源，并输入配置选项。

使用身份验证令牌连接到 Astra DB

使用凭据连接到 Cassandra（需要 Stargate ）

通过配置 provisioning 文件进行配置

可以使用 Grafana 的 provisioning 系统通过配置文件配置数据源。有关其工作原理，包括可以为此数据源设置的所有设置，请参阅配置 Grafana 数据源。

这是使用令牌身份验证配置此数据源的 provisioning 示例

apiVersion: 1
datasources:
  - name: AstraDB
    type: grafana-astradb-datasource
    jsonData:
      uri: $ASTRA_CLUSTER_ID-$ASTRA_REGION.apps.astra.datastax.com:443
    secureJsonData:
      token: AstraCS:xxxxx

时间序列

在查询中添加 timestamp 字段类型后，可以选择时间序列可视化选项。此字段将用作时间戳。您可以使用可视化选项选择时间序列可视化。Grafana 将没有明确时区的时间戳行解释为 UTC。

多线时间序列

要创建多线时间序列，查询必须按以下顺序返回至少 3 个字段

• 字段 1：别名为 time 的 timestamp 字段
• 字段 2：用于分组的值
• 字段 3+：指标值

例如

SELECT time_field AS time, metric_name, avg(metric_value) AS avg_metric_value
FROM keyspace.table
GROUP BY metric_name, time_field
ORDER BY time_field

宏

为了允许注入日期范围过滤器，查询可以包含宏。

这是一个包含宏的查询示例，该宏将使用仪表盘的时间范围

SELECT timestampvalue as time, bigintvalue, textvalue FROM grafana.tempTable1
where timestampvalue $__timeFrom and timestampvalue $__timeTo Allow Filtering

查询转换为

SELECT timestampvalue as time, bigintvalue, textvalue FROM grafana.tempTable1
where timestampvalue  >= '2021-07-07T12:04:16Z' and timestampvalue  <= '2021-11-08T21:26:04Z' Allow Filtering

模板和变量

要添加新的查询变量，请参阅添加查询变量。

创建变量后，您可以使用变量语法在 CQL 查询中使用它。有关变量的更多信息，请参阅模板和变量。

了解更多

• 添加注解。
• 配置和使用模板和变量。
• 添加转换。
• 设置告警；请参阅告警概览。