intercom-observability

# Intercom Observability ## Overview Comprehensive observability for Intercom integrations covering Prometheus metrics, OpenTelemetry traces, structured logging, and alert rules for error rates, latency, and rate limit usage. ## Prerequisites - Prometheus or compatible metrics backend - OpenTelemetry SDK (optional, for tracing) - Pino or similar structured logger - Grafana or alerting system ## Instructions ### Step 1: Prometheus Metrics for Intercom API Calls ```typescript import { Registry, Counter, Histogram, Gauge } from "prom-client"; const registry = new Registry(); // Total API requests by endpoint and status const intercomRequests = new Counter({ name: "intercom_api_requests_total", help: "Total Intercom API requests", labelNames: ["endpoint", "method", "status"] as const, registers: [registry], }); // Request duration by endpoint const intercomDuration = new Histogram({ name: "intercom_api_request_duration_seconds", help: "Intercom API request duration in seconds", labelNames: ["endpoint", "method"] as const, buckets: [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10], registers: [registry], }); // Error counter by type const intercomErrors = new Counter({ name: "intercom_api_errors_total", help: "Intercom API errors by type", labelNames: ["endpoint", "error_code", "status_code"] as const, registers: [registry], }); // Rate limit remaining gauge const intercomRateLimit = new Gauge({ name: "intercom_rate_limit_remaining", help: "Intercom A...