metrics-query-cookbook

Provide curated PromQL queries and metric references for OpenShift cluster monitoring.

Updated Mar 8, 2026

Search Tags:#monitoring #metrics #kubernetes #observability #promql #ceph #mtv

Ready to run

npx skills add https://github.com/yaacov/mtv-agent --skill metrics-query-cookbook

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: metrics-query-cookbook
Source: https://github.com/yaacov/mtv-agent/tree/main/mtv_agent/data/skills/metrics-query-cookbook
Command: npx skills add https://github.com/yaacov/mtv-agent --skill metrics-query-cookbook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive catalog of pre-written PromQL queries and references, enabling users to quickly retrieve specific metrics and understand their cluster's performance without needing to be PromQL experts.

Core Features & Use Cases

Metric Discovery: Easily find and use exact metric names and labels for Ceph, ODF, OVN-Kubernetes, KubeVirt, and MTV migrations.
Query Examples: Offers ready-to-use queries for cluster health, storage capacity, network traffic, pod statistics, and migration performance.
Use Case: A site reliability engineer needs to quickly check the current network throughput of all active MTV migrations. They can use this Skill to find the mtv_net_throughput preset and execute it.

Quick Start

Use the metrics-query-cookbook skill to get the cluster CPU utilization percentage.

Frequently Asked Questions about metrics-query-cookbook

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

FAQPage Schema

How do I write PromQL queries to monitor OpenShift cluster health and performance?▼

To monitor ODF storage capacity with PromQL, you can use curated query references that target Ceph metrics within OpenShift. This Skill provides preset queries to retrieve exact metric names and labels for analyzing storage capacity and operational health.

Can I track KubeVirt and MTV migration network throughput using PromQL?▼

Yes, you can find exact metric names and labels for OVN-Kubernetes network traffic using curated PromQL references. This Skill catalogs specific metrics to help you retrieve network traffic data and troubleshoot cluster networking issues.

What PromQL metrics are available for ODF and Ceph storage capacity monitoring?▼

To get cluster CPU utilization, you can use the metrics-query-cookbook Skill to find and execute a preset PromQL query. It leverages `metrics_read` and `metrics_help` MCP server tools to facilitate efficient data retrieval for performance analysis.

Do I need prior PromQL expertise to use these OpenShift monitoring queries?▼

No, you do not need PromQL expertise to use these OpenShift monitoring queries. This Skill provides a comprehensive catalog of pre-written queries and metric references, enabling users to quickly retrieve specific metrics and understand cluster performance.

How do I explore available metric names and labels for OpenShift observability?▼

You can explore available metric names and labels for OpenShift observability using the `metrics_help` MCP server tool. This Skill facilitates metric discovery for Ceph, ODF, OVN-Kubernetes, KubeVirt, and MTV migrations.