Set up Prometheus for comprehensive metric collection

Prometheus configuration

by wshobson · MIT license · ★ 39,857 on GitHub · updated Sep 21

Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications. Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems.

---
name: prometheus-configuration
description: Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications. Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems.
---

# 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

Overview

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

Manual install (npx, ZIP)

Claude Codenpx skills add wshobson/agents --skill prometheus-configuration -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/wshobson/agents/tar.gz/4236bb91f839 \
  | tar -xz -C ~/.claude/skills --strip-components=4 agents-4236bb91f839/plugins/observability-monitoring/skills/prometheus-configuration

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/8e99828fa6f9759ab8d8/prometheus-configuration.zip" -OutFile "$env:TEMP\prometheus-configuration.zip"; Expand-Archive "$env:TEMP\prometheus-configuration.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md1.8 KB
references/1 file · 8.3 KB

Read the files here

wshobson/4236bb92 files

SKILL.md1.8 KB

SKILL.md

Show the full text65 lines

prometheus-configuration/SKILL.md65 lines · 1.8 KB

PreviewCode

Outline

RawView on GitHub

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

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

Troubleshooting

Check scrape targets:

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

Check configuration:

curl http://localhost:9090/api/v1/status/config

Test query:

curl 'http://localhost:9090/api/v1/query?query=up'

grafana-dashboards - For visualization
slo-implementation - For SLO monitoring
distributed-tracing - For request tracing

1	---
2	name: prometheus-configuration
3	description: Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications. Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems.
4	---
5
6	# Prometheus Configuration
7
8	Complete guide to Prometheus setup, metric collection, scrape configuration, and recording rules.
9
10	## Purpose
11
12	Configure Prometheus for comprehensive metric collection, alerting, and monitoring of infrastructure and applications.
13
14	## When to Use
15
16	- Set up Prometheus monitoring
17	- Configure metric scraping
18	- Create recording rules
19	- Design alert rules
20	- Implement service discovery
21
22	## Detailed patterns and worked examples
23
24	Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient.
25
26	## Best Practices
27
28	1. Use consistent naming for metrics (prefix_name_unit)
29	2. Set appropriate scrape intervals (15-60s typical)
30	3. Use recording rules for expensive queries
31	4. Implement high availability (multiple Prometheus instances)
32	5. Configure retention based on storage capacity
33	6. Use relabeling for metric cleanup
34	7. Monitor Prometheus itself
35	8. Implement federation for large deployments
36	9. Use Thanos/Cortex for long-term storage
37	10. Document custom metrics
38
39	## Troubleshooting
40
41	Check scrape targets:
42
43	```bash
44	curl http://localhost:9090/api/v1/targets
45	```
46
47	Check configuration:
48
49	```bash
50	curl http://localhost:9090/api/v1/status/config
51	```
52
53	Test query:
54
55	```bash
56	curl 'http://localhost:9090/api/v1/query?query=up'
57	```
58
59
60	## Related Skills
61
62	- `grafana-dashboards` - For visualization
63	- `slo-implementation` - For SLO monitoring
64	- `distributed-tracing` - For request tracing
65