k8s-prometheus-troubleshooting
Use when Prometheus on Kubernetes does not collect or alert as expected: a ServiceMonitor or PodMonitor whose targets never appear, targets that are down ("server returned HTTP status 404 Not Found", "connection refused", "context deadline exceeded"), a PrometheusRule that does not load or alerts that do not fire or reach Alertmanager, a Prometheus or Alertmanager custom resource that is not Available, "InvalidConfiguration" events from the Prometheus Operator, or Prometheus pods that are OOMKilled or out of disk. Covers the Prometheus Operator (kube-prometheus, kube-prometheus-stack). Investigates with kubectl get, describe, events, logs and Prometheus' HTTP API through the API server, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision ce7de97330d7, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-prometheus-troubleshooting/SKILL.md
- skills/k8s-prometheus-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-prometheus-troubleshooting/references/discovery.md
- skills/k8s-prometheus-troubleshooting/references/prometheus-health.md
- skills/k8s-prometheus-troubleshooting/references/rules-and-alerts.md
- skills/k8s-prometheus-troubleshooting/references/targets-down.md
Every link opens the file at its source, pinned to the revision this page describes.