DolphinDB Backend Datasource

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

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

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

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

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

在 plugins 目录下，应形成形如以下的文件结构：

plugins
├── dolphindb-datasource-next
│   ├── LICENSE
│   ├── README.md
│   ├── components
│   ├── go_plugin_build_manifest
│   ├── gpx_dolphindb_datasource_windows_amd64.exe
│   ├── img
│   ├── module.js
│   ├── static
│   └── plugin.json
├── other_plugin_1
├── other_plugin_2
└── ...

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

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

即把下面的脚本：

# Enter a comma-separated list of plugin identifiers to identify plugins to load even if they are unsigned. Plugins with modified signatures are never loaded.
;allow_loading_unsigned_plugins =

改为：

# Enter a comma-separated list of plugin identifiers to identify plugins to load even if they are unsigned. Plugins with modified signatures are never loaded.
allow_loading_unsigned_plugins = dolphindb-datasource-next

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

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

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

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

日志文件路径：

• 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 ，或点击左侧导航的 Connections > Data sources 添加数据源，搜索并选择 “dolphindb”，配置数据源后点 Save & Test 以保存数据源。

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

Grafana 警报允许设置告警条件，以监视特定事件或情况。当告警条件被满足后，Grafana 可以通过配置的方式发送通知。

接下来，将通过一个简单的示例介绍警报的使用方法。

1. 查询数据

   编写一段查询脚本，在 Dashboard 中查询一段数据，比如某一公司的股价。

   
   

2. 找到面板下方的 Alert 标签页，并选择创建 Alert

   
   

3. 输入警报名称，并设置用于设置告警条件的相关数据。

   比如输入时间和股价。

   
   

4. 设置告警条件

   比如设置当最高价大于 180 时告警。

   
   

5. 设置查询评估行为

   比如设置每 10 秒就查询一次，并且在这种情况持续 10 秒后告警。

   
   
   

6. （可选）设置通知方式

   此处设置了发送邮件作为通知方式，Grafana 支持多种通知方式，比如 Slack, Discord, Webhook, Wecom, DingDing 等。

   
   

7. 保存警报并退出

   
   

8. 检查效果

   
   

   当告警条件满足时，警报被触发。警报的状态变为 Firing，并且 Panel 的状态变为“alerting”，在 Panel 旁边的图标将显示为一个红色的告警图标。

Grafana 官方文档。

Q：如何设置 Dashboard 自动刷新间隔？ A：对于脚本类型，打开 Dashboard，在右上角刷新按钮右侧点击下拉框选择“自动刷新间隔”；对于流数据表类型，数据是实时的，无需设置。

如果需要自定义刷新间隔，可以打开 dashboard settings > Time options > Auto refresh，输入自定义的间隔。 如果需要定义比 5s 更小的刷新间隔，比如 1s，需要按下面的方法操作：

1. 修改 Grafana 配置文件：

   [dashboards]
   min_refresh_interval = 1s

2. 修改完后重启 Grafana。

(参考回复：How to change refresh-rate from 5s to 1s )