hubspot-observability

# HubSpot Observability ## Overview Instrument HubSpot API calls with Prometheus metrics, OpenTelemetry tracing, and structured logging to monitor CRM integration health. ## Prerequisites - Prometheus or compatible metrics backend - OpenTelemetry SDK (optional, for tracing) - Structured logging library (pino recommended) ## Instructions ### Step 1: Prometheus Metrics ```typescript import { Counter, Histogram, Gauge, Registry } from 'prom-client'; const registry = new Registry(); const hubspotRequests = new Counter({ name: 'hubspot_api_requests_total', help: 'Total HubSpot API requests', labelNames: ['method', 'object_type', 'status'], registers: [registry], }); const hubspotLatency = new Histogram({ name: 'hubspot_api_request_duration_seconds', help: 'HubSpot API request duration', labelNames: ['method', 'object_type'], buckets: [0.05, 0.1, 0.25, 0.5, 1, 2, 5], registers: [registry], }); const hubspotRateLimit = new Gauge({ name: 'hubspot_rate_limit_remaining', help: 'HubSpot daily rate limit remaining', labelNames: ['type'], registers: [registry], }); const hubspotErrors = new Counter({ name: 'hubspot_api_errors_total', help: 'HubSpot API errors by category', labelNames: ['status_code', 'category'], registers: [registry], }); ``` ### Step 2: Instrumented Client Wrapper ```typescript import * as hubspot from '@hubspot/api-client'; class InstrumentedHubSpotClient { private client: hubspot.Client; constructor() { this.cl...