Clients

The Clients page lists the identity information and connection status of each client. Click on Monitor -> Clients in the left-side menu of the deployment to enter the Clients page.

Client List

The list shows clients that are connected or whose sessions have not expired, including their Client ID, Username, IP Address, Keepalive, Clean Start, and Session Expiry Interval.

Search for Clients

1. Enter a Client ID or Username. Both default to Exact matching. To search for part of a value, select Fuzzy from the drop-down list for that field. For example, an exact search for device-1 returns only device-1, while a fuzzy search can also return device-10.
2. Click the search button. Expand the search bar to filter by connection status, connection time, IP address, or other available conditions.
3. Click the refresh button to reload results with the current conditions. Click Reset to clear the conditions and restore Exact matching.

Exact and fuzzy matching do not have an EMQX version requirement.

View More Results

The list shows up to 20 records per page by default and 50 per page when searching. Paging and refreshing retain the search conditions. Clearing the conditions and searching again, or resetting the search, restores 20 records per page.

For EMQX 5.10.4 and later, use the previous and next controls to browse results. The list does not show a total page count or support jumps to arbitrary pages.

Client Details

On the Clients page, selecting a client and clicking the client ID takes you to the client details page. In addition to the basic connection information already displayed on the Clients page, the Client Details page provides some more detailed information for users to view. The Client Details page contains the following tabs:

Information

Displays details such as the protocol version used for the connection, whether to clear the session after the connection ends, and if the status is disconnected, the last time the connection was disconnected. To the right of the connection information, the session information for the connection is shown, including session expiration interval, session creation time, process stack, number of subscriptions, message queue length, inflight window length, and QoS2 message receive queue length.

Metrics

Displays statistical metrics for the current connection in three categories: message count, packets, and traffic sent and received, available for users to view as needed.

Subscriptions

Shows the topics currently subscribed to by the connection. Users can click the add subscription button for relatively simple subscription operations or click the unsubscribe button in the subscription list to cancel a subscription to a particular topic.