# Observability Metrics

> Operate and validate mjr.wtf observability endpoints (/health, /metrics) and logging-related behavior. Use when adding metrics, changing auth around metrics, or debugging production-like issues.

- Skill: `majiayu000/observability-metrics` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/observability-metrics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/observability-metrics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/observability-metrics

---


## Tooling assumptions

- Use a terminal runner with bash and git available.
- Prefer `make` targets when available; fall back to direct CLI commands when needed.

## Endpoints

- `GET /health` (public): readiness/liveness check.
- `GET /metrics` (Prometheus): may be optionally protected.

## Validate locally

```bash
curl -i http://localhost:8080/health
curl -i http://localhost:8080/metrics
```

If metrics auth is enabled:

```bash
# Use any token from AUTH_TOKENS
curl -i -H "Authorization: Bearer $YOUR_TOKEN" http://localhost:8080/metrics
```

## Security note

Treat `/metrics` as potentially sensitive (rates, error counts, operational info). Enable protection in production with `METRICS_AUTH_ENABLED=true` or restrict via reverse proxy.