gamma-observability

# Gamma Observability ## Overview Implement monitoring, logging, and health checks for Gamma API integrations. Since Gamma does not expose rate limit headers or internal metrics, observability is built around your API call patterns, latency, error rates, credit consumption, and generation success rates. ## Prerequisites - Working Gamma integration (see `gamma-sdk-patterns`) - Monitoring stack (Prometheus/Grafana, Datadog, or CloudWatch) - Logging infrastructure ## Instructions ### Step 1: Instrumented Client ```typescript // src/observability/gamma-metrics.ts interface GammaMetrics { requests: number; errors: number; generations: number; completions: number; failures: number; totalCredits: number; totalLatencyMs: number; errorsByStatus: Record<number, number>; } const metrics: GammaMetrics = { requests: 0, errors: 0, generations: 0, completions: 0, failures: 0, totalCredits: 0, totalLatencyMs: 0, errorsByStatus: {}, }; export function createInstrumentedClient(apiKey: string) { const base = "https://public-api.gamma.app/v1.0"; const headers = { "X-API-KEY": apiKey, "Content-Type": "application/json" }; async function instrumentedRequest(method: string, path: string, body?: unknown) { metrics.requests++; const start = Date.now(); try { const res = await fetch(`${base}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined, }); metrics.totalLatencyMs += Date.now() - start; ...