Reference

Environment variable reference

Canonical client runtime and operator configuration names for LiveProbe 0.3.0.

All runtime agents

VariablePurpose
LIVEPROBE_API_KEYScoped service credential
LIVEPROBE_COMMIT_SHARequired deployed hexadecimal Git revision
GIT_COMMITFallback deployed revision
LIVEPROBE_PROJECT_IDStable repository or application scope
LIVEPROBE_ENVIRONMENTDeployment environment scope

Node and Python application code also receive the broker URL and service ID. The exact names may be passed as SDK options; this guide uses LIVEPROBE_BROKER_URL and LIVEPROBE_SERVICE_ID consistently in deployment configuration.

Node-specific variables

VariablePurpose
LIVEPROBE_SOURCE_MAP_DIRDirectory scanned for external .js.map files
LIVEPROBE_DIST_LOCATIONGenerated output prefix; defaults to dist
LIVEPROBE_APP_ROOTOptional monorepo source-path prefix

Safety variables

See Runtime safety for defaults and per-runtime support:

dotenv
LIVEPROBE_MAX_PROBE_HITS_PER_SECOND=10
LIVEPROBE_MAX_PROBE_PAUSE_MS_PER_SECOND=20
LIVEPROBE_MAX_TELEMETRY_BYTES_PER_SECOND=204800
LIVEPROBE_MAX_BUFFERED_EVENT_BYTES=1024000
LIVEPROBE_MAX_EVENT_LOOP_LAG_MS=50
LIVEPROBE_SAFETY_COOLDOWN_MS=10000

Broker operator variables

VariablePurpose
DATABASE_URLPostgreSQL durable store
LIVEPROBE_DB_POOL_SIZEBroker PostgreSQL pool size; default 10
LIVEPROBE_STATE_FILELocal/dev JSON fallback when DATABASE_URL is unset
CLERK_SECRET_KEYClerk backend verification and membership resolution
CLERK_PUBLISHABLE_KEYOAuth metadata configuration
CLERK_FRONTEND_API_URLClerk production authorization-server origin
CLERK_AUTHORIZED_PARTIESAllowed frontend origins for Clerk tokens
LIVEPROBE_PUBLIC_URLPublic HTTPS origin used in OAuth metadata