# rpk k8s multicluster bundle

> 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 k8s multicluster bundle
latest-redpanda-tag: v26.2.1
latest-console-tag: v3.10.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: July 28, 2027
latest-connect-version: 4.105.0
docname: rpk/rpk-k8s/rpk-k8s-multicluster-bundle
page-component-name: streaming
page-version: "26.2"
page-component-version: "26.2"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-k8s/rpk-k8s-multicluster-bundle.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/main/modules/reference/pages/rpk/rpk-k8s/rpk-k8s-multicluster-bundle.adoc
description: Collects environment data from each Kubernetes cluster in a Redpanda Stretch Cluster deployment and packages it into a ZIP file for support. This is the operator-side counterpart to <code>rpk debug bundle</code>, which collects data from the Redpanda brokers themselves.
page-git-created-date: "2026-07-22"
page-git-modified-date: "2026-08-03"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/current/reference/rpk/rpk-k8s/rpk-k8s-multicluster-bundle.md -->

Collects environment data from each Kubernetes cluster in a Redpanda Stretch Cluster deployment and packages it into a ZIP file for support. This is the operator-side counterpart to `rpk debug bundle`, which collects data from the Redpanda brokers themselves.

By default, only one Kubernetes context is required. The bundle command discovers peer clusters from labelled cache Secrets stored by the operator’s raft-bootstrap flow on the starting cluster, so the tool stays useful when one of the peer clusters is down. Pass multiple `--context` flags to bypass discovery and diagnose exactly that set.

> 📝 **NOTE**
>
> This command was introduced in k8s version 26.2.1.

## [](#usage)Usage

```bash
rpk k8s multicluster bundle [flags]
```

## [](#examples)Examples

This section provides examples of how to use `rpk k8s multicluster bundle`.

Single context: discover peers from the starting cluster

```bash
rpk k8s multicluster bundle --kubeconfig /path/to/kubeconfig
```

Specific starting cluster from the default kubeconfig

```bash
rpk k8s multicluster bundle --context cluster-a
```

Bypass discovery and bundle the listed clusters directly

```bash
rpk k8s multicluster bundle --context cluster-a --context cluster-b --context cluster-c
```

Write to a specific path

```bash
rpk k8s multicluster bundle --context cluster-a -o /tmp/operator-bundle.zip
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --context | strings | Kubernetes contexts (repeatable; if omitted with --kubeconfig, all contexts in the file are used). |
| --include-private-keys | bool | Include TLS private keys and cached peer kubeconfigs in serialised Secrets. Off by default. |
| --kubeconfig | string | Path to a kubeconfig file (all contexts in the file are used unless --context is also specified). |
| --logs-size-limit | string | Per-container log byte cap (human-readable, for example, "5M", "10MiB", "1G"; "0" disables the cap). |
| --logs-tail-lines | int | Per-container log tail-line cap (0 disables the cap). |
| --metrics-interval | duration | Interval between successive /metrics samples (for example, 10s, 1m). Must be > 0. |
| --metrics-samples | int | Number of /metrics samples taken per cluster (>= 2). Lets investigators compute counter rates post-hoc. |
| --name-override | stringArray | Override the TLS secret prefix for a context in context=prefix format (repeatable; defaults to the context name). |
| --namespace | string | Namespace for operator resources. |
| -o, --output | string | Path to write the bundle zip. |
| --service-name | string | Operator deployment label selector value (app.kubernetes.io/name). |
| --skip-logs | bool | Skip operator pod log collection. |
| --skip-metrics | bool | Skip operator /metrics scrape. |
| -v, --verbose | bool | Print per-step progress to stderr (use to diagnose slow runs / hangs). |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |