servicedna (Python)

Connect a Python service to ServiceDNA with one dependency and two environment variables. You get:

• Distributed traces for FastAPI, Flask, Django, ASGI/WSGI, requests, httpx, urllib3, aiohttp, gRPC, SQLAlchemy, psycopg2, Redis and Kafka (OpenTelemetry auto-instrumentation — only libraries you actually use are instrumented)
• Self-registration — the service appears in ServiceDNA on first start
• Health heartbeats — the service's own /health is checked and reported every 15 s

Install

pip install servicedna

Run

Prefix your usual command with servicedna-run:

SERVICEDNA_URL=https://servicedna.example.com \
SERVICEDNA_KEY=sdna_ik_... \
servicedna-run uvicorn app.main:app --host 0.0.0.0 --port 8000

Or start it from code, first thing in your entry point:

import servicedna
servicedna.start()

servicedna-run is preferred: it instruments libraries before your code imports them. Without SERVICEDNA_URL and SERVICEDNA_KEY both do nothing, so the same build runs anywhere.

Configuration

Standard OTEL_* variables still apply and win over these defaults.