Datalayers 文档

简体中文

English

Appearance

Datalayers 集成 Grafana 可视化指南 ​

本文介绍如何将 Datalayers 与 Grafana 集成，实现时序数据查询、可视化分析和 Dashboard 构建。该方案适用于监控看板、设备数据展示、工业指标分析等场景。

我们提供 手动部署 与 Docker Compose 一键部署，下面将分别介绍这两种部署方式。

手动部署 ​

环境准备 ​

  • Grafana 版本必须 >= 9.2.5。

安装 Datalayers ​

此处我们以 Ubuntu 操作系统、amd64 平台为例，请前往 下载页 下载对应平台的 deb 安装包。

安装完成后，可以通过我们提供的命令行工具写入一些示例数据：

首先，通过以下命令连接到数据库：

bash
dlsql -h 127.0.0.1 -u admin -p public

然后创建一个示例数据库：

bash
create database demo;

再创建一个表：

bash
CREATE TABLE demo.sensor_info (
  ts TIMESTAMP(9) NOT NULL DEFAULT CURRENT_TIMESTAMP,
  sn STRING,
  speed DOUBLE,
  temperature DOUBLE,
  timestamp KEY (ts))
  PARTITION BY HASH(sn) PARTITIONS 8
  ENGINE=TimeSeries
  with (ttl='10d');

写入一些示例数据，当然为了数据更丰富，你可以多写入一点随机数据：

bash
INSERT INTO sensor_info(sn, speed, temperature) VALUES('100', 22.12, 30.8), ('101', 34.12, 40.6), ('102', 56.12, 52.3);

安装 Grafana ​

请前往 Grafana 官网下载页 获取安装包。

此处我们下载并安装 Linux 的 开源版本 11.2.0：

download grafana

安装好 Grafana 之后就可以进行插件的安装了，建议安装前先停止你的 Grafana 服务。

安装 Datalayers 数据源插件 ​

配置插件 ​

此时 Grafana 和 Datalayers 数据源插件均已就绪，请通过本地浏览器，登录到 Grafana。

请按照下方图示填入对应的数据库地址+端口、用户名+密码、默认的数据库名称，如果开启了 TLS 还需要填写证书。

config plugin

配置完成后，你可以点击 Save & test 按钮保存并测试连通性。

数据查询 ​

我们之前已经写入了一些示例数据，你可以通过 Datalayers 数据源插件进行一些查询。

select all

图中使用 Home - Explore 面板查询数据，在默认可视化构建模式下可生成 select * from demo.test 这类查询语句。

当然也可以切换到 SQL 编辑器模式，编写更复杂的查询语句。

select data use sql-editor

你也可以使用函数对数据进行聚合等操作，详见SQL 函数。

在插件的编辑器模式中，你可以使用一些 Grafana 变量，请点击帮助按钮查看：

help button

TIP

请注意，在 Grafana 插件中查询语句建议通过 <db_name>.<table_name> 的方式来指定数据库。

添加 Dashboard ​

现在，你也可以使用 Grafana - Dashboards 功能开始添加一个 Dashboard，如下图：

select data use sql-editor

在此界面可进行更精细的调整，调整完成后可以点击 Apply 应用这个 Panel，当你添加了较多的 Panel，就可以通过 Grafana 强大的自定义编辑功能组合成一个丰富的 Dashboard。

Docker Compose 一键部署 ​

如果您希望免去安装和配置 Datalayers 与 Grafana 的过程，可以通过我们提供的 Docker Compose 方案进行零配置快速体验。

首先你需要拉取这个 开源项目。它使用 Docker 将 Datalayers 及其相关镜像整合到一个 docker-compose 文件中，从而快速启动这些服务。

bash
git clone https://github.com/datalayers-io/datalayers-with-grafana.git

然后请跟随 README 文档完成启动、快速写入示例数据的过程。

当你完成上述步骤后，就已经自动完成了上述所有的安装、配置、写入示例数据步骤，你可以直接进行数据查询、添加 Dashboard 相关操作。

通过将 Datalayers 与 Grafana 结合，可以更高效地完成时序数据可视化、指标分析与业务看板构建。

相关文档 ​

© 2026 Datalayers All rights reserved