How does the skill handle the complex directory structure of must-gather data?

The skill is designed to automatically navigate the hash-named subdirectories within a must-gather root, locating the necessary cluster-scoped and namespaced resources automatically.

Do I need the OpenShift CLI installed to use this skill?

No, the skill uses Python-based helper scripts to parse the files within the must-gather directory directly, though the output is formatted to look like standard 'oc' command results.

What kind of network issues can this skill detect?

It analyzes OVN/SDN health, checks for network operator degradation, and reviews PodNetworkConnectivityCheck results to identify routing or connectivity failures.

What is an OpenShift must-gather?

A must-gather is a diagnostic bundle collected from an OpenShift cluster that contains logs, resource definitions (YAML), and status information used for deep troubleshooting.

Can I analyze specific namespaces using this tool?

Yes, many of the scripts, such as the pod and event analyzers, support a --namespace flag to filter results and focus on specific application areas.

Must-Gather Analyzer for OpenShift

Name: Must-Gather Analyzer for OpenShift
Author: openshift-eng

byopenshift-eng

•

Analytics & Monitoring

Analyzes OpenShift must-gather diagnostic data to identify cluster health issues, failing pods, and degraded operators.

About

The Must-Gather Analyzer is a comprehensive diagnostic skill for OpenShift environments that parses complex must-gather directory structures to provide clear, actionable insights. It automates the inspection of cluster operators, pod states, node conditions, and network health using specialized scripts that emulate standard OpenShift CLI outputs. This skill is indispensable for SREs and DevOps engineers needing to quickly root-cause cluster failures or performance degradations by transforming raw YAML data into readable summaries without manual file traversal.

Key Features

etcd cluster health verification including member status, quorum checks, and DB size.
Storage resource monitoring for PersistentVolumes and Claims across the cluster.
Network diagnostic reporting for OVN/SDN connectivity and PodNetworkConnectivityChecks.
29 GitHub stars
Event log parsing to highlight critical warning and error events chronologically.
Automated health analysis for Cluster Operators, Pods, and Nodes across all namespaces.

Use Cases

Troubleshooting 'Degraded' or 'Progressing' Cluster Operators after a failed OpenShift upgrade.
Evaluating node health and resource capacity issues during cluster-wide performance incidents.
Identifying the root cause of CrashLoopBackOff pods or network connectivity failures within a cluster.

About

Key Features

etcd cluster health verification including member status, quorum checks, and DB size.
Storage resource monitoring for PersistentVolumes and Claims across the cluster.
Network diagnostic reporting for OVN/SDN connectivity and PodNetworkConnectivityChecks.
29 GitHub stars
Event log parsing to highlight critical warning and error events chronologically.
Automated health analysis for Cluster Operators, Pods, and Nodes across all namespaces.

Use Cases

Troubleshooting 'Degraded' or 'Progressing' Cluster Operators after a failed OpenShift upgrade.
Evaluating node health and resource capacity issues during cluster-wide performance incidents.
Identifying the root cause of CrashLoopBackOff pods or network connectivity failures within a cluster.