Observability

Last updated April 16, 2026

Metrics and health endpoints

# GET /metrics

Prometheus metrics

Returns Prometheus-format metrics (text/plain exposition format). Includes VoiceBlender-specific metrics and standard Go runtime metrics.

Responses

200 Prometheus text exposition format
# GET /debug/pprof/

pprof index

Index of available Go runtime profiles. Only available when built with -tags pprof (e.g. go build -tags pprof ./...).

Responses

200 HTML index page listing available profiles
# GET /debug/pprof/profile

CPU profile

30-second CPU profile (duration configurable via ?seconds= query param). Only available when built with -tags pprof.

Parameters

NameInTypeDescription
secondsqueryintegeroptionalProfile duration in seconds

Responses

200 pprof binary profile
# GET /debug/pprof/heap

Heap memory profile

Heap memory snapshot. Only available when built with -tags pprof.

Responses

200 pprof binary profile
# GET /debug/pprof/goroutine

Goroutine stack traces

All goroutine stack traces. Only available when built with -tags pprof.

Responses

200 pprof binary profile