prometheus

name	prometheus
description	Query Prometheus monitoring data to check server metrics, resource usage, and system health. Use when the user asks about server status, disk space, CPU/memory usage, network stats, or any metrics collected by Prometheus. Supports HTTP Basic Auth via environment variables.

Prometheus Skill

Query Prometheus monitoring data to get insights about your infrastructure.

Environment Variables

Set in .env file:

• PROMETHEUS_URL - Prometheus server URL (e.g., http://localhost:9090)
• PROMETHEUS_USER - HTTP Basic Auth username (optional)
• PROMETHEUS_PASSWORD - HTTP Basic Auth password (optional)

Usage

Query Metrics

Use the CLI to run PromQL queries:

source .env && node scripts/cli.js query '<promql_query>'

Common Examples

Disk space usage:

node scripts/cli.js query '100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)'

CPU usage:

node scripts/cli.js query '100 - (avg by (instance) (irate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)'

Memory usage:

node scripts/cli.js query '(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100'

Load average:

node scripts/cli.js query