wshobson avatar

Prometheus Configuration

Solid Prometheus setup guide that covers the essentials without getting lost in the weeds. Handles scrape configs for static targets, Kubernetes service discovery, and file-based discovery, plus generates useful recording rules for request rates and error percentages. The alert rules are practical, covering service downtime, error rates, and resource utilization with sensible thresholds. Docker Compose and Helm charts are included for quick deployment. What I like is the clear architecture diagram and real-world relabeling configs that actually work in production environments.

skills.sh installs
11.6K
GitHub stars
42.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add wshobson/agents --skill prometheus-configuration --agent claude-code

Installs into .claude/skills of the current project.

Files

Prometheus Configuration

Complete guide to Prometheus setup, metric collection, scrape configuration, and recording rules.

Purpose

Configure Prometheus for comprehensive metric collection, alerting, and monitoring of infrastructure and applications.

When to Use

  • Set up Prometheus monitoring
  • Configure metric scraping
  • Create recording rules
  • Design alert rules
  • Implement service discovery

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

  1. Use consistent naming for metrics (prefix_name_unit)
  2. Set appropriate scrape intervals (15-60s typical)
  3. Use recording rules for expensive queries
  4. Implement high availability (multiple Prometheus instances)
  5. Configure retention based on storage capacity
  6. Use relabeling for metric cleanup
  7. Monitor Prometheus itself
  8. Implement federation for large deployments
  9. Use Thanos/Cortex for long-term storage
  10. Document custom metrics

Troubleshooting

Check scrape targets:

curl http://localhost:9090/api/v1/targets

Sponsors

Details

Repository
github.com/wshobson/agents
Categories
DevOps & CI/CD, Cloud & Infrastructure

More from wshobson/agents

All 174
1getcargohq avatarcargo-hostinggetcargohq/cargo-skillsBuild, deploy, and manage Cargo Hosting apps and workers with the Cargo CLI — Vite SPAs served on *.cargo.app and serverless edge HTTP handlers, plus the deploy11Kskills.sh installs
2wshobson avatarslo-implementationwshobson/agentsDefine and implement Service Level Indicators (SLIs) and Service Level Objectives (SLOs) with error budgets and alerting. Use when establishing reliability targ10.8Kskills.sh installs
3google avatargoogle-cloud-waf-operational-excellencegoogle/skillsGenerates operations-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Operational Excellence pillar of the 10.6Kskills.sh installs
4google avatargoogle-cloud-waf-sustainabilitygoogle/skillsGenerates sustainability-focused guidance for Google Cloud workloads based on the design principles and recommendations in the Google Cloud Well-Architected Fra10.3Kskills.sh installs
5aws avataraws-containersaws/agent-toolkit-for-awsDeploys and operates containerized workloads on ECS, Fargate, and ECR. Covers task definitions, Fargate services, ECR repository setup and lifecycle policies, E10.1Kskills.sh installs
6aws avataraws-cdkaws/agent-toolkit-for-awsAuthors, deploys, and troubleshoots AWS infrastructure using CDK with TypeScript or Python. Covers best practices, stack architecture, and construct patterns. A10.1Kskills.sh installs