navan-observability

# Navan Observability ## Overview Navan exposes no built-in API metrics dashboard — monitoring is your responsibility. This skill implements structured logging, latency tracking, error classification, and alerting for Navan REST API integrations. Since Navan uses OAuth 2.0 with token expiration, observability must also cover the authentication lifecycle. Patterns are provided for Datadog, CloudWatch, and Prometheus/Grafana. ## Prerequisites - **Running Navan API integration** with OAuth 2.0 credentials - **Monitoring platform** — Datadog, AWS CloudWatch, or Prometheus/Grafana - **Node.js 18+** or equivalent runtime for the instrumentation middleware - API base URL: `https://api.navan.com/v1` ## Instructions ### Step 1 — Instrument API Calls with Structured Logging Wrap every Navan API call with timing, status, and correlation tracking: ```typescript import { randomUUID } from 'crypto'; interface NavanApiLog { event: 'navan.api.request'; correlation_id: string; method: string; endpoint: string; status: number; duration_ms: number; error_type?: 'auth' | 'rate_limit' | 'server' | 'client' | 'network'; timestamp: string; } async function navanRequest( method: string, endpoint: string, token: string, body?: object ): Promise<Response> { const correlationId = randomUUID(); const start = performance.now(); try { const response = await fetch(`https://api.navan.com/v1/${endpoint}`, { method, headers: { 'Authorization': `...