rpk update 25.3 (#1465)

paulohtb6 · Feediver1 · web-flow · commit 3bae8a1dd2a7 · 2025-11-18T22:19:30.000-03:00
Co-authored-by: Joyce Fee &lt;102751339+Feediver1@users.noreply.github.com&gt;
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
@@ -301,6 +301,8 @@
 ***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-lint.adoc[]
 ***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-set.adoc[]
 ***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-status.adoc[]
+**** xref:reference:rpk/rpk-cluster/rpk-cluster-connections.adoc[]
+***** xref:reference:rpk/rpk-cluster/rpk-cluster-connections-list.adoc[]
 **** xref:reference:rpk/rpk-cluster/rpk-cluster-health.adoc[]
 **** xref:reference:rpk/rpk-cluster/rpk-cluster-license.adoc[]
 ***** xref:reference:rpk/rpk-cluster/rpk-cluster-license-info.adoc[]
@@ -439,6 +441,7 @@
 ****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-log-level-set.adoc[]
 ****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-log-level.adoc[]
 ****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-print.adoc[]
+***** xref:reference:rpk/rpk-redpanda/rpk-redpanda-config-print.adoc[]
 ***** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions.adoc[]
 ****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions.adoc[]
 ****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions-list.adoc[]
diff --git a/modules/get-started/pages/release-notes/redpanda.adoc b/modules/get-started/pages/release-notes/redpanda.adoc
@@ -49,6 +49,11 @@ You can now generate a security report for your Redpanda cluster using the link:
 
 Redpanda v25.3 implements topic identifiers using 16 byte UUIDs as proposed in https://cwiki.apache.org/confluence/display/KAFKA/KIP-516%3A+Topic+Identifiers[KIP-516^].
 
+== New rpk commands
+
+* **xref:reference:rpk/rpk-cluster/rpk-cluster-connections.adoc[rpk cluster connections]** - Monitor cluster connections and client statistics.
+* **xref:reference:rpk/rpk-redpanda/rpk-redpanda-config-print.adoc[rpk redpanda config print]** - Display node configuration.
+
 == Deprecations
 
 Several TLSv1.2 and TLSv1.3 cipher suites have been deprecated. See xref:upgrade:deprecated/index.adoc[Deprecated Features].
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-force-reset.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-force-reset.adoc
@@ -31,8 +31,6 @@ Redpanda `data` directory).
 
 |-h, --help |- |Help for force-reset.
 
-|--all |- |Include all properties, including tunables.
-
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-get.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-get.adoc
@@ -23,8 +23,6 @@ rpk cluster config get <key> [flags]
 
 |-h, --help |- |Help for get.
 
-|--all |- |Include all properties, including tunables.
-
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-lint.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-lint.adoc
@@ -20,8 +20,6 @@ rpk cluster config lint [flags]
 
 |-h, --help |- |Help for lint.
 
-|--all |- |Include all properties, including tunables.
-
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-set.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-set.adoc
@@ -43,8 +43,6 @@ rpk cluster config set <key> <value> [flags]
 
 |-h, --help |- |Help for set.
 
-|--all |- |Include all properties, including tunables.
-
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-status.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config-status.adoc
@@ -49,8 +49,6 @@ rpk cluster config status [flags]
 
 |-h, --help |- |Help for status.
 
-|--all |- |Include all properties, including tunables.
-
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-config.adoc
@@ -41,8 +41,6 @@ rpk cluster config [command]
 |===
 |*Value* |*Type* |*Description*
 
