Dashboard

Introduction

EMQ X Broker provides Dashboard to facilitate users to manage equipment and monitor related indicators. Through Dashboard, you can view the basic information of the server, load and statistical data, you can view the connection status of a client and even disconnect it, and you can also dynamically load and unload specified plug-ins. In addition, EMQ X Dashboard also provides a visual operation interface of the rule engine, and also integrates a simple MQTT client tool for user testing.

Start Dashboard

The EMQ X Dashboard function is implemented by the emqx-dashboard plugin, which is enabled by default, and it will be automatically loaded when the EMQ X Broker starts. If you wish to disable the Dashboard function, you can modify {emqx_dashboard, true} in data/loaded_plugins to {emqx_dashboard, false}.

{emqx_dashboard, true}.

View Dashboard

EMQ X Dashboard is a web application, and you can access it directly through the browser without installing any other software.

When EMQ X Broker runs successfully on your local computer and EMQ X Dashboard is enabled by default, you can visit http://localhost:18083 to view your Dashboard. The default user name is admin and the password is public .

Configure Dashboard

You can view or modify the configuration of EMQ X Dashboard in etc/plugins/emqx_dashboard.conf. Note that etc here does not refer to the system directory, see directory structure for details.

EMQ X Dashboard configuration items can be divided into two parts of default user and listener:

Default User

EMQ X Dashboard can configure multiple users, but only the default user can be configured in the configuration file.

It should be noted that once you change the password of the default user through Dashboard, the relevant information of the default user will be based on your latest changes on the Dashboard, and the default user configuration in the configuration file will be ignored.

Listeners

EMQ X Dashboard supports both HTTP and HTTPS Listeners, but only HTTP Listeners with a listening port of 18083 are enabled by default. For the introduction of Listeners, please refer to Configuration Instructions.

For the detailed configuration item description of Dashboard, please refer to Configuration Item.

Dashboard interface

In order to enable users to quickly locate and switch the current position during operation and browsing, EMQ X Dashboard adopts the mode of side navigation. By default, Dashboard includes the following first-level navigation items:

Navigation Description
MONITORING Provide display pages for server and client monitoring information
RULE ENGINE Provide a visual operation page of the rule engine
MANAGEMENT Provide management pages for extensions of plugins and applications
TOOLS Provide WebSocket client tool and HTTP API quick check page
ADMIN Provide Dashboard user management and display settings pages

MONITORING

EMQ X Dashboard provides a very rich data monitoring project, that completely covers the server and client. All of this information will be reasonably displayed to users on the page under MONITORING.

Overview

As the default display page of Dashboard, Overview provides detailed information of EMQ X Broker ’s current nodes and key information of other nodes in the cluster to help users quickly get the status of each node.

image

Clients

The Clients page provides a list of clients connected to the specified node, and also supports direct client search via Client ID. In addition to viewing the basic information of the client, you can also click the Kick Out button on the right side of each record to kick out the client. Note that this operation will disconnect the client and terminate its session.

The Clients page uses a snapshot to display the client list. Therefore, when the client status changes, the page does not automatically refresh, and you need to manually refresh the browser to get the latest client data.

image

If you can not get the information you need in the client list, you can click Client ID to view the detailed information of the client.

image

We divided the various fields in the client details into connection, session and metrics. The following is the description of each field:

Connection

Field Description
Node Name of the node to which the client connects
Client ID Client ID
Username The user name used when the client connects, for security reasons, the password will not be displayed
Protocol The protocol name and version used by the client
IP Address The client's network IP address, which can be IPv4 or IPv6
Port Client source port
Is Bridge Indicate whether the client connects via bridge
Connected At Client connection time
Disconnected At Client offline time
Connection Status Client connection status
Zone Indicates the configuration group used by the client
Keepalive Keep-alive time, unit: second

Session

