clickup-observability

# ClickUp Observability ## Overview Monitor ClickUp API v2 integrations with metrics (request rate, latency, errors, rate limit usage), distributed tracing, and alerting. ## Key Metrics | Metric | Type | Labels | Description | |--------|------|--------|-------------| | `clickup_requests_total` | Counter | method, endpoint, status | Total API requests | | `clickup_request_duration_seconds` | Histogram | method, endpoint | Request latency | | `clickup_errors_total` | Counter | status_code, error_type | Errors by type | | `clickup_rate_limit_remaining` | Gauge | token_hash | Rate limit headroom | | `clickup_rate_limit_resets_total` | Counter | | Times we hit 429 | ## Prometheus Instrumentation ```typescript import { Registry, Counter, Histogram, Gauge } from 'prom-client'; const registry = new Registry(); const requestCounter = new Counter({ name: 'clickup_requests_total', help: 'Total ClickUp API v2 requests', labelNames: ['method', 'endpoint', 'status'] as const, registers: [registry], }); const requestDuration = new Histogram({ name: 'clickup_request_duration_seconds', help: 'ClickUp API request duration in seconds', labelNames: ['method', 'endpoint'] as const, buckets: [0.05, 0.1, 0.25, 0.5, 1, 2, 5], registers: [registry], }); const rateLimitGauge = new Gauge({ name: 'clickup_rate_limit_remaining', help: 'ClickUp rate limit remaining requests', registers: [registry], }); const errorCounter = new Counter({ name: 'clickup_errors_total', ...