Skip to content

Add monitoring and alerting skill #40

Description

@PAMulligan

Description

Create a new skill that generates monitoring endpoints, health checks, and alerting configuration for Nerva APIs.

Why

The current health check is a simple `/health` returning `{ status: "ok" }`. Production APIs need deeper health checks (database connectivity, external service status), Prometheus-compatible metrics endpoints, and alerting configuration.

Acceptance Criteria

  • Create `.claude/skills/monitoring-alerting/SKILL.md`
  • Generate an enhanced health check endpoint with:
    • Database connectivity check
    • External dependency status
    • Memory usage and uptime
    • Version information
    • Degraded status support (healthy/degraded/unhealthy)
  • Generate a `/metrics` endpoint compatible with Prometheus format:
    • Request count by method and status code
    • Request duration histogram
    • Active connections gauge
    • Custom business metrics hooks
  • Create alerting rule templates for:
    • High error rate (`> 5%` 5xx responses)
    • High latency (`p95 > 500ms`)
    • Database connection pool exhaustion
  • Include Grafana dashboard JSON template
  • CI passes

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions