fireflies-observability

# Fireflies.ai Observability ## Overview Monitor Fireflies.ai integration health: API connectivity, webhook delivery, transcript processing latency, and seat utilization. Built for Prometheus/Grafana but adaptable to any metrics system. ## Prerequisites - Fireflies Business+ plan (for full API access) - Prometheus + Grafana (or equivalent metrics stack) - Webhook endpoint deployed and receiving events ## Instructions ### Step 1: Instrument the GraphQL Client ```typescript // lib/fireflies-instrumented.ts import { Counter, Histogram, Gauge } from "prom-client"; const apiRequests = new Counter({ name: "fireflies_api_requests_total", help: "Total Fireflies API requests", labelNames: ["operation", "status"], }); const apiLatency = new Histogram({ name: "fireflies_api_latency_seconds", help: "Fireflies API request latency", labelNames: ["operation"], buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10], }); const FIREFLIES_API = "https://api.fireflies.ai/graphql"; export async function firefliesQueryInstrumented( operation: string, query: string, variables?: any ) { const timer = apiLatency.startTimer({ operation }); try { const res = await fetch(FIREFLIES_API, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`, }, body: JSON.stringify({ query, variables }), }); const json = await res.json(); if (json.errors) { apiRequests.inc({ ...