# rpk cluster connections list

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk cluster connections list
latest-redpanda-tag: v25.3.11
latest-console-tag: v3.7.3
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: November 19, 2026
latest-connect-version: 4.93.0
docname: rpk/rpk-cluster/rpk-cluster-connections-list
page-component-name: streaming
page-version: "25.3"
page-component-version: "25.3"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cluster/rpk-cluster-connections-list.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/25.3/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-connections-list.adoc
page-git-created-date: "2025-11-19"
page-git-modified-date: "2025-11-19"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/25.3/reference/rpk/rpk-cluster/rpk-cluster-connections-list.md -->

Display statistics about current Kafka connections.

This command displays a table of active and recently closed connections within the cluster.

Use filtering and sorting to identify the connections of the client applications that you are interested in. See `--help` for the list of filtering arguments and sorting arguments.

In addition to filtering shorthand CLI arguments (For example, `--client-id`, `--state`), you can also use the `--filter-raw` and `--order-by` arguments that take string expressions. To understand the syntax of these arguments, refer to the Admin API docs of the filter and order-by fields of the [ListKafkaConnections endpoint](https://docs.redpanda.com/api/doc/admin/v2/operation/operation-redpanda-core-admin-v2-clusterservice-listkafkaconnections).

By default only a subset of the per-connection data is printed. To see all of the available data, use `--format=json`.

## [](#usage)Usage

```bash
rpk cluster connections list [flags]
```

## [](#examples)Examples

List connections ordered by their recent produce throughput:

```bash
rpk cluster connections list --order-by="recent_request_statistics.produce_bytes desc"
```

List connections ordered by their recent fetch throughput:

```bash
rpk cluster connections list --order-by="recent_request_statistics.fetch_bytes desc"
```

List connections ordered by the time that they’ve been idle:

```bash
rpk cluster connections list --order-by="idle_duration desc"
```

List connections ordered by those that have made the least requests:

```bash
rpk cluster connections list --order-by="total_request_statistics.request_count asc"
```

List extended output for open connections in JSON format:

```bash
rpk cluster connections list --format=json --state="OPEN"
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --client-id | string | Filter results by the client ID. |
| --client-software-name | string | Filter results by the client software name. |
| --client-software-version | string | Filter results by the client software version. |
| --filter-raw | string | Filter connections based on a raw query (overrides other filters). |
| --format | string | Output format. Possible values: json, yaml, text, wide, help. Default: text. |
| -g, --group-id | string | Filter by client group ID. |
| -h, --help | - | Help for connections list. |
| -i, --idle-ms | int | Show connections idle for more than i milliseconds. |
| --ip-address | string | Filter results by the client IP address. |
| --limit | int32 | Limit how many records can be returned (default 20). |
| --order-by | string | Order the results by their values. See Examples. |
| -s, --state | string | Filter results by state. Acceptable values: OPEN, CLOSED. |
| -u, --user | string | Filter results by a specific user principal. |
| --config | string | Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail. |
| --profile | string | Profile to use. See rpk profile for more details. |
| -v, --verbose | - | Enable verbose logging. |