插件 〉TDengine Datasource


开发者

TAOS Data Inc.

订阅以接收不定期的产品新闻和更新



数据源
商业

TDengine 数据源

  • 概览
  • 安装
  • 更新日志
  • 相关内容

TDengine 的 Grafana 插件

TDengine 是一款采用 GNU AGPL v3.0 开源协议的大数据平台,专为物联网 (IoT)、车联网、工业物联网以及 IT 基础设施和应用监控而设计和优化,由 TDengine 开发。

TDengine 数据源插件是为 Grafana 开发的。本文档解释了如何安装和配置数据源插件,并将其用作时间序列数据库。我们将了解此数据源特有的数据源选项、变量、查询和其他选项。

首先,请参考 添加数据源,了解如何在 Grafana 中添加数据源的说明。请注意,只有拥有组织管理员角色的用户才能添加数据源。

要安装此插件,请参考 安装 TDengine 的 Grafana 插件

使用方法

现在您可以添加自己的 TDengine 数据源并在仪表盘中使用它了。有关快速查看,请参考 Grafana 数据源文档主题 - 添加数据源。请确保 TDengine 后端守护进程 taosd 和 TDengine RESTful 服务后端守护进程 taosadapter 已启动。

添加数据源

指向 配置 -> 数据源 菜单,然后点击 添加数据源 按钮。

add data source button

搜索并选择 TDengine添加数据源

如果 TDengine 不在列表中,请检查安装说明以允许加载未签名的插件。

配置 Grafana 11 版本的 TDengine 数据源。 数据源配置 注意

  1. 关闭加载 TDengine 告警按钮,以防止添加数据源时自动导入告警规则。
  2. 删除数据源时,需要先清除导入的告警规则

为 Grafana 11 以下版本配置 TDengine 数据源。

data source configuration

保存并测试,应该显示 'TDengine 数据源工作正常'。

data source test

导入仪表盘

指向 + / 创建 - 导入(或 /assets/import URL)。

import dashboard and config

