第一步:安装 Grafana(APT 仓库方式,推荐)
# 1. 安装依赖
sudo apt-get install -y apt-transport-https software-properties-common wget
# 2. 导入 GPG 密钥 + 添加仓库
sudo mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" \
| sudo tee -a /etc/apt/sources.list.d/grafana.list
# 3. 安装 Grafana
sudo apt-get update
sudo apt-get install -y grafana
# 4. 启动 + 开机自启
sudo systemctl daemon-reload
sudo systemctl enable grafana-server
sudo systemctl start grafana-server
# 5. 验证
sudo systemctl status grafana-server | head -8
看到 Active: active (running) 就 OK。Grafana 默认端口 3000。
第二步:放行端口
# 系统防火墙
sudo ufw allow 3000/tcp # Ubuntu
# 或 sudo firewall-cmd --permanent --add-port=3000/tcp && sudo firewall-cmd --reload # CentOS
# ⚠️ 云服务器安全组也要放行 3000/tcp!
第三步:浏览器验证
Mac 上打开:http://192.129.246.231:3000
默认账号密码都是 admin,首次登录会要求改密码。
第四步:安装 TDengine 插件(Grafana 装好之后)
Grafana 装好后,回到服务器跑你之前那条命令:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)"
这次应该能正常安装了。装完后重启 Grafana 让插件生效:
sudo systemctl restart grafana-server
第五步:在 Grafana 里配置 TDengine 数据源
- 浏览器进 Grafana → 左侧菜单 → Configuration → Data sources
- 点 Add data source
- 选 TDengine Data Source
- 填写:
| 字段 | 值 |
|---|---|
| Name | TDengine (随意) |
| Host | tdnode1:6041 或 127.0.0.1:6041(REST 方式) |
| Username | root |
| Password | taosdata |
- 点 Save & Test
⚠️ 如果 Grafana 和 taosd 在同一台服务器上,Host 可以用
127.0.0.1:6041。但因为 Grafana 在容器里或进程间可能无法解析
tdnode1FQDN,建议先用127.0.0.1:6041试。
- 成功后就能创建 Dashboard 查询 TDengine 数据了。
先跑第一步装 Grafana,把 systemctl status grafana-server 的输出贴过来确认成功后,再继续后面的步骤。
遇到问题参考:
Grafana 跑起来了,但列表里确实没有 TDengine Data Source,说明插件没装上。之前跑安装脚本时 Grafana 还没装,所以跳过了。现在重新装插件。
在服务器上手动安装 TDengine 插件
# 1. 查看 Grafana 的插件目录(确认路径)
sudo ls /var/lib/grafana/plugins/
# 2. 手动下载并安装插件(用 grafana-cli 工具)
sudo grafana-cli plugins install tdengine-datasource
# 3. 如果上面的命令报错或找不到插件,用 URL 直接装
cd /var/lib/grafana/plugins/
sudo wget -q https://github.com/taosdata/grafanaplugin/releases/download/v4.0.0/tdengine-datasource-4.0.0.zip
sudo unzip -o tdengine-datasource-4.0.0.zip
sudo rm -f tdengine-datasource-4.0.0.zip
sudo chown -R grafana:grafana tdengine-datasource
# 4. 重启 Grafana 加载插件
sudo systemctl restart grafana-server
# 5. 确认插件加载成功
sudo ls /var/lib/grafana/plugins/
# 应该看到 tdengine-datasource 目录
验证:刷新浏览器页面
- 回到 Grafana → Connections → Data sources → Add data source
- 这次应该能看到 TDengine Data Source 了
- 如果还是看不到,按
F12打开浏览器开发者工具看 Console 有没有报错,或者搜索框里搜 “tdengine”
如果 grafana-cli 命令不存在
有些系统装的 Grafana 没有 grafana-cli 工具,直接用第 2 步的 wget 方式就行。或者:
# 看看 grafana 可执行文件在哪
which grafana-server
# 用 grafana-server 的兄弟工具
/usr/sbin/grafana-cli plugins install tdengine-datasource
配置数据源(插件出现后)
找到 TDengine Data Source 后填写:
| 字段 | 值 |
|---|---|
| Name | TDengine |
| Host | 127.0.0.1:6041(Grafana 和 taosd 同一台机器) |
| Username | root |
| Password | taosdata |
点 Save & Test,看到绿色 “Data source is working” 就成功了。
先在服务器上跑第 2 步的安装命令,把输出和 ls /var/lib/grafana/plugins/ 的结果贴过来确认插件装上了。
插件已经在了!tdengine-datasource 目录在列表里。但 Grafana 还没加载它——需要重启 Grafana 让它扫描到新插件。
重启 Grafana
sudo systemctl restart grafana-server
sudo systemctl status grafana-server | head -5
# 应该看到 Active: active (running)
刷新浏览器
- 硬刷新浏览器页面:Mac 上按
Cmd + Shift + R - 回到 Connections → Data sources → Add data source
- 搜索框里搜 tdengine
如果还是看不到,检查一下 Grafana 日志有没有加载报错:
sudo tail -20 /var/log/grafana/grafana.log | grep -i "plugin\|error"
大概率重启后就出来了。