-|--all |- |Include all properties, including tunables.
-
 |-h, --help |- |Help for config.
 
 |--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`.
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-connections-list.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-connections-list.adoc
@@ -0,0 +1,96 @@
+= rpk cluster connections list
+
+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 the 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/version/11f41833-5783-4f1a-ad64-5957267abd52/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
+
+[,bash]
+----
+rpk cluster connections list [flags]
+----
+
+== 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
+
+[cols="1m,1a,2a"]
+|===
+|*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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
+
+|--profile |string |Profile to use. See xref:reference:rpk/rpk-profile.adoc[`rpk profile`] for more details.
+
+|-v, --verbose |- |Enable verbose logging.
+|===
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-connections.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-connections.adoc
@@ -0,0 +1,34 @@
+= rpk cluster connections
+
+Manage and monitor cluster connections.
+
+== Usage
+
+[,bash]
+----
+rpk cluster connections [command] [flags]
+----
+
+== Aliases
+
+[,bash]
+----
+connections, connection
+----
+
+== Flags
+
+[cols="1m,1a,2a"]
+|===
+|*Value* |*Type* |*Description*
+
+|-h, --help |- |Help for connections.
+
+|--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
+
+|--profile |string |Profile to use. See xref:reference:rpk/rpk-profile.adoc[`rpk profile`] for more details.
+
+|-v, --verbose |- |Enable verbose logging.
+|===
diff --git a/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-quotas-alter.adoc b/modules/reference/pages/rpk/rpk-cluster/rpk-cluster-quotas-alter.adoc
@@ -28,7 +28,7 @@ rpk cluster quotas alter [flags]
 
 |--delete |strings |Key of the quota to delete (repeatable).
 
-|--dry |- |Perform a dry run. Show what would be done, but do not execute the command.
+|--dry |- |Perform a dry run. Validate the request without altering the quotas. Show what would be done, but do not execute the command.
 
 |--format |string |Output format. Possible values: `json`, `yaml`, `text`, `wide`, `help`. Default: `text`.
 
diff --git a/modules/reference/pages/rpk/rpk-debug/rpk-debug-bundle.adoc b/modules/reference/pages/rpk/rpk-debug/rpk-debug-bundle.adoc
@@ -129,7 +129,7 @@ written (default `./<timestamp>-bundle.zip`).
 
 |--timeout |duration |The amount of time to wait for child commands to
 execute, for example `30s` (30 seconds) or `1.5m` (90 seconds). (default
-`31s`).
+`1m0s`).
 
 |--upload-url |string |If provided, where to upload the bundle in
 addition to creating a copy on disk.
diff --git a/modules/reference/pages/rpk/rpk-debug/rpk-debug-remote-bundle-start.adoc b/modules/reference/pages/rpk/rpk-debug/rpk-debug-remote-bundle-start.adoc
@@ -47,6 +47,10 @@ rpk debug remote-bundle start [flags]
 
 |-p, --partition |stringArray |Comma-separated partition IDs. When provided, `rpk` saves extra Admin API requests for those partitions. See the help for extended usage.
 
+|--wait |- |Wait for completion of remote bundle before returning.
+
+|--wait-timeout |duration |How long to wait locally for remote-bundle completion if `--wait` is specified. Collection on cluster will continue regardless. (default: `5m0s`).
+
 |--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
diff --git a/modules/reference/pages/rpk/rpk-group/rpk-group-describe.adoc b/modules/reference/pages/rpk/rpk-group/rpk-group-describe.adoc
@@ -6,9 +6,9 @@ Describe group offset status & lag.
 This command describes group members, calculates their lag, and prints detailed
 information about the members.
 
-The `--regex` flag (`-r`) parses arguments as regular expressions
+The `COORDINATOR-PARTITION` column indicates the partition in the `__consumer_offsets` topic responsible for the group, if topic details are available; run with `--verbose` for more information if it is missing.
 
-and describes groups that match any of the expressions.
+The `--regex` flag (`-r`) parses arguments as regular expressions and describes groups that match any of the expressions.
 
 == Usage
 
@@ -23,6 +23,8 @@ rpk group describe [GROUPS...] [flags]
 |===
 |*Value* |*Type* |*Description*
 
+|--format |string |Output format. Possible values: `json`, `yaml`, `text`, `wide`, `help`. Default: `text`.
+
 |-h, --help |- |Help for describe.
 
 |-i, --instance-ID |- |Include each group member's instance ID.
diff --git a/modules/reference/pages/rpk/rpk-profile/rpk-profile-create.adoc b/modules/reference/pages/rpk/rpk-profile/rpk-profile-create.adoc
@@ -16,6 +16,7 @@ profile from the existing profile with any active environment variables or flags
 * You can use `--from-cloud` to generate a profile from an existing cloud cluster
 ID. Note that you must be logged in with `rpk cloud login` first. The special
 value `prompt` will prompt to select a cloud cluster to create a profile for.
+* For serverless clusters that support both public and private networking, you will be prompted to select a network type unless you specify `--serverless-network`. To avoid prompts in automation, explicitly set `--serverless-network` to `public` or `private`.
 * You can use `--set key=value` to directly set fields. The key can either be
 the name of a `-X` flag or the path to the field in the profile's YAML format.
 For example, using `--set tls.enabled=true` OR `--set kafka_api.tls.enabled=true`
diff --git a/modules/reference/pages/rpk/rpk-profile/rpk-profile-print.adoc b/modules/reference/pages/rpk/rpk-profile/rpk-profile-print.adoc
@@ -5,6 +5,8 @@ Print `rpk` profile configuration.
 
 If no name is specified, this command prints the current profile as it exists in the `rpk.yaml` file.
 
+To print both the profile as it exists in the `rpk.yaml` file and the current profile as it is loaded in `rpk` with internal defaults, user-specified flags, and environment variables applied, use the `-v/--verbose` flag.
+
 == Usage
 
 [,bash]
diff --git a/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-config-print.adoc b/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-config-print.adoc
@@ -0,0 +1,36 @@
+= rpk redpanda config print
+
+Display the selected node configuration.
+
+== Usage
+
+[,bash]
+----
+rpk redpanda config print [flags]
+----
+
+== Aliases
+
+[,bash]
+----
+print, dump
+----
+
+== Flags
+
+[cols="1m,1a,2a"]
+|===
+|*Value* |*Type* |*Description*
+
+|--host |string |A hostname or the index (0-based) of the configured Kafka broker list.
+
+|-h, --help |- |Help for print.
+
+|--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 xref:reference:rpk/rpk-x-options.adoc[`rpk -X`] or execute `rpk -X help` for inline detail or `rpk -X list` for terser detail.
+
+|--profile |string |Profile to use. See xref:reference:rpk/rpk-profile.adoc[`rpk profile`] for more details.
+
+|-v, --verbose |- |Enable verbose logging.
+|===
diff --git a/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-config-set.adoc b/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-config-set.adoc
@@ -3,7 +3,7 @@
 
 include::reference:partial$unsupported-os-rpk.adoc[]
 
-Set configuration values, such as the redpanda node ID or the list of seed servers
+Set node configuration values, such as the list of seed servers or the ports that various APIs listen on.
 
 This command modifies the `redpanda.yaml` you have locally on disk.
 
diff --git a/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-start.adoc b/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-start.adoc
@@ -96,6 +96,8 @@ addresses to bind to.
 |--mode |string |Sets well-known configuration properties for
 development or test environments; use `--mode help` for more info.
 
+|--node-tuner-state-path |string |Alternative path to read the node tuner state file from (if exists).
+
 |--pandaproxy-addr |strings |A comma-separated list of Pandaproxy
 listener addresses to bind to.
 
diff --git a/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-tune-list.adoc b/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-tune-list.adoc
@@ -35,11 +35,13 @@ rpk redpanda tune list [flags]
 (e.g. /var/vectorized/redpanda/); usually your XFS file system on an NVMe
 SSD device.
 
-|-d, --disks |strings |Lists of devices to tune f.e. 'sda1'.
+|-d, --disks |strings |Lists of devices to tune (for example, 'sda1').
 
 |-h, --help |- |Help for list.
 
-|-m, --mode |string |Operation Mode: one of: [sq, sq_split, mq].
+|-m, --mode |string |Operation Mode. Acceptable values: (`sq`, `sq_split`, `mq`).
+
+|--node-tuner-state-path |string |Alternative path to write the tuner state file to (default: `/var/run/redpanda_node_tuner_state.yaml`).
 
 |-n, --nic |strings |Network Interface Controllers to tune.
 
diff --git a/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-tune.adoc b/modules/reference/pages/rpk/rpk-redpanda/rpk-redpanda-tune.adoc
@@ -82,7 +82,9 @@ SSD device.
 
 |-h, --help |- |Help for tune.
 
-|-m, --mode |string |Operation Mode: one of: [sq, sq_split, mq].
+|-m, --mode |string |Operation Mode. Acceptable values: (`sq`, `sq_split`, `mq`).
+
+|--node-tuner-state-path |string |Alternative path to write the tuner state file to (default: `/var/run/redpanda_node_tuner_state.yaml`).
 
 |-n, --nic |strings |Network Interface Controllers to tune.
 
diff --git a/modules/reference/pages/rpk/rpk-registry/rpk-registry-mode-set.adoc b/modules/reference/pages/rpk/rpk-registry/rpk-registry-mode-set.adoc
diff --git a/modules/reference/pages/rpk/rpk-registry/rpk-registry-schema-create.adoc b/modules/reference/pages/rpk/rpk-registry/rpk-registry-schema-create.adoc
diff --git a/modules/reference/pages/rpk/rpk-topic/rpk-topic-create.adoc b/modules/reference/pages/rpk/rpk-topic/rpk-topic-create.adoc
diff --git a/modules/reference/partials/rpk-cloud/rpk-cloud-cluster-select.adoc b/modules/reference/partials/rpk-cloud/rpk-cloud-cluster-select.adoc
diff --git a/modules/reference/partials/rpk-cloud/rpk-cloud-mcp-install.adoc b/modules/reference/partials/rpk-cloud/rpk-cloud-mcp-install.adoc
