perplexity-observability

# Perplexity Observability ## Overview Monitor Perplexity Sonar API performance, cost, and quality. Key signals unique to Perplexity: citation count per response (quality indicator), search latency variability (web search is non-deterministic), and per-model cost differences. ## Key Metrics | Metric | sonar (typical) | sonar-pro (typical) | Alert Threshold | |--------|----------------|--------------------|-------------- | | Latency p50 | 1-2s | 3-5s | p95 > 15s | | Citations/response | 3-5 | 5-10 | 0 for 10min | | Error rate | <1% | <1% | >5% | | Cost/query | $0.005 | $0.02 | >$0.10 | ## Prerequisites - Perplexity API integration running - Metrics backend (Prometheus, Datadog, or custom) - Alerting system configured ## Instructions ### Step 1: Instrument the Perplexity Client ```typescript import OpenAI from "openai"; interface SearchMetrics { model: string; latencyMs: number; status: "success" | "error"; citationCount: number; totalTokens: number; cached: boolean; errorCode?: number; } const metrics: SearchMetrics[] = []; async function instrumentedSearch( client: OpenAI, query: string, model: string = "sonar", cached: boolean = false ): Promise<{ response: any; metrics: SearchMetrics }> { const start = performance.now(); let searchMetrics: SearchMetrics; try { const response = await client.chat.completions.create({ model, messages: [{ role: "user", content: query }], }); searchMetrics = { model, lat...