DolphinDB Grafana DataSource Plugin

前往 Grafana 官网下载并安装最新的开源版本 (OSS, Open-Source Software)。

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

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

Windows：\<grafana 安装目录>\data\plugins\

Linux：/var/lib/grafana/plugins/

注意：如果不存在 plugins 目录，可手动创建。

推荐用户阅读推荐用户阅读 Grafana 配置说明文档，然后打开并编辑配置文件。

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

allow_loading_unsigned_plugins = dolphindb-datasource

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

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

推荐用户阅读 Grafana 快速上手文档。

DolphinDB 将包含 dolphindb-datasource 插件的 Grafana 集成为一个 Docker 镜像，可以通过 Docker 容器快速部署，节省过于繁琐的配置步骤。具体安装步骤如下：

1. 下载配置文件至某个路径

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

2. 执行如下命令，从远程 Docker 仓库拉取镜像

   docker pull dolphindb/dolphindb-grafana:9.1.0

3. 执行如下命令，创建一个名为 ddb_gra 的容器：

     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

若成功安装，可在 Grafana 启动日志中可以看到类似如下内容：

WARN [05-19|12:05:48] Permitting unsigned plugin. This is not recommended logger=plugin.signature.validator pluginID=dolphindb-datasource pluginDir=<grafana 安装目录>/data/plugins/dolphindb-datasource

日志文件路径：

• Windows：\<grafana 安装目录>\data\log\grafana.log
• Linux：/var/log/grafana/grafana.log

或者可访问链接：http://localhost:3000/plugins。若成功安装，可看到页面中 DolphinDB 插件是 Installed 状态。

打开 http://localhost:3000。初始登入名以及密码均为 admin。

打开 http://localhost:3000/datasources ，或点击左侧导航的 Configuration > Data sources 添加数据源，搜索并选择 “dolphindb”，配置数据源后点 Save & Test 以保存数据源。

注意: 2022 年及之后的插件使用 WebSocket 协议与 DolphinDB 数据库通信，因此数据源配置中的 URL 需要以 ws:// 或者 wss:// 开头

打开或新建 Dashboard，编辑或新建 Panel，在 Panel 的 Data source 属性中选择上一步添加的数据源。

Grafana 官方文档。

Q: 如何设置 Dashboard 自动刷新间隔？

A:

• 对于脚本类型，打开 Dashboard, 在右上角刷新按钮右侧点击下拉框选择自动刷新间隔。
• 对于流数据表类型，数据是实时的，无需设置。没有新的数据更新发生时，连接会关闭；如有新的数据更新发生，连接会重新建立。

如果需要自定义刷新间隔，可以打开 dashboard settings > Time options > Auto refresh, 输入自定义的间隔。

如果需要定义比 5s 更小的刷新间隔，比如 1s，需要按下面的方法操作：

1. 修改 Grafana 配置文件：

   [dashboards]
   min_refresh_interval = 1s

2. 修改完后重启 Grafana。

   参考: 如何修改刷新率