现在您可以通过 JSON 文件或 grafana 仪表盘 ID 导入仪表盘(请确保您的网络可以访问 https://grafana.org.cn)。

这是您想用于 TDengine 的第一个 grafana 仪表盘,grafana 仪表盘 ID 是 18180

import via grafana.com

导入后

dashboard display

重要变更

v3.6.0

  1. Grafana 11 版本

    TDengine 数据源插件已为 Grafana 11 版本添加了新功能,可以在添加数据源时自动导入和清除 TDengine 集群基本指标(如 CPU、内存、dnode、vnode 等)的告警。 数据源配置 注意

    (1)关闭加载 TDengine 告警按钮,以防止添加数据源时自动导入告警规则。

    (2)删除数据源时,需要先清除导入的告警规则。

    添加数据源后,您将在告警管理菜单中看到自动导入的告警配置。 数据源配置

  2. Grafana 7.5 版本

    TDengine 数据源插件已为 Grafana 7.5 版本添加了新功能,可以在添加数据源时自动导入和清除 TDengine 集群基本指标(如 CPU、内存、dnode、vnode 等)的告警。

    要导入仪表盘,输入“TDinsight for 3.x 仪表盘”并点击保存。随后,加载的告警规则将显示在告警菜单中,如下所示。 Grafana 7.5

v3.2.0

  1. TDengine 数据源插件使用 secureJsonData 来存储敏感数据。当您从旧版本升级时,这将导致一项破坏性变更。

    从旧版本迁移的简单方法是重新配置数据源,就像从头开始添加数据源一样。

    如果您使用 Grafana 配置供应 (provisioning),则应更改数据源供应配置文件以使用 secureJsonData

    apiVersion: 1
    datasources:
      # <string, required> name of the datasource. Required
    - name: TDengine
      # <string, required> datasource type. Required
      type: tdengine-datasource
      # <string, required> access mode. direct or proxy. Required
      # <int> org id. will default to orgId 1 if not specified
      orgId: 1
    

    <string> url to TDengine rest api, eg. http://td1:6041

    url: “$TDENGINE_API”

    <bool> mark as default datasource. Max one per org

    isDefault: true

    <map>

    secureJsonData: # <string> a redundant url configuration. Required. url: “$TDENGINE_API” # <string> basic authorization token. Required, can be build like # printf root:taosdata|base64 basicAuth: “${TDENGINE_BASIC_AUTH}” # <string> cloud service token of TDengine, optional. token: “$TDENGINE_CLOUD_TOKEN”

    version: 1

    <bool> allow users to edit datasources from the UI.

    editable: true

  2. 现在用户可以在数据源配置页面的仪表盘标签页中快速导入 TDinsight 仪表盘。

    import-tdinsight-from-tdengine-ds

使用 TDengine 数据源插件监控 TDengine 数据库

有关详细信息,请参见 如何使用 Grafana 监控 TDengine 集群

TDinsight

TDinsight 是一个简单的 TDengine 数据库监控解决方案。有关详细信息,请参见 TDinsight README

Docker Stack

如需快速查看和测试,您可以使用 docker-compose 启动完整的 Grafana + AlertManager + Alert Webhook Stack。

docker-compose up -d

服务

仪表盘

您可以在 examples 目录中获取其他仪表盘,或在 grafana 中搜索 TDengine 数据源 https://grafana.org.cn/grafana/dashboards/?orderBy=downloads&direction=desc&dataSource=tdengine-datasource

以下是一个简短列表

如果您想与 TDengine 社区分享您的仪表盘,可以提交一个 PR,我们感谢您的贡献!

在 Grafana Cloud 上安装 TDengine 数据源

更多信息,请访问有关 插件安装的文档。

更新日志

此项目的所有重要变更将记录在此文件中。

[3.7.1] - 2025-02-10

特性

  • 支持多行 SQL 编辑器。
  • 向 TDinsightV3 仪表盘添加了“分类连接计数”表格。

[3.7.0] - 2024-11-20

特性

  • 将 TDengine Grafana 插件从 Angular 迁移到 React

[3.6.3] - 2024-11-05

Bug 修复

  • 修复 TDinsight 请求数据问题。

[3.6.2] - 2024-10-29

特性

  • 改进告警 UI。

[3.6.1] - 2024-10-11

特性

  • 改进告警 UI。

[3.6.0] - 2024-09-28

特性

  • 支持 grafana 11 和 7.5 版本的 taosd 告警配置。

[3.5.2] - 2024-06-25

特性

  • 更新 taosd 仪表盘。

[3.5.1] - 2024-04-30

Bug 修复

特性

  • 更新 taosX 和 taosd 仪表盘。

[3.5.0] - 2024-03-05

Bug 修复

特性

  • 添加 taosX 仪表盘的 TDinsight。
  • 新的 3.x 仪表盘 TDinsight。

[3.4.7] - 2024-01-27

Bug 修复

特性

  • 移除 TDpower 仪表盘。

[3.4.6] - 2024-01-02

Bug 修复

修复慢 SQL 修复 SQL Bug 移除控制台日志

[3.4.3] - 2023-12-22

Bug 修复

修复 token 字段问题
更新一些过时的图片

[3.4.2] - 2023-12-13

Bug 修复

修复 token 输入 Bug

特性

将 TDinsight 修改为 TDinsight 2.x

[3.4.1] - 2023-11-14

Bug 修复

特性

  • 新仪表盘:TDpower 和 TDsmeters。

[3.4.0] - 2023-10-31

Bug 修复

特性

  • 新 Taosadapter 仪表盘
  • 为 adapter 仪表盘添加数据源
  • 更改 adapter 仪表盘的图例

[3.3.6] - 2023-10-14

Bug 修复

  • 修复 telgraf 仪表盘中的 SQL

改进

  • 更改数据源配置页面

[3.3.5] - 2023-09-22

Bug 修复

  • 修复时间偏移问题
  • 修复请求 URL
  • 修复 tdinsight v3 中的单位
  • 修复数据源路由问题
  • 修复点击保存时主机和用户显示问题

构建

  • 将 @adobe/css-tools 从 4.1.0 更新至 4.3.1 (#224)

[3.3.4] - 2023-07-25

Bug 修复

  • 修复 http 状态码仪表盘问题

改进

  • 在 tdinsight.sh 中检查 tdengine api schema
  • 删除登录历史仪表盘

构建

  • 将 word-wrap 从 1.2.3 更新至 1.2.4 (#218)

[3.3.3] - 2023-07-12

Bug 修复

  • 修复 http 状态码问题
  • 修复 taoskeeper prometheus 仪表盘 v3 问题
  • 修复 tdinsight v3 和 prometheus v3 仪表盘问题

文档

  • 更新 tdinsight 文档

改进

  • 为数据库添加默认值并删除 user db

特性

  • 添加 taoskeeper prometheus 仪表盘 (#209)

构建

  • 将 google.golang.org/grpc 从 1.41.0 更新至 1.53.0 (#213)
  • 将 semver 从 5.7.1 更新至 5.7.2 (#214)

[3.3.2] - 2023-04-13

Bug 修复

  • 移除 group by
  • 适配 keepColName 参数
  • 为 http 状态码仪表盘设置数据源 (#200)
  • 修复总表数问题 (#201)
  • 修复表摘要问题
  • 修复表数据类型问题
  • 修复重复指标名称问题

改进

  • 支持变量查询键/值

构建

  • 将 webpack 从 5.75.0 更新至 5.76.0 (#195)

[3.3.1] - 2023-03-15

Bug 修复

  • 拼写错误
  • 拼写错误
  • 修复 telegraf 仪表盘问题 (#187)
  • 修复未使用的 formatType 配置
  • 删除 datasource.ts 中的 console log (#191)
  • 重构 readme,升级依赖,并修复 tdinsight v3
  • 拼写错误
  • 修复日志问题 (#194)

文档

  • 添加 tdinsight v3 的 readme

[3.3.0] - 2023-02-24

Bug 修复

  • 恢复 testDatasource 函数
  • 更改 httpclient 并删除敏感日志
  • 从日志中删除 token (#184)

改进

  • 按 grafana/create-plugin 重构 (#179)

构建

  • 修复 release workflow 缺少 module.js.map 的问题
  • 修复 release work flow

[3.2.9] - 2023-02-08

Bug 修复

  • Tdinsight v3.x 支持 grafana 7.x (#170)
  • 修复 http 请求仪表盘问题
  • 修复格式化列名时阻塞的问题
  • 查询数据错误时添加错误消息

改进

  • 支持多维度告警
  • 添加 http_status_code 仪表盘 (#173)

特性

  • 支持通过设置 format-str 设置图例别名

构建

  • 将 license 添加到 dist

[3.2.8] - 2022-12-29

Bug 修复

  • 删除 frame name,否则此名称将覆盖数据列名
  • Tdinsight 仪表盘显示错误

[3.2.7] - 2022-11-15

Bug 修复

  • 修复 TDinsight.sh --offline 错误 (#152)
  • 更改时间单位和图表位置 (#153)
  • Telegraf conf 优化 (#154)
  • 修复 grafana 中 TDinsight v3 的页面错误 (#161)

文档

  • 添加从配置部分安装插件 (#157)
  • Readme 添加项目符号链接 (#158)
  • 用词与官方文档保持一致 (#159)
  • 修复一些拼写错误和用词

改进

  • Grafana 插件支持 TDengine 3.0 (#162)

[3.2.6] - 2022-08-12

Bug 修复

  • Install.sh -p 不工作
  • 修复离线插件未找到错误 (#146)
  • 兼容 python2 (#148)
  • 修改 taosAdapter http_request_total 仪表盘
  • 添加错误原因
  • 添加 V3 仪表盘
  • 时间戳代码

CI

  • 修复 ci 语法错误

文档

  • 更新 README 关于数据源名称设置的内容

改进

  • 系统没有 python 时不缓存 zip 文件 (#138)
  • 任何人都可以通过 PR 请求发布
  • 匹配 3.0 (#149)

[3.2.5] - 2022-06-10

Bug 修复

  • 安装程序中自动检测 sudo 命令 (#135)
  • 修复 --plugin-version Bug 并支持 install.sh 中的 cloud token (#136)

改进

  • 移除 provisioning 配置中未使用的 timeInterval (#137)

[3.2.4] - 2022-06-08

Bug 修复

  • 修复 secure json data 中使用 cloud token 时 url 参数丢失的问题

特性

  • 改进 telegraf 示例并发布到 Grafana (#133)
  • 添加 install.sh 作为一键安装程序

[3.2.3] - 2022-06-02

Bug 修复

  • 移除 backend 插件配置中的 user/password (#131)

文档

  • 修复 basic auth 生成注释错误 (#130)

[3.2.2] - 2022-05-30

Bug 修复

  • 修复数据源测试检查 Bug (#128)

[3.2.1] - 2022-05-26

Bug 修复

  • 移除敏感日志,修复 ts layout 格式解析方法 (#127)

[3.2.0] - 2022-05-25

Bug 修复

  • 修复 group by 多列时标签不匹配的 Bug (#124)

文档

  • V3.1.7 作为签名版本发布 (#121)

特性

  • 隐式按多列分组 (#122)
  • 在 secureJsonData 中存储 user, password, token
  • 对所有敏感数据使用 secureJsonData
  • 在数据源配置页面添加仪表盘标签页

[3.1.7] - 2022-05-14

CI

  • 发布前签名插件 (#119)

特性

  • 添加 cloud service token 的配置选项 (#118)

[3.1.6] - 2022-05-05

Bug 修复

  • 更改 plugin-check 的链接至 tdengine.com (#117)

[3.1.5] - 2022-05-05

Bug 修复

  • 将时间戳 _ts 重命名为 ts (#112)
  • 添加 --offline/--download-only 成对选项 (#113)
  • 修复 grafana 插件验证器警告 (#116)

[TD-13076]<fix>

  • 更新依赖项 (#99)

[TD-13320]<docs>

  • 添加 TDinsight 说明 (#100)
  • 丰富 TDinsight 的英文/中文介绍 (#101)

[TD-13366]<docs>

  • 更新 tdinsight 中数据源插件的安装说明 (#102)

[TD-13540]<fix>

  • 如果 TDinsight.sh 中未安装 grafana 则失败 (#104)

[TD-13556]<feat>

  • 添加 taosadapter 指标 (#106)

[TD-13722]<fix>

  • 移除 Requests 行中的 Requests (Inserts) 面板 (#105)

[TD-14180]<fix>

  • 修复 taosAdapter 中的 CPU 和内存百分比 (#108)

[TDREL-24]<docs>

  • 添加 macOS 安装说明 (#110)

[3.1.4] - 2022-01-14

[TD-11474]<docs>

  • 改进 TDinsight 文档 (#84)

[TD-11556]<docs>

  • 添加 TDinsight 用户手册的中文版本 (#85)

[TD-11589]<docs>

  • 应用评审建议 (#87)

[TD-11900]<docs>

  • 为官网链接使用相对图像链接 (#90)
  • 移除 toc 并修复网站图片显示 (#92)

[TD-12501]<docs>

  • 为 TDinsight 添加升级/卸载部分 (#94)

[TM-1532]<docs>

  • TDinsight 图片小幅修复 (#93)

[TS-1125]<fix>

  • 兼容 grafana 5.2.4 (#97)

[TS-781]<fix>

  • 使用 show databases 代替 select distinct(database_name) from vgroups_info (#91)

[TS-790]<fix>

  • 修复 TDinsight disk/net 面板中的时间范围不正确问题 (#88)

[3.1.3] - 2021-11-26

[10610]<fix>

  • 修复 TD-11023 TD-11024 TD-11079 TDinsight 仪表盘 Bug (#71)

[TD-10610]<fix>

  • 更新 TDinsight 仪表盘布局 (#75)
  • 推送短信告警 (#77)。

[TD-11003]<fix>

  • Interval once 替换错误

[TD-11078]<fix>

  • 修复整型数据情况下的后端插件错误 (#72)

[TD-11092]<fix>

  • 通过变量统一 TDinsight 时间间隔
  • 更新时间间隔并将其默认设置为 auto

[TD-11147]<fix>

  • Fill(null) 导致 taosadapter/httpd 崩溃 (#76)

[TD-11242]<fix>

  • 数据源配置短信 (#79)。

[TD-11243]<feat>

  • 为 TDinsight 添加配置供应脚本 (#81)

[TD-11245]<fix>

  • 修复 VNnodes Masters 中的值映射错误 (#78)

[TD-11414]<fix>

  • Grafanaplugin 告警错误 (#82)。

[TD-11441]<fix>

  • 修复 ts layout 错误 2021-11-26T03:06:00Z 并改进文档 (#83)

[3.1.2] - 2021-11-12

[TD-10854]<fix>

  • GENERATE SQL 错误。

[TD-11002]<release>

  • 发布 v3.1.2 (#68)

[TS-552]<fix>

  • 支持按列分组。
  • 支持按列分组。
  • 支持按列分组。
  • 支持按列分组。

[3.1.1] - 2021-10-31

Bug 修复

  • 未找到 Grafana-webhook 子模块 URL (#64)

文档

  • 修复 package script 中的目录名
  • 修复 @jtao1735 的拼写错误

[TD-10584]<docs>

  • 添加支持告警的 TDengine 仪表盘 (#62)

[TD-10618]<fix>

  • 生成最新的 SQL

[TD-10760]<fix>

  • 无法找到用户错误。
  • 无法找到用户错误。

[TD-10808]<release>

  • 将 grafana 插件版本更新至 v3.1.1 (#63)

[3.1.0] - 2021-10-27

特性

  • 实现metricFindQuery方法,解决查询值的问题

[TD-10477]<fix>

  • 适用于 7.x grafana 的更优仪表盘 (#38)

[TD-10484]<fix>

  • B 未定义错误 (#39)。

[TD-10549]<fix>

  • Grafana 插件告警错误。
  • Grafana 插件告警错误。

[TD-10552]<docs>

  • 添加 collectd 仪表盘示例 (#45)

[TD-10612]<docs>

  • 在 TDengine 新仪表盘中支持数据源选择 (#50)

[TD-10617]<docs>

  • 添加 telegraf 的 grafana 仪表盘 (#43)

[TD-10618]<fix>

  • 插件变量重复错误 (#42)。

[TD-10636]<docs>

  • 添加 statsd 假仪表盘 (#46)

[TD-10637]<fix>

  • 修复 telegraf 的 grafana 仪表盘错误 (#47)

[TD-10774]<fix>

  • 移除 grafanaplugin 源代码中的 dist/ 目录 (#52)

[TD-10777]<fix>

  • 在 GitHub Actions 中添加 CI 和 Release 工作流程,并修复提交中的警告 (#54)

[TD-4310]<feature>

  • 支持变量

[TD-4906]<fix>

  • 修复 Grafana 6.2 中 demo 仪表盘导入错误

[TD-5014]<feature>

  • 支持查询结果的时间偏移

[TD-5109]<feature>

  • 支持查询间的算术计算

[TD-5215]<fix>

  • 修复读取未定义属性 'status' 的问题

[TD-5232]<fix>

  • 修复仪表盘导入显示异常问题

[TD-5233]<enhance>

  • 解决构建中的警告

[TD-5736]<docs>

  • 添加如何使用 Grafana 监控 TDengine 的文档 (#40)

[TD-6030]<fix>

  • Tdengine restful api (#36)

[TS-76]<fix>

  • 修复 6.x 中的 grafana 数据源 api (#29)

<!-- generated by git-cliff -->

  • Grafana-webhook submodule url not found (#64)

<!-- 由 git-cliff 生成 -->