grammarly-observability

# Grammarly Observability ## Overview Grammarly API integrations process user text through scoring, AI rewriting, and plagiarism endpoints where latency and accuracy directly affect user experience. Monitor text check response times, suggestion quality signals, API error rates, and token consumption to stay within rate limits. Catching degradation early prevents users from seeing stale suggestions or silent failures in real-time editing flows. ## Key Metrics | Metric | Type | Target | Alert Threshold | |--------|------|--------|-----------------| | Text check latency p95 | Histogram | < 300ms | > 800ms | | API error rate | Gauge | < 1% | > 5% | | Suggestion acceptance rate | Gauge | > 40% | < 20% (quality signal) | | Token usage (daily) | Counter | < 80% quota | > 90% quota | | Plagiarism check latency | Histogram | < 2s | > 5s | | AI rewrite throughput | Counter | Stable | Drop > 30% | ## Instrumentation ```typescript async function trackGrammarlyCall(api: 'score' | 'ai' | 'plagiarism', textLen: number, fn: () => Promise<any>) { const start = Date.now(); try { const result = await fn(); metrics.histogram('grammarly.api.latency', Date.now() - start, { api }); metrics.increment('grammarly.api.calls', { api }); metrics.gauge('grammarly.text.length', textLen, { api }); return result; } catch (err) { metrics.increment('grammarly.api.errors', { api, status: err.status }); throw err; } } ``` ## Health Check Dashboard ```typescript async f...