Grafana

TDengine 能够与开源数据可视化系统 Grafana 快速集成搭建数据监测报警系统，整个过程无需任何代码开发，TDengine 中数据表的内容可以在仪表盘(DashBoard)上进行可视化展现。关于 TDengine 插件的使用您可以在GitHub中了解更多。

前置条件

要让 Grafana 能正常添加 TDengine 数据源，需要以下几方面的准备工作。

TDengine 集群已经部署并正常运行
taosAdapter 已经安装并正常运行。具体细节请参考 taosAdapter 的使用手册

记录以下信息：

TDengine 集群 REST API 地址，如：http://tdengine.local:6041。
TDengine 集群认证信息，可使用用户名及密码。

安装 Grafana

目前 TDengine 支持 Grafana 7.5 以上的版本。用户可以根据当前的操作系统，到 Grafana 官网下载安装包，并执行安装。下载地址如下：<https://grafana.com/grafana/download>。

配置 Grafana

安装 Grafana Plugin 并配置数据源

图形化界面安装
使用安装脚本
手动安装
K8s/Docker 容器

对于使用 Grafana 7.x 版本或使用 Grafana Provisioning 配置的用户，可以在 Grafana 服务器上使用安装脚本自动安装插件即添加数据源 Provisioning 配置文件。

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

安装完毕后，需要重启 Grafana 服务后方可生效。

保存该脚本并执行 ./install.sh --help 可查看详细帮助文档。

使用 grafana-cli 命令行工具进行插件安装。

grafana-cli plugins install tdengine-datasource
# with sudo
sudo -u grafana grafana-cli plugins install tdengine-datasource

或者从 GitHub 或 Grafana 下载 .zip 文件到本地并解压到 Grafana 插件目录。命令行下载示例如下：

GF_VERSION=3.2.2
# from GitHub
wget https://github.com/taosdata/grafanaplugin/releases/download/v$GF_VERSION/tdengine-datasource-$GF_VERSION.zip
# from Grafana
wget -O tdengine-datasource-$GF_VERSION.zip https://grafana.com/api/plugins/tdengine-datasource/versions/$GF_VERSION/download

以 CentOS 7.2 操作系统为例，将插件包解压到 /var/lib/grafana/plugins 目录下，重新启动 grafana 即可。

sudo unzip tdengine-datasource-$GF_VERSION.zip -d /var/lib/grafana/plugins/

如果 Grafana 在 Docker 环境下运行，可以使用如下的环境变量设置自动安装 TDengine 数据源插件：

GF_INSTALL_PLUGINS=tdengine-datasource

之后，用户可以直接通过 <http://localhost:3000> 的网址，登录 Grafana 服务器（用户名/密码：admin/admin），通过左侧 Configuration -> Data Sources 可以添加数据源，如下图所示：

TDengine Database Grafana plugin add data source

点击 Add data source 可进入新增数据源页面，在查询框中输入 TDengine 可选择添加，如下图所示：

TDengine Database Grafana plugin add data source

进入数据源配置页面，按照默认提示修改相应配置即可：

TDengine Database Grafana plugin add data source

Host： TDengine 集群中提供 REST 服务（在 2.4 之前由 taosd 提供，从 2.4 开始由 taosAdapter 提供）的组件所在服务器的 IP 地址与 TDengine REST 服务的端口号(6041)，默认 <http://localhost:6041>。
User：TDengine 用户名。
Password：TDengine 用户密码。

点击 Save & Test 进行测试，成功会有如下提示：

TDengine Database Grafana plugin add data source

参考 Grafana 容器化安装说明。使用如下命令启动一个容器，并自动安装 TDengine 插件：

docker run -d \
  -p 3000:3000 \
  --name=grafana \
  -e "GF_INSTALL_PLUGINS=tdengine-datasource" \
  grafana/grafana

使用 docker-compose，配置 Grafana Provisioning 自动化配置，体验 TDengine + Grafana 组合的零配置启动：

保存该文件为 tdengine.yml。

apiVersion: 1
datasources:
- name: TDengine
  type: tdengine-datasource
  orgId: 1
  url: "$TDENGINE_API"
  isDefault: true
  secureJsonData:
    url: "$TDENGINE_URL"
    basicAuth: "$TDENGINE_BASIC_AUTH"
    token: "$TDENGINE_CLOUD_TOKEN"
  version: 1
  editable: true

保存该文件为 docker-compose.yml。

version: "3.7"

services:
  tdengine:
    image: tdengine/tdengine:2.6.0.2
    environment:
      TAOS_FQDN: tdengine
    volumes:
      - tdengine-data:/var/lib/taos/
  grafana:
    image: grafana/grafana:8.5.6
    volumes:
      - ./tdengine.yml/:/etc/grafana/provisioning/tdengine.yml
      - grafana-data:/var/lib/grafana
    environment:
      # install tdengine plugin at start
      GF_INSTALL_PLUGINS: "tdengine-datasource"
      TDENGINE_URL: "http://tdengine:6041"
      #printf "$TDENGINE_USER:$TDENGINE_PASSWORD" | base64
      TDENGINE_BASIC_AUTH: "cm9vdDp0YmFzZTEyNQ=="
    ports:
      - 3000:3000
volumes:
  grafana-data:
  tdengine-data:

使用 docker-compose 命令启动 TDengine + Grafana ：docker-compose up -d。

打开 Grafana <http://localhost:3000>，现在可以添加 Dashboard 了。

创建 Dashboard

回到主界面创建 Dashboard，点击 Add Query 进入面板查询页面：

TDengine Database Grafana plugin create dashboard

如上图所示，在 Query 中选中 TDengine 数据源，在下方查询框可输入相应 SQL 进行查询，具体说明如下：

INPUT SQL：输入要查询的语句（该 SQL 语句的结果集应为两列多行），例如：select avg(mem_system) from log.dn where ts >= $from and ts < $to interval($interval) ，其中，from、to 和 interval 为 TDengine 插件的内置变量，表示从 Grafana 插件面板获取的查询范围和时间间隔。除了内置变量外，也支持可以使用自定义模板变量。
ALIAS BY：可设置当前查询别名。
GENERATE SQL：点击该按钮会自动替换相应变量，并生成最终执行的语句。

按照默认提示查询当前 TDengine 部署所在服务器指定间隔系统内存平均使用量如下：

TDengine Database Grafana plugin create dashboard