figma-observability

# Figma Observability ## Overview Monitor Figma REST API health with custom metrics, structured logging, and alerts. Track request latency, error rates, rate limit headroom, and cache hit rates. ## Prerequisites - Prometheus or compatible metrics backend (or use OpenTelemetry) - Structured logging (pino, winston) - Alerting system (PagerDuty, Slack, OpsGenie) ## Instructions ### Step 1: Instrumented Figma Client ```typescript // Wrap every Figma API call with metrics and logging class InstrumentedFigmaClient { private metrics = { requests: 0, errors: 0, rateLimits: 0, totalLatencyMs: 0, }; async request<T>(path: string, token: string): Promise<T> { const start = performance.now(); const endpoint = path.replace(/[a-zA-Z0-9]{15,}/, ':key'); // normalize try { const res = await fetch(`https://api.figma.com${path}`, { headers: { 'X-Figma-Token': token }, }); const latencyMs = performance.now() - start; this.metrics.requests++; this.metrics.totalLatencyMs += latencyMs; // Log every request with structured data console.log(JSON.stringify({ service: 'figma', endpoint, status: res.status, latencyMs: Math.round(latencyMs), rateLimit: { remaining: res.headers.get('X-RateLimit-Remaining'), type: res.headers.get('X-Figma-Rate-Limit-Type'), }, })); if (res.status === 429) { this.metrics.rateLimits++; co...