deepgram-observability

# Deepgram Observability ## Overview Full observability stack for Deepgram: Prometheus metrics (request counts, latency histograms, audio processed, cost tracking), OpenTelemetry distributed tracing, structured JSON logging with Pino, Grafana dashboard JSON, and AlertManager rules. ## Four Pillars | Pillar | Tool | What It Tracks | |--------|------|----------------| | Metrics | Prometheus | Request rate, latency, error rate, audio minutes, estimated cost | | Traces | OpenTelemetry | End-to-end request flow, Deepgram API span timing | | Logs | Pino (JSON) | Request details, errors, audit trail | | Alerts | AlertManager | Error rate >5%, P95 latency >10s, rate limit hits | ## Instructions ### Step 1: Prometheus Metrics Definition ```typescript import { Counter, Histogram, Gauge, Registry, collectDefaultMetrics } from 'prom-client'; const registry = new Registry(); collectDefaultMetrics({ register: registry }); // Request metrics const requestsTotal = new Counter({ name: 'deepgram_requests_total', help: 'Total Deepgram API requests', labelNames: ['method', 'model', 'status'] as const, registers: [registry], }); const latencyHistogram = new Histogram({ name: 'deepgram_request_duration_seconds', help: 'Deepgram API request duration', labelNames: ['method', 'model'] as const, buckets: [0.1, 0.5, 1, 2, 5, 10, 30, 60], registers: [registry], }); // Usage metrics const audioProcessedSeconds = new Counter({ name: 'deepgram_audio_processed_seconds_total', ...