物联网系列 - EMQ X Dashboard

429 阅读5分钟

「这是我参与11月更文挑战的第4天,活动详情查看:2021最后一次更文挑战」。

往前文章:

物联网系列 - 初识MQTT

物联网系列 - MQTT协议原理与数据包结构

物联网系列 - EMQ X简介与安装

1. 查看和配置Dashboard

EMQ X 提供了 Dashboard 以方便用户管理设备与监控相关指标。通过 Dashboard可以查看服务器基本信 息、负载情况和统计数据,可以查看某个客户端的连接状态等信息甚至断开其连接,也可以动态加载和卸载指定插 件。除此之外,EMQ X Dashboard 还提供了规则引擎的可视化操作界面,同时集成了一个简易的 MQTT 客户端工 具供用户测试使用。

EMQ X Dashboard 功能由 emqx-dashboard 插件实现,该插件默认处于启用状态,它将在 EMQ X 启动时自 动加载。如果你希望禁用 Dashboard 功能,你可以将 data/loaded_plugins 中的 {emqx_dashboard, true} 修改为 {emqx_dashboard, false} 。

EMQ X Dashboard 是一个 Web 应用程序,你可以直接通过浏览器来访问它,无需安装任何其他软件。 当 EMQ X 成功运行在你的本地计算机上且 EMQ X Dashboard 被默认启用时,通过访问 http://localhost:18083 来查看Dashboard,默认用户名是 admin ,密码是 public 。 如果EMQ X是基于docker容器部署的,可以在容器中的 etc/plugins/emqx_dashboard.conf 中查看或修改 EMQ X Dashboard 的配置。 EMQ X Dashboard 配置项可以分为默认用户与监听器两个部分:

  • 默认用户

      EMQ X Dashboard 可以配置多个用户,但在配置文件中仅支持配置默认用户。
      需要注意的是,一旦您通过 Dashboard 修改了默认用户的密码,则默认用户的相关信息将以您在 Dashboard上的最新改动为准,配置文件中的默认用户配置将被忽略。
    
  • 监听器

      EMQ X Dashboard 支持 HTTP 和 HTTPS 两种 Listener,但默认只启用了监听端口为 18083 的 HTTP
      Listener
    

2. Dashboard界面

EMQ X Dashboard 采用了侧边导航的模式,默认情况下 Dashboard 包含以下一级导航项目:

最新版本EMQ X Broker的Dashboard界面布局略有不同,增加了些导航,但基本都差不多

db1.jpg

我们通过浏览器访问Dashboard之后会看到类似这样的界面:

db2.jpg

3. ADMIN

1. Users

您可以在 Users 页面查看和管理能够访问和操作 Dashboard 的用户:

db3.jpg

2. Settings

目前 EMQ X Dashboard 仅支持修改主题和语言两种设置:

db4.jpg

4. MONITORING

EMQ X Dashboard 提供了非常丰富的数据监控项目,完整地覆盖了服务端与客户端,这些信息都将在 MONITORING 下的页面中被合理地展示给用户。

1. Overview

Overview 作为 Dashboard 的默认展示页面,提供了 EMQ X 当前节点的详细信息和集群其他节点的关键信 息,以帮助用户快速掌握每个节点的状态。

db5.jpg

2. Clients

Clients 页面提供了连接到指定节点的客户端列表,同时支持通过 Client ID 直接搜索客户端。除了查看客 户端的基本信息,您还可以点击每条记录右侧的 Kick Out 按钮踢掉该客户端,注意此操作将断开客户端连接并终 结其会话。

Clients 页面使用快照的方式来展示客户端列表,因此当客户端状态发生变化时页面并不会自动刷新,需要 您手动刷新浏览器来获取最新客户端数据。

db6.jpg

如果你无法在客户端列表获取到你需要的信息,你可以单击 Client ID 来查看客户端的详细信息。

db8.jpg

我们将客户端详情中的各个字段分为了 连接,会话 和 指标 三类,以下为各字段的说明:

  • 连接:

db9.jpg

  • 会话

db10.jpg

  • 指标

db11.jpg

在客户端详情的 Subscriptions 标签页中,您可以查看当前客户端的订阅信息,以及新建或取消订阅:

db12.jpg

3. Topics

展示系统所有的Topic情况

db13.jpg

4. Subscriptions

Subscriptions 页面提供了指定节点下的所有订阅信息,并且支持用户通过 Client ID 查询指定客户端的所 有订阅。

db1.jpg

5. RULE ENGINE

用 EMQ X 的规则引擎可以灵活地处理消息和事件,例如将消息转换成指定格式后存入数据库表或者重新发送 到消息队列等等。为了方便用户更好地使用规则引擎,EMQ X Dashboard 提供了相应的可视化操作页面,您可以 点击 RULE ENGINE 导航项目来访问这些页面。

6. MANAGEMENT

目前 EMQ X Dashboard 的 MANAGEMENT 导航项目下主要包括扩展插件 的监控管理页面和用于 HTTP API 认证 的 AppID 与 AppSerect 的管理页面。

1. Plugins

Plugins 页面列举了 EMQ X 能够发现的所有插件,包括 EMQ X 官方插件与您遵循 EMQ X 官方标准自行开 发的插件,您可以在此页面查看插件当前的运行状态以及随时启停插件。

db1.jpg

2. Listeners

Listeners页面显示了目前监听的协议,地址,最大连接数,当前连接数

db1.jpg

3. Applications

Applications 页面列举了当前已创建的应用,您可以在此页面进行诸如创建应用、临时禁用或启动某个应用 的访问权限等操作。EMQ X 会创建一个 AppID 为 admin ,AppSecret 为 publish 的默认应用方便用户首次访 问:

db1.jpg

您可以点击 Application 页面右上角的 New App 按钮来创建一个新的应用,其中 AppID 与 AppSecret 是必 选项。创建完成后您可以点击 View 按钮来查看应用详情,AppSecret 也会在详情中显示。以下是相关字段的说 明:

db13.jpg

7. TOOLS

目前 EMQ X Dashboard 的 TOOLS 导航项目下主要包括 WebSocket 客户端工具页面以及 HTTP API 速查页 面。

1. Websocket

Websocket 页面为您提供了一个简易但有效的 WebSocket 客户端工具,它包含了连接、订阅和发布功能,同 时还能查看自己发送和接收的报文数据,我们期望它可以帮助您快速地完成某些场景或功能的测试验证:

db1.jpg

db2.jpg

2. HTTP API

HTTP API 页面列举了 EMQ X 目前支持的所有 HTTP API 及其说明:

db1.jpg

今天先介绍到这里,请关注后续文章.