flexport-observability

# Flexport Observability ## Overview Full observability stack for Flexport integrations: Prometheus metrics for API health, pino structured logging for debugging, OpenTelemetry tracing for latency analysis, and Grafana dashboards for monitoring. ## Instructions ### Step 1: Prometheus Metrics ```typescript import { Counter, Histogram, Gauge, register } from 'prom-client'; const flexportRequests = new Counter({ name: 'flexport_api_requests_total', help: 'Total Flexport API requests', labelNames: ['method', 'endpoint', 'status'], }); const flexportLatency = new Histogram({ name: 'flexport_api_latency_seconds', help: 'Flexport API response time', labelNames: ['endpoint'], buckets: [0.1, 0.25, 0.5, 1, 2.5, 5, 10], }); const flexportRateLimit = new Gauge({ name: 'flexport_rate_limit_remaining', help: 'Remaining API calls in current window', }); // Instrumented fetch wrapper async function instrumentedFlexport(path: string, options: RequestInit = {}) { const endpoint = path.split('?')[0]; const timer = flexportLatency.startTimer({ endpoint }); try { const res = await fetch(`https://api.flexport.com${path}`, { ...options, headers: { ...headers, ...options.headers } }); flexportRequests.inc({ method: options.method || 'GET', endpoint, status: res.status.toString() }); const remaining = res.headers.get('X-RateLimit-Remaining'); if (remaining) flexportRateLimit.set(parseInt(remaining)); timer(); return res; } catch (err) { f...