TDengine与Grafana集成：打造高效时序数据可视化方案

最新推荐文章于 2025-06-01 09:08:59 发布

侯颂翼

最新推荐文章于 2025-06-01 09:08:59 发布

阅读量274

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00739/article/details/148361889

TDengine与Grafana集成：打造高效时序数据可视化方案

TDengine TDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps. 项目地址: https://gitcode.com/gh_mirrors/tde/TDengine

概述

时序数据库TDengine与可视化工具Grafana的集成，能够为物联网、工业互联网等场景提供强大的数据可视化能力。本文将详细介绍如何将TDengine作为数据源接入Grafana，并创建专业的监控仪表盘。

环境准备

在开始集成前，请确保满足以下条件：

Grafana服务：
- 已部署Grafana 7.5或更高版本（推荐使用最新版）
- 确保运行Grafana的账户具有安装目录的写权限
TDengine集群：
- 已完成TDengine集群部署并正常运行
- 已安装并运行taosAdapter组件
连接信息：
- 记录TDengine REST API地址（如http://tdengine.local:6041）
- 准备TDengine的用户名和密码

插件安装与配置

安装方式选择

TDengine为Grafana提供了多种安装方式：

1. 脚本自动安装（推荐）

bash -c "$(curl -fsSL \
  https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)" -- \
  -a http://localhost:6041 \
  -u root \
  -p taosdata

执行后需重启Grafana服务。

2. 命令行工具安装

grafana-cli --pluginUrl \
      https://github.com/taosdata/grafanaplugin/releases/download/v3.7.2/tdengine-datasource-3.7.2.zip \
      plugins install tdengine-datasource

3. 容器化部署

使用Docker时可通过环境变量自动安装插件：

docker run -d \
  -p 3000:3000 \
  --name=grafana \
  -e "GF_INSTALL_PLUGINS=https://github.com/taosdata/grafanaplugin/releases/download/v3.7.2/tdengine-datasource-3.7.2.zip;tdengine-datasource" \
  grafana/grafana

数据源配置

安装完成后，在Grafana界面进行配置：

访问http://localhost:3000（默认admin/admin）
进入Configuration > Data Sources
搜索并选择TDengine数据源
填写配置信息：
- Host：TDengine REST API地址
- User：TDengine用户名
- Password：TDengine密码
点击Save & Test测试连接

仪表盘创建指南

变量使用技巧

Grafana的变量功能可以极大增强仪表盘的交互性：

内置变量

$from/$to：查询时间范围
$interval：时间窗口间隔
__timezone：时区信息

自定义变量

查询类型变量：

select distinct(groupid) from power.meters 
where groupid < 3 and ts > $from and ts < $to;

间隔类型变量：可设置1s,2s,5s,10s,15s,30s,1m等选项

TDengine特色查询语法

TDengine为时序场景提供了特殊语法支持：

窗口函数：

SELECT _wstart, avg(current) 
FROM power.meters 
INTERVAL(1m) FILL(NULL)

分组查询：

SELECT _wstart, groupid, avg(current)
FROM power.meters 
PARTITION BY groupid INTERVAL($interval)

性能优化建议

时间范围限定：务必在WHERE条件中添加ts > $from AND ts < $to
合理设置interval：根据数据量和显示需求调整
避免全表扫描：使用分区和标签索引

实战案例：智能电表监控

1. 创建基础查询

SELECT _wstart as ts, avg(current) as current 
FROM power.meters 
WHERE groupid IN ($selected_groups) 
  AND ts > $from AND ts < $to 
INTERVAL($interval) FILL(NULL)

2. 添加分组显示

SELECT _wstart as ts, groupid, avg(current) as current 
FROM power.meters 
WHERE ts > $from AND ts < $to 
PARTITION BY groupid INTERVAL($interval) FILL(NULL)