Obs Stack Status
SkillDev toolsCheck obs stack health and service status. Use this skill whenever the user asks about stack health, whether services are running, if telemetry is flowing, why dashboards show no data, or anything related to the obs stack being up or down. Also use when troubleshooting "no data" issues, checking if Prometheus/Loki/Tempo/Grafana are reachable, or after running docker compose up to verify everything started correctly.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Obs Stack Status skill
What this skill tells your AI
The instructions your AI receives, as published by shepard-system/shepard-obs-stack in .claude/skills/obs-status/SKILL.md and read by ahel’s review.
Check health of all 6 obs stack services, scrape targets, alerts, and last telemetry.
Queries to run
Use scripts/obs-api.sh to query each service. Run independent checks in parallel.
Step 1: Service health (run all in parallel)
scripts/obs-api.sh grafana /api/health
scripts/obs-api.sh loki /ready
scripts/obs-api.sh prom /-/healthy
scripts/obs-api.sh am /-/healthy
scripts/obs-api.sh tempo /ready
If a command fails or returns empty, the service is down.
Step 2: Prometheus scrape targets
scripts/obs-api.sh prom /api/v1/targets --raw --jq '.data.activeTargets[] | "\(.labels.job)\t\(.health)"'
Step 3: Active alerts
scripts/obs-api.sh am /api/v2/alerts --raw --jq 'if length == 0 then "No active alerts" else .[] | "\(.labels.alertname)\t\(.labels.severity // "?")" end'
Step 4: Last telemetry received
scripts/obs-api.sh prom '/api/v1/query?query=max(shepherd_events_total)' --raw --jq '.data.result[0].value'
scripts/obs-api.sh prom '/api/v1/query?query=max(shepherd_claude_code_cost_usage_USD_total)' --raw --jq '.data.result[0].value'
Output columns
| Column | Source |
|---|---|
| Service | service name |
| Port | 3000, 3100, 9090, 9093, 3200, 4317/4318 |
| Status | UP if healthy response, DOWN if empty/error |
For output format options (table/csv/json), read .claude/skills/obs-shared/assets/output-formats.md.
Presentation
- Service status table (name | port | status)
- Scrape targets (job | health)
- Active alerts with severity (if any)
- Last telemetry — how long ago
- If any service is DOWN: suggest
docker compose up -dordocker compose logs <service> --tail=20
Signals
- GitHub stars
- 70
- Forks
- 6
- Last commit
- Mar 2026
Advanced
- Catalog kind
- skill
- Gateway key
obs-status- Source
- github.com/shepard-system/shepard-obs-stack