Grafana 数据源连接器

前往 Grafana 官网: https://grafana.com/oss/grafana/ 下载并安装最新的开源版本 (OSS, Open-Source Software)

在 releases 中下载最新版本的插件压缩包，如 dolphindb-datasource.v2.0.900.zip

将压缩包中的 dolphindb-datasource 文件夹解压到以下路径:

• Windows: <grafana 安装目录>/data/plugins/
• Linux: /var/lib/grafana/plugins/

如果不存在 plugins 这一层目录，可以手动创建该文件夹

阅读 https://grafana.com/docs/grafana/latest/administration/configuration/#configuration-file-location

打开并编辑配置文件：

在 [plugins] 部分下面取消注释 allow_loading_unsigned_plugins，并配置为 dolphindb-datasource

allow_loading_unsigned_plugins = dolphindb-datasource

注：每次修改配置项后，需重启 Grafana

打开任务管理器 > 服务 > 找到 Grafana 服务 > 右键重启

https://grafana.com/docs/grafana/latest/installation/restart-grafana/

本文中使用的配置文件可从grafana.ini获得，而本文例子中该配置文件位于* /ddbdocker/grafana.ini*。

docker pull dolphindb/dolphindb-grafana:9.1.0

docker run -itd --name ddb_gra \
  -p 3000:3000 
  -v /ddbdocker/grafana.ini:/etc/grafana/grafana.ini \
  gra_ddb_ds:v1 sh

参数解释：

• --name：所创建的容器名称
• -p：将容器的端口映射到宿主机上，以实现通过宿主机端口访问容器内的服务，本文为 Grafana 服务
• -v：将配置好的 grafana.ini 映射到容器内，并覆盖原有默认的 grafana.ini。如需使用容器内的默认配置，可不指定 -v 参数
• gra_ddb_ds:v1：Docker 镜像的名称。必须填入完整的镜像名称

预期输出（容器的完整 id）：

3cdfbab788d0054a80c450e67d5273fb155e30b26a6ec6ef8821b832522474f5

1. 将 query 类型设置为 脚本
2. 编写查询脚本，代码的最后一条语句需要返回 table
3. 编写完成后按 Ctrl + S 保存，或者点击页面中的刷新按钮 (Refresh dashboard)，可以将 Query 发到 DolphinDB 数据库运行并展示出图表
4. 代码编辑框的高度通过拖动底部边框进行调整
5. 点击右上角的保存 Save 按钮，保存 panel 配置

dolphindb-datasource 插件支持变量，比如:

• $__timeFilter 变量: 值为面板上方的时间轴区间，比如当前的时间轴区间是 2022-02-15 00:00:00 - 2022.02.17 00:00:00 ，那么代码中的 $__timeFilter 会被替换为 pair(2022.02.15 00:00:00.000, 2022.02.17 00:00:00.000)
• $__interval 和 $__interval_ms 变量: 值为 Grafana 根据时间轴区间长度和屏幕像素点自动计算的时间分组间隔。$__interval 会被替换为 DolphinDB 中对应的 DURATION 类型; $__interval_ms 会被替换为毫秒数 (整型)
• query 变量: 通过 SQL 查询生成动态值或选项列表

更多变量请查看 https://grafana.com/docs/grafana/latest/variables/

要查看代码中 print('xxx') 输出的消息，或者变量替换 (插值) 后的代码，可以按 F12 或 Ctrl + Shift + I 或 右键 > 检查 打开浏览器的开发者调试工具 (devtools), 切换到控制台 (Console) 面板中查看

要求：DolphinDB server 版本不低于 2.00.9 或 1.30.21

1. 将 query 类型设置为 流数据表
2. 填写要订阅的流数据表表名
3. 点击暂存按钮
4. 将时间范围改成 Last 5 minutes (需要包含当前时间，如 Last x hour/minutes/seconds，而不是历史时间区间，否则看不到数据)
5. 点击右上角的保存 Save 按钮，保存 panel 配置