Environment variables
What application developers set
| Env var | Default | Purpose |
|---|---|---|
EDEN_API_KEY | unset | Org API key (required) |
EDEN_ORG_ID | unset | Org id (required) |
EDEN_BASE_URL | https://api.edenobservability.com | Override API host (optional) |
EDEN_ENV | default | Environment label on events (Python) |
EDEN_DEBUG | false | Verbose SDK logs |
export EDEN_API_KEY="sk_eden_…"
export EDEN_ORG_ID="org_…"
# EDEN_BASE_URL is optional — SDKs already default to the production API
Validate with python -m eden_sdk.doctor or npx eden-doctor.
Portal (Vercel)
| Env var | Production value | Notes |
|---|---|---|
NEXT_PUBLIC_API_URL | /api/proxy | Same-origin browser proxy |
API_INTERNAL_URL | https://api.edenobservability.com | Server-side FastAPI upstream |
NEXT_PUBLIC_SITE_URL | https://edenobservability.com | |
| Clerk keys | live keys for prod |
Platform variables (Eden-operated)
The tables below document variables used by the hosted API and workers. Customers do not set these unless Eden staff asks you to for a dedicated tenancy.
A–C
| Env var | Production note | Used by |
|---|---|---|
ANTHROPIC_API_KEY | Provider key | API |
APP_BASE_URL | Public portal/API URL | API |
CLICKHOUSE_* | Analytics store | API |
CLERK_* | Auth | API, Portal |
CORS_ORIGINS_RAW | CSV of portal (+ docs if needed) origins | API |
D–E (SDK + sampling)
| Env var | Default | Used by | Notes |
|---|---|---|---|
EDEN_API_KEY | unset | SDKs | Org API key |
EDEN_BASE_URL | https://api.edenobservability.com | SDKs | |
EDEN_DEBUG | false | Python SDK | |
EDEN_ENV | default | SDKs | |
EDEN_ORG_ID | unset | SDKs | |
EDEN_SAMPLING_PROFILE | full | API + SDKs | Soft-launch default: 100% keep. Cost win after soft-launch: set balanced (~15% non-signal keep; errors/loops/stumbles always kept) or aggressive (~5%). Applied server-side via N16 decide() on ingest; SDKs also honour the same env for client-side enqueue filtering. |
EDEN_SAMPLING_ENABLED | true / 1 | API + SDKs | false / 0 forces 100% keep (safe rollback). |
EDEN_SAMPLE_KEEP_ERRORS | 1 | SDKs | Client sampler always keeps error signals when on. |
EDEN_PROBABILISTIC_SAMPLE_RATE | 1.0 | API | When \< 1.0, overrides profile fallback rate only. |
Maps to Settings: sampling_profile, sampling_enabled, probabilistic_sample_rate
(src/eden/config.py). Ingest gate: eden.observability.sampling.apply.should_route_event.
Remaining platform vars
Postgres, Redis, Qdrant, Stripe, Sentry, and provider keys are
configured on the Eden-operated API. Full historical list (including
local-dev defaults used by Eden engineers) lives in
src/eden/config.py / .env.example in the repo.
Precedence
- Explicit
configure(...)/ CLI flags — highest - Environment variables
- SDK default (
https://api.edenobservability.com) — lowest