observability-integrate

Integrate Anton workloads with kube-prometheus-stack via ServiceMonitor, PrometheusRule, and Grafana ConfigMaps.

3|Updated May 13, 2025
One-click install
npx skills add https://github.com/wcygan/anton --skill observability-integrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-integrate
Source: https://github.com/wcygan/anton/tree/main/.claude/skills/observability-integrate
Command: npx skills add https://github.com/wcygan/anton --skill observability-integrate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The skill helps teams wire Anton workloads into the kube-prometheus-stack observability stack, enabling consistent collection of metrics, dashboards, and alerts without manual per-app wiring.

Core Features & Use Cases

  • Add ServiceMonitor and PodMonitor definitions to collect metrics from running workloads.
  • Expose metrics to Prometheus and Grafana via Grafana dashboards stored as ConfigMaps (sidecar pattern).
  • Author PrometheusRule groups for alerts and recording rules and verify scrape targets.
  • Create Grafana dashboards and sidecar-configured ConfigMaps for quick visibility of app health.
  • Verify scrapes, diagnose missing metrics, and debug metric visibility using the prescribed probe recipes.

Quick Start

Wire an app into the metrics stack by creating monitors, dashboards, and rules as described for kube-prometheus-stack.

Frequently Asked Questions about observability-integrate

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

FAQPage Schema
How do I add ServiceMonitor and PodMonitor definitions to collect Prometheus metrics from Kubernetes workloads?

To collect Prometheus metrics, add ServiceMonitor and PodMonitor definitions co-located with your app manifests. This skill wires them into kube-prometheus-stack, applying monitors to enable consistent scrape target collection across namespaces without manual per-app wiring.

How do I create Grafana dashboards as ConfigMaps for apps monitored with kube-prometheus-stack?

Create Grafana dashboards as ConfigMaps using the sidecar pattern for kube-prometheus-stack. This skill generates sidecar-configured ConfigMaps that automatically load into Grafana, providing immediate visibility of app health metrics scraped by Prometheus.

Does this observability integration require a Flux-based GitOps repository structure?

Yes, this integration assumes Flux-based repo patterns with manifests co-located in kubernetes/apps/<ns>/<app>/app. It validates monitors, dashboards, and alert rules against ADR 0007 and plan 0002, requiring this GitOps structure to function correctly.

Why is Prometheus not scraping my app metrics after adding a ServiceMonitor in Kubernetes?

Prometheus may not be scraping your app because the ServiceMonitor configuration is misapplied. This skill verifies scrape targets and diagnoses missing metrics using prescribed probe recipes, validating that monitors are correctly wired into kube-prometheus-stack.

How do I set up PrometheusRule alerts and recording rules for Kubernetes applications?

Set up PrometheusRule alerts by authoring rule groups for recording and alerting conditions. This skill applies PrometheusRule definitions alongside ServiceMonitors and Grafana dashboards, validating alert configurations within the kube-prometheus-stack observability stack.

Can I use this skill to debug missing metrics and verify scrape targets in kube-prometheus-stack?

Yes, you can debug missing metrics and verify scrape targets using this skill. It diagnoses metric visibility issues by applying prescribed probe recipes that validate Prometheus scrapes and dashboard integrity across your observability stack configuration.