deepgram-observability

name	deepgram-observability
description	Set up comprehensive observability for Deepgram integrations. Use when implementing monitoring, setting up dashboards, or configuring alerting for Deepgram integration health. Trigger: "deepgram monitoring", "deepgram metrics", "deepgram observability", "monitor deepgram", "deepgram alerts", "deepgram dashboard".
allowed-tools	Read, Write, Edit, Bash(curl:*)
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","deepgram","monitoring","observability","prometheus"]
compatibility	Designed for Claude Code

Deepgram Observability

Overview

Full observability stack for Deepgram: Prometheus metrics (request counts, latency histograms, audio processed, cost tracking), OpenTelemetry distributed tracing, structured JSON logging with Pino, Grafana dashboard JSON, and AlertManager rules.

Four Pillars

Pillar	Tool	What It Tracks
Metrics	Prometheus	Request rate, latency, error rate, audio minutes, estimated cost
Traces	OpenTelemetry	End-to-end request flow, Deepgram API span timing
Logs	Pino (JSON)	Request details, errors, audit trail
Alerts	AlertManager	Error rate >5%, P95 latency >10s, rate limit hits

Instructions

Step 1: Prometheus Metrics Definition

import { Counter, Histogram, Gauge, Registry, collectDefaultMetrics } from 'prom-client';

const registry = new Registry();
collectDefaultMetrics({ register: registry });

// Request metrics
const requestsTotal = new Counter({
  name: 'deepgram_requests_total',
  help: 'Total Deepgram API requests',
  labelNames: ['method', 'model', 'status'] as const,
  registers: [registry],
});

const latencyHistogram = new Histogram({
  name: ,
  : ,
  : [, ]  ,
  : [, , , , , , , ],
  : [registry],
});


 audioProcessedSeconds =  ({
  : ,
  : ,
  : []  ,
  : [registry],
});

 estimatedCostDollars =  ({
  : ,
  : ,
  : [, ]  ,
  : [registry],
});


 activeConnections =  ({
  : ,
  : ,
  : [registry],
});

 rateLimitHits =  ({
  : ,
  : ,
  : [registry],
});

 { registry, requestsTotal, latencyHistogram, audioProcessedSeconds,
         estimatedCostDollars, activeConnections, rateLimitHits };