插件 〉MQTT


开发者

Grafana Labs

订阅以接收产品新闻和更新



数据源
grafana

MQTT

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

Build Status

Grafana 的 MQTT 数据源

MQTT 数据源插件使您能够在 Grafana 内可视化流式 MQTT 数据。

要求

MQTT 数据源有以下要求

  • 具有服务器或组织管理员角色的 Grafana 用户;请参阅 权限
  • 访问 MQTT 代理。

配置数据源

通过填写以下字段来添加数据源

基本字段

字段描述
名称此特定 MQTT 数据源的名称
URIMQTT 代理的方案、主机和端口。支持的方案:TCP (tcp://)、TLS (tls://) 和 WebSocket (ws://)

认证字段

字段描述
用户名(可选)连接到 MQTT 代理时使用的用户名
密码(可选)连接到 MQTT 代理时使用的密码

查询数据源

查询编辑器允许您指定面板将订阅的 MQTT 主题。有关有效主题名称和过滤器的更多信息,请参阅 MQTT v3.1.1 规范

mqtt dashboard

已知限制

  • 插件当前不支持 MQTT CONNECT 数据包的所有选项。
  • 此插件自动支持发布数字、字符串、布尔值和 JSON 格式值的 MQTT 主题。可以使用 Extract Fields 转换提取嵌套对象值。
  • 此插件在接收到消息时自动附加时间戳。可以使用 Convert field type 转换解析消息正文中包含的时间戳。

安装插件

安装先决条件

请参阅: 构建流式数据源后端插件

详情: Ubuntu Windows

满足兼容性要求

此插件当前支持 MQTT v3.1.x。

注意:由于此插件使用 Grafana Live Streaming API,请确保使用 Grafana v8.0+。

安装步骤

  1. 将插件克隆到您的 Grafana 插件目录。
  2. 通过运行 yarn installyarn build 构建插件。

注意:上述 yarn build 命令可能在非类 Unix 系统(如 Windows)上失败,您可以在 ./package.json 文件中尝试用 rimraf 替换 rm -rf 命令以使其正常工作。

  1. 运行 mage reloadPlugin 或重启 Grafana 以加载插件。

验证插件是否已安装

  1. 在 Grafana 左侧菜单中,导航到 Configuration > Data sources
  2. 从右上角,点击 Add data source 按钮。
  3. 在搜索字段中搜索 MQTT,并将鼠标悬停在 MQTT 搜索结果上。
  4. 点击 MQTT 的 Select 按钮。

在 Grafana Cloud 上安装 MQTT

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

更新日志

[1.1.0-beta.3] - 2025-02-25

  • 升级依赖项

[1.1.0-beta.2] - 2024-08-21

  • 升级依赖项

[1.1.0-beta.1] - 2024-06-06

  • 添加对 TLS 客户端认证的支持
  • 添加 TLS 跳过验证选项
  • 添加对指定自定义 CA 证书的支持

[1.0.0-beta.4] - 2024-03-21

  • 添加对 MQTT 通配符的支持

[1.0.0-beta.3] - 2023-08-17

  • 修复 #44

[1.0.0-beta.2] - 2023-04-25

  • 更新 Plugin SDK 依赖项

[1.0.0-beta.1] - 2022-12-01

  • 首次发布