插件 〉MQTT
MQTT
Grafana 的 MQTT 数据源
MQTT 数据源插件使您能够在 Grafana 内可视化流式 MQTT 数据。
要求
MQTT 数据源有以下要求
- 具有服务器或组织管理员角色的 Grafana 用户;请参阅 权限。
- 访问 MQTT 代理。
配置数据源
通过填写以下字段来添加数据源
基本字段
字段 | 描述 |
---|---|
名称 | 此特定 MQTT 数据源的名称 |
URI | MQTT 代理的方案、主机和端口。支持的方案:TCP (tcp://)、TLS (tls://) 和 WebSocket (ws://) |
认证字段
字段 | 描述 |
---|---|
用户名 | (可选)连接到 MQTT 代理时使用的用户名 |
密码 | (可选)连接到 MQTT 代理时使用的密码 |
查询数据源
查询编辑器允许您指定面板将订阅的 MQTT 主题。有关有效主题名称和过滤器的更多信息,请参阅 MQTT v3.1.1 规范。
已知限制
- 插件当前不支持 MQTT CONNECT 数据包的所有选项。
- 此插件自动支持发布数字、字符串、布尔值和 JSON 格式值的 MQTT 主题。可以使用
Extract Fields
转换提取嵌套对象值。 - 此插件在接收到消息时自动附加时间戳。可以使用
Convert field type
转换解析消息正文中包含的时间戳。
安装插件
安装先决条件
请参阅: 构建流式数据源后端插件
满足兼容性要求
此插件当前支持 MQTT v3.1.x。
注意:由于此插件使用 Grafana Live Streaming API,请确保使用 Grafana v8.0+。
安装步骤
- 将插件克隆到您的 Grafana 插件目录。
- 通过运行
yarn install
和yarn build
构建插件。
注意:上述 yarn build
命令可能在非类 Unix 系统(如 Windows)上失败,您可以在 ./package.json
文件中尝试用 rimraf
替换 rm -rf
命令以使其正常工作。
- 运行
mage reloadPlugin
或重启 Grafana 以加载插件。
验证插件是否已安装
- 在 Grafana 左侧菜单中,导航到 Configuration > Data sources。
- 从右上角,点击 Add data source 按钮。
- 在搜索字段中搜索
MQTT
,并将鼠标悬停在 MQTT 搜索结果上。 - 点击 MQTT 的 Select 按钮。
在 Grafana Cloud 上安装 MQTT
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键完成的;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才能在您的 Grafana 中显示。
更多信息,请访问有关 插件安装 的文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但当有更新可用时,您会在 Grafana 中收到通知。
1. 安装数据源
使用 grafana-cli 工具从命令行安装 MQTT
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认目录是 /var/lib/grafana/plugins。有关 cli 工具的更多信息。
2. 配置数据源
从 Grafana 主菜单访问,新安装的数据源可以在 数据源 部分立即添加。
接下来,点击右上角的 添加数据源 按钮。数据源将在 类型 选择框中可供选择。
要查看已安装的数据源列表,点击主菜单中的 插件 项。核心数据源和已安装的数据源都会显示。
更新日志
[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
- 首次发布