> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreflux.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Connected Clients

> View active MQTT client connections and their status in the Coreflux HUB

<Frame caption="Connected Clients view in the Coreflux HUB showing two active MQTT v4 connections with an empty detail panel">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/connected-clients-list.png?fit=max&auto=format&n=W9CJ-kgVY3a3sCeL&q=85&s=9e2031f7df192d61a6e4503317b9efff" alt="Coreflux HUB Connected Clients view listing two active MQTT v4 connections, coreflux-controller-a4d3f1ef at 127.0.0.1:32946 with 20m duration and 31.31 MB traffic and mqtt-explorer-05b06873 at 127.0.0.1:14107 with 40m duration and 36.23 MB traffic, and an empty detail panel on the right prompting to select a client to view details" width="1024" height="639" data-path="images/connected-clients-list.png" />
</Frame>

## Why View Connected Clients?

You need to know which clients are connected to your broker—devices, applications, or the Coreflux HUB itself. The Connected Clients view shows all active MQTT connections with detailed connection info, traffic statistics, session data, and last activity so you can verify connectivity and troubleshoot disconnections.

## When to Use It

* **Verifying device connections** — Confirm that sensors or gateways are connected
* **Troubleshooting** — Check if a client has disconnected or failed to connect
* **Monitoring** — See how many clients are using the broker and their traffic
* **Debugging** — Inspect session state, pending messages, and last activity timestamps

***

## Connected Clients Interface

The Connected Clients view has two panels: a client list on the left and a detail panel on the right. Select a client to view its connection information.

<Frame caption="Connected Clients detail panel for coreflux-controller-a4d3f1ef showing connection information, traffic statistics, and session data">
  <img src="https://mintcdn.com/coreflux/W9CJ-kgVY3a3sCeL/images/connected-clients-detail.png?fit=max&auto=format&n=W9CJ-kgVY3a3sCeL&q=85&s=019514d2c0cf83e8a18be5ca19af153c" alt="Coreflux HUB Connected Clients detail view for the selected coreflux-controller-a4d3f1ef client showing Connection Information with protocol version MQTT v4, client IP 127.0.0.1, source port 32946, full endpoint 127.0.0.1:32946, connected timestamp and 20m duration; Traffic Statistics with 9.39 KB received and 31.17 MB sent; and Session Information with session ID, created timestamp, 0s expiry interval, and 0 pending messages" width="1024" height="639" data-path="images/connected-clients-detail.png" />
</Frame>

***

## Client List (Left Panel)

The left panel lists all clients currently connected to the broker. For each client you see:

| Field                   | Description                                                                 |
| ----------------------- | --------------------------------------------------------------------------- |
| **Client ID**           | Unique identifier for the connection (e.g., `coreflux-controller-0e1e882c`) |
| **Endpoint**            | Client IP and port (e.g., `127.0.0.1:62983`)                                |
| **Connection Duration** | How long the client has been connected (e.g., `40m`)                        |
| **Total Traffic**       | Estimated bytes received and sent combined (e.g., `15.16 MB`)               |
| **Protocol**            | MQTT version (e.g., `MQTT v4`)                                              |

Select a client to view its detailed information in the right panel.

## Client Details (Right Panel)

When you select a client from the list, the right panel shows four sections:

### Connection Information

| Field                | Description                         |
| -------------------- | ----------------------------------- |
| **Protocol Version** | MQTT version (e.g., MQTT v4)        |
| **Source Port**      | Client's source port                |
| **Connected**        | Timestamp when the client connected |
| **Client IP**        | Client IP address                   |
| **Full Endpoint**    | IP:port (e.g., `127.0.0.1:62983`)   |
| **Duration**         | Connection duration (e.g., `40m`)   |

### Traffic Statistics

| Direction    | Fields                   |
| ------------ | ------------------------ |
| **Received** | Bytes, Packets, Messages |
| **Sent**     | Bytes, Packets, Messages |

Use these to see how much data the client has exchanged with the broker.

### Session Information

| Field                | Description                                         |
| -------------------- | --------------------------------------------------- |
| **Session ID**       | Session identifier (typically matches Client ID)    |
| **Created**          | Timestamp when the session was created              |
| **Expiry Interval**  | Session expiry (e.g., `0s` for no expiry)           |
| **Pending Messages** | Number of messages awaiting delivery to this client |
| **Status**           | Connection status (e.g., Connected)                 |

### Last Activity

| Field                    | Description                                           |
| ------------------------ | ----------------------------------------------------- |
| **Last Packet Received** | Timestamp of the last packet received from the client |
| **Last Packet Sent**     | Timestamp of the last packet sent to the client       |
| **Last Non-KeepAlive**   | Timestamp of the last non-keepalive packet            |

## Refreshing the List

The view updates as clients connect and disconnect. Use the refresh control if you need to force an update of the displayed list. The detail panel shows an "Updated" timestamp indicating when the data was last refreshed.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Data Viewer" icon="search" href="/coreflux-hub/mqtt/data-viewer">
    Explore topics and publish messages.
  </Card>

  <Card title="MQTT Protocol" icon="broadcast-tower" href="/mqtt-broker/protocol">
    Understand MQTT client connections and sessions.
  </Card>
</CardGroup>
