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

•

Analíticas y Monitorización

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

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.

Características Principales

01etcd cluster health verification including member status, quorum checks, and DB size.

02Storage resource monitoring for PersistentVolumes and Claims across the cluster.

03Network diagnostic reporting for OVN/SDN connectivity and PodNetworkConnectivityChecks.

0429 GitHub stars

05Event log parsing to highlight critical warning and error events chronologically.

06Automated health analysis for Cluster Operators, Pods, and Nodes across all namespaces.

Casos de Uso

01Troubleshooting 'Degraded' or 'Progressing' Cluster Operators after a failed OpenShift upgrade.

02Evaluating node health and resource capacity issues during cluster-wide performance incidents.

03Identifying the root cause of CrashLoopBackOff pods or network connectivity failures within a cluster.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openshift-eng/ai-helpers must-gather-analyzer

For use in Claude.ai and ChatGPT

Características Principales

01etcd cluster health verification including member status, quorum checks, and DB size.

02Storage resource monitoring for PersistentVolumes and Claims across the cluster.

03Network diagnostic reporting for OVN/SDN connectivity and PodNetworkConnectivityChecks.

0429 GitHub stars

05Event log parsing to highlight critical warning and error events chronologically.

06Automated health analysis for Cluster Operators, Pods, and Nodes across all namespaces.

Casos de Uso

01Troubleshooting 'Degraded' or 'Progressing' Cluster Operators after a failed OpenShift upgrade.

02Evaluating node health and resource capacity issues during cluster-wide performance incidents.

03Identifying the root cause of CrashLoopBackOff pods or network connectivity failures within a cluster.