eclipse-che · rohanKanojia · Jul 29, 2026 · Jul 31, 2026 · Jul 31, 2026
@@ -26,8 +26,9 @@
 **** xref:creating-a-telemetry-plugin.adoc[]
 *** xref:configuring-server-logging.adoc[]
 *** xref:collecting-logs-using-chectl.adoc[]
-**** xref:monitoring-the-dev-workspace-operator.adoc[]
-**** xref:monitoring-che.adoc[]
+*** xref:troubleshoot:collecting-diagnostics-with-must-gather.adoc[]
+*** xref:monitoring-the-dev-workspace-operator.adoc[]
+*** xref:monitoring-che.adoc[]
 ** xref:configuring-networking.adoc[]
 *** xref:configuring-network-policies.adoc[]
 *** xref:configuring-che-hostname.adoc[]

@@ -42,3 +42,4 @@ Logs are automatically collected during the {prod-short} installation when insta
 .Additional resources
 
 * {link-prod-cli-documentation}
+* xref:troubleshoot:collecting-diagnostics-with-must-gather.adoc[]
@@ -11,5 +11,6 @@ To configure {prod-short} observability features, see:
 
 * xref:configuring-server-logging.adoc[]
 * xref:collecting-logs-using-chectl.adoc[]
+* xref:troubleshoot:collecting-diagnostics-with-must-gather.adoc[]
 * xref:monitoring-the-dev-workspace-operator.adoc[]
 * xref:monitoring-che.adoc[]
@@ -11,6 +11,7 @@
 ** xref:troubleshooting-devfile-issues.adoc[]
 * Troubleshoot the platform
 ** xref:viewing-workspace-logs-in-the-openshift-console.adoc[]
+** xref:collecting-diagnostics-with-must-gather.adoc[]
 ** xref:troubleshooting-workspace-startup-failures.adoc[]
 ** xref:troubleshooting-network-problems.adoc[]
 ** xref:troubleshooting-oauth-configuration.adoc[]
@@ -0,0 +1,47 @@
+:_content-type: PROCEDURE
+:description: On {ocp}, collect {prod} and DevWorkspace diagnostic data with must-gather for support and troubleshooting.
+:keywords: troubleshoot, must-gather, diagnostics, logs, support, openshift
+:navtitle: Collect diagnostics with must-gather
+:page-aliases:
+
+[id="collecting-diagnostics-with-must-gather"]
+= Collect diagnostics with must-gather
+
+[role="_abstract"]
+On {ocp} clusters, you can collect a diagnostic snapshot of the {prod-short} Operator, {devworkspace}-based Cloud Development Environments, and related cluster state by using the {prod-short} community-supported must-gather image with `oc adm must-gather`. Share this dump with others so they can help troubleshoot the issue.
+
+.Prerequisites
+
+* You are running {prod-short} on an {ocp} cluster.
+* The `oc` OpenShift CLI is installed and configured for the target cluster. See link:https://docs.openshift.com/container-platform/{ocp4-ver}/cli_reference/openshift_cli/getting-started-cli.html[Getting started with the OpenShift CLI].
+* You have `cluster-admin` permissions on the cluster.
+* {prod-short} is installed on the cluster.
+
+.Procedure
+
+. Collect {prod-short} and {devworkspace} diagnostics:
++
+[source,bash]
+----
+$ oc adm must-gather --image=quay.io/che-incubator/must-gather:latest
+----
++
+The command creates a local directory named `must-gather.local.<id>` that contains the diagnostic dump.
++
+[IMPORTANT]
+====
+This must-gather image focuses on {prod-short}, {devworkspace}, and related components.
+To collect full cluster data, run `oc adm must-gather` without specifying a custom image.
+====
+
+. Optional: Write the output to a specific directory:
++
+[source,bash,subs="+quotes"]
+----
+$ oc adm must-gather --image=quay.io/che-incubator/must-gather:latest \
+  --dest-dir=__<directory_name>__
+----
+
+.Verification
+
+* A local `must-gather.local.<id>` directory (or the directory you passed to `--dest-dir`) exists and contains the diagnostic dump.
@@ -19,6 +19,9 @@ The first step for any problem is to check the Cloud Development Environment log
 | Need to check logs
 | View logs from the CLI, the {orch-name} console, or the editor to identify errors and warnings.
 
+| Need a full diagnostic dump for support on {ocp}
+| On {ocp} clusters, collect {prod-short} Operator, {devworkspace}, and related cluster state with must-gather. See xref:collecting-diagnostics-with-must-gather.adoc[].
+
 | Cloud Development Environment fails to start
 | Diagnose pod scheduling, image pull, DevWorkspace, and resource quota errors from the dashboard or operator logs.
 

@@ -74,5 +74,6 @@ Diagnose and resolve common workspace startup failures based on error symptoms a
 
 .Additional resources
 
+* xref:collecting-diagnostics-with-must-gather.adoc[]
 * xref:optimize:configuring-machine-autoscaling.adoc[]
 * xref:install:calculating-che-resource-requirements.adoc[]
Original file line number	Diff line number	Diff line change
Expand Up		@@ -42,3 +42,4 @@ Logs are automatically collected during the {prod-short} installation when insta
		.Additional resources

		* {link-prod-cli-documentation}
		* xref:troubleshoot:collecting-diagnostics-with-must-gather.adoc[]