skills.rest
openshift-eng
openshift-engCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

LVMS Analyzer

Diagnose LVMS storage issues from must-gather data into a structured report.

112|305|Updated Oct 10, 2025
Search Tags:#troubleshooting#analysis#kubernetes#must-gather#diagnostics#storage#lvms
One-click install
npx skills add https://github.com/openshift-eng/ai-helpers --skill lvms-analyzer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: LVMS Analyzer
Source: https://github.com/openshift-eng/ai-helpers/tree/main/plugins/lvms/skills/lvms-analyzer
Command: npx skills add https://github.com/openshift-eng/ai-helpers --skill lvms-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the analysis of LVMS (Logical Volume Manager Storage) must-gather data to quickly identify and troubleshoot complex storage infrastructure problems.

Core Features & Use Cases

  • Comprehensive Storage Analysis: Automatically analyzes LVMCluster health, volume groups, PVC/PV status, and operator components in one comprehensive workflow.
  • Root Cause Identification: Correlates related issues across components to pinpoint the underlying cause of storage failures.
  • Use Case: Imagine you have a production cluster with PVCs stuck in Pending state. Use this Skill to automatically identify that duplicate volume group names are preventing VG extension on specific nodes.

Quick Start

Analyze the LVMS must-gather data in the directory './must-gather' to identify storage issues and their root causes.

Frequently Asked Questions about LVMS Analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose LVMS storage issues from must-gather data?▼

LVMS Analyzer automates diagnosis of Logical Volume Manager Storage must-gather data to identify storage infrastructure problems. It analyzes LVMCluster health, volume groups, PVC/PV status, and operator components, correlating issues across components to pinpoint root causes like duplicate volume group names blocking VG extension.

What does LVMS Analyzer require to run?▼

LVMS Analyzer requires Python 3.6 or later, PyYAML dependency, a must-gather directory containing the correct LVMS namespace (openshift-lvm-storage or openshift-storage), and oc_output resources including lvmcluster.yaml, lvmvolumegroup files, events, and pods for structured diagnostic output.

Can I use LVMS Analyzer for offline troubleshooting?▼

Yes. LVMS Analyzer performs offline analysis of must-gather data, enabling you to diagnose storage issues asynchronously without direct cluster access. It automatically detects namespaces and generates comprehensive diagnostic reports covering LVMCluster readiness, volume group creation, operator health, and TopoLVM CSI driver issues.

What storage problems can LVMS Analyzer identify?▼

LVMS Analyzer identifies PVCs stuck in Pending state, LVMCluster readiness failures, volume group creation issues, operator health problems, TopoLVM CSI driver failures, and related component issues. It correlates data across resources to reveal underlying causes blocking storage provisioning.

Does LVMS Analyzer support both openshift-lvm-storage and openshift-storage namespaces?▼

Yes. LVMS Analyzer automatically detects and analyzes LVMS must-gather data from both openshift-lvm-storage and openshift-storage namespaces, covering LVMCluster resources, volume groups, and operator components across either configuration.

Related Skills

Explore More Software Engineering Skills→
Snowflake-LabsSnowflake-Labs
12

read-ors-configuration

A concise summary of your roleplay character: name,</name> personality, and/or behavior, formatted as a single string sentence. Typically不超过50字，此处省略

Official
Intermediate
multigresmultigres
270

diagnose_with_observer

Query the multigres observer API to diagnose cluster health and produce a structured bug report.

Official
Advanced
X-McKayX-McKay
3

diagnose-storage-issue

Diagnose Kubernetes storage issues by checking PVC binding, storage classes, and volume mounts.

Community
Intermediate
openoctaopenocta
3.1k

k8s-ops-expert

Manage Kubernetes clusters, troubleshoot pods, and deploy applications via Helm.

Community
Advanced