Kaiten
Self-Hosting

Observability

Set up OpenTelemetry tracing with Jaeger.

Observability

Kaiten supports OpenTelemetry for distributed tracing.

Quick Start

Start with Jaeger included:

make up-full

Open Jaeger UI at http://localhost:16686.

Configuration

Enable tracing via environment variables:

KAITEN_OTEL_ENABLED=true
KAITEN_OTEL_ENDPOINT=http://jaeger:4318
KAITEN_OTEL_SERVICE_NAME=kaiten-api
KAITEN_OTEL_INSECURE=true

What's Traced

  • All HTTP requests to the API
  • Database queries
  • Outbox event inserts
  • Seeder operations (parent span: seeder.run)
  • CDC event processing

Custom OTLP Endpoint

To send traces to a different backend (Grafana Tempo, Datadog, etc.), set KAITEN_OTEL_ENDPOINT to your OTLP endpoint.

On this page