prometheus

Query Prometheus API for cluster metrics, alerts, and observability data.

24|3|Updated Mar 31, 2022
One-click install
npx skills add https://github.com/ionfury/homelab --skill prometheus-ionfury
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prometheus
Source: https://github.com/ionfury/homelab/tree/main/.claude/skills/prometheus
Command: npx skills add https://github.com/ionfury/homelab --skill prometheus-ionfury

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill enables fast access to cluster metrics, alert status, and observability data by querying the Prometheus API, reducing the time to diagnose health and performance issues.

Core Features & Use Cases

  • Instant queries against Prometheus for current metrics (up, cpu usage, memory pressure) across clusters.
  • Range queries and alert listings to inspect trends and active problems over time.
  • Access to a bundled promql.sh script and documented queries to streamline troubleshooting.

Quick Start

Run the bundled promql.sh script to perform a live PromQL query against your Prometheus endpoint.

Frequently Asked Questions about prometheus

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

FAQPage Schema
How do I query Prometheus metrics for my Kubernetes cluster?

To query Prometheus metrics for a Kubernetes cluster, you can run instant and range queries against the Prometheus API using a bundled promql.sh script. This retrieves current cluster metrics like CPU usage, memory pressure, and up status.

How do I list active Prometheus alerts via the API?

Listing active Prometheus alerts is done by querying the Prometheus API for alert listings. The Skill supports alert retrieval to help you inspect active problems and diagnose health issues across multiple clusters.

Do I need to port-forward to access Prometheus endpoints for observability data?

Accessing Prometheus endpoints requires either DNS-based access or port-forwarding to your Kubernetes cluster. You need this network connectivity to execute instant queries, range queries, and series exploration.

What dependencies are required to run PromQL queries against Prometheus?

Running PromQL queries against Prometheus requires curl, jq, and python3. The Skill uses curl for API requests, jq for JSON parsing, and a small Python helper for URL encoding.

Can I explore metric series across multiple Kubernetes clusters?

Exploring metric series across multiple clusters is supported through the Prometheus API. You can perform series exploration and run range queries to inspect trends and observability data over time.

Why use a bundled script for Prometheus troubleshooting instead of manual API calls?

Using a bundled promql.sh script with documented queries streamlines troubleshooting by reducing the time to diagnose health and performance issues. It provides fast access to cluster metrics and alert status without manual curl construction.