Field Description
Clean Session Indicates whether the client has used a brand new session
Expiry Interval Session expiration interval, unit: seconds
Created At Session creation time
Subscriptions Count Current number of subscriptions
Maximum Subscriptions Count Maximum number of subscriptions allowed
Inflight Window Size Current inflight window size, please refer to InFlight Window and Message Queue
Maximum Inflight Window Size Maximum size of inflight window
Message Queue Size Current message queue size, please refer to InFlight Window and Message Queue
Maximum Message Queue Size Maximum size of message queue
Uncomfirmed PUBREC Packets Number of unconfirmed PUBREC messages
Maximum Uncomfirmed PUBREC Packets Maximum number of unconfirmed PUBREC messages allowed

Metric

Field Description
Number of Bytes Received Number of bytes received by EMQ X Broker (same below)
Number of TCP Packets Received Number of TCP Packets Received
Number of MQTT Packets Received Number of MQTT Packets Received
Number of PUBLISH Packets Received Number of PUBLISH Packets Received
Number of Bytes Sent Number of Bytes Sent
Number of TCP Packets Sent Number of TCP Packets Sent
Number of MQTT Packets Sent Number of MQTT Packets Sent
Number of PUBLISH Packets Sent Number of PUBLISH Packets Sent

In the Subscriptions tab of the client details, you can view the subscription information of the current client, and create or cancel subscriptions:

image

Subscriptions

The Subscriptions page provides all subscription information under the specified node, and supports users to query all subscriptions of the specified client through the Client ID.

image

RULE ENGINE

The rule engine of EMQ X Broker can flexibly process messages and events, such as converting the message into a specified format and storing it in a database table or resending it to the message queue. In order to facilitate users to better use the rules engine, EMQ X Dashboard provides corresponding visual operation pages, and you can click the RULE ENGINE navigation item to access these pages.

Due to the complexity of the related concepts of the rule engine, the operations involved may occupy a considerable amount of space. Considering your reading experience, we will introduce the rule engine through additional documents of rule-engine.

MANAGEMENT

Currently, the EMQ X Dashboard's MANAGEMENT navigation item mainly includes an monitoring management page for extension plug-in and management page of AppID and AppSerect for HTTP API authentication.

Plugins

The Plugins page lists all the plug-ins that EMQ X Broker can find, including the official plug-ins of EMQ X and the plug-ins that you developed in accordance with the official standards of EMQ X. You can check the current running status of the plug-ins and start and stop the plug-ins at any time on this page.

image

You can see that in addition to emqx-dashboard, EMQ X Broker will also start other 4 plugins by default:

image

Applications

The Applications page lists the currently created applications. You can perform operations such as creating applications, temporarily disabling or starting access permissions for an application on this page. EMQ X Broker will create a default application with AppID of admin and AppSecret of publish for users to access for the first time:

image

You can click the New App button in the upper right corner of the Application page to create a new application, where AppID and AppSecret are required. After the creation is complete, you can click the View button to view the application details, and AppSecret will also be displayed in the details. The following is a description of the relevant fields:

Field Description
AppID It is used to distinguish different applications, so it is not repeatable. When creating an application, Dashboard will automatically generate a random suggested application ID for you
AppName It can be repeated, but for your own convenience, we do not recommend using a duplicate application name
AppSecret The application key assigned by EMQ X Broker that can be viewed in the application details
Expired date The expiration time of the application, the default is to never expire
Remark Your description of the application, facilitate later management
Status There are only two types of application status: Allowed and Denied. In Denied status, EMQ X Broker will deny the access request of HTTP API using the AppID and App Secret

TOOLS

Currently, the TOOLS navigation item of EMQ X Dashboard mainly includes WebSocket client tool page and HTTP API quick check page.

Websocket

The Websocket page provides you with a simple but effective WebSocket client tool, which includes connection, subscription and publishing functions. At the same time, you can view the message data you send and receive, we hope it can help you quickly complete test verification of certain scenarios or functions:

image

HTTP API

The HTTP API page lists all the HTTP APIs currently supported by EMQ X Broker and their descriptions:

image

ADMIN

Users

You can view and manage users who can access and operate Dashboard on the Users page:

image

Settings

Currently, EMQ X Dashboard only supports the modification of the topic and language settings:

image

Help

If you encounter any problems in using EMQ X Broker, we provide you with links to FAQ and other documents on the Help page. If our existing documents still cannot solve your problem, you can go to our open source community on Github to consult our technical staff.

image

results matching ""

    No results matching ""