The Python SDK reads the following environment variables. All are optional when the equivalent parameter is passed directly to HoneyHiveTracer.init() or the HoneyHive client.
Authentication & Endpoints
| Variable | Description | Default |
|---|
HH_API_KEY | API key for authenticating with HoneyHive. Also accepts HONEYHIVE_API_KEY. | None (required) |
HH_PROJECT | Project name. Also accepts HONEYHIVE_PROJECT. | None (required) |
HH_API_URL | Base URL for the Data Plane API. Also accepts HONEYHIVE_SERVER_URL or HH_SERVER_URL. | https://api.honeyhive.ai |
HH_CP_API_URL | Base URL for the Control Plane API. Falls back to HH_API_URL if not set. The client accepts this URL, but not every SDK surface routes through it yet. Only relevant for self-hosted federated deployments. | Same as HH_API_URL |
Tracer Behavior
| Variable | Description | Default |
|---|
HH_SOURCE | Environment label for traces (e.g., "prod", "dev", "staging"). | "dev" |
HH_SESSION_NAME | Default session name. | "" |
HH_DISABLE_BATCH | Disable batched span export. Set to true for serverless environments. | false |
HH_DISABLE_HTTP_TRACING | Disable automatic HTTP request tracing. Also accepts HONEYHIVE_DISABLE_HTTP_TRACING. | false |
HH_TEST_MODE | Disable OTLP export and use local-only session IDs. Useful for local development and tests. | false |
HH_VERBOSE | Set to "true" to enable verbose debug logging. | "false" |
HH_OTLP_ENABLED | Enable or disable OTLP span export. | true |
| Variable | Description | Default |
|---|
HH_OTLP_PROTOCOL | OTLP transport protocol ("http/json", "http/protobuf", or "grpc"). Also accepts OTEL_EXPORTER_OTLP_PROTOCOL. | "http/json" |
HH_BATCH_SIZE | Maximum number of spans per export batch. | 100 |
HH_FLUSH_INTERVAL | Interval in seconds between batch exports. | 5.0 |
HH_EXPORT_TIMEOUT | Timeout in seconds for OTLP span exports. | 30 |
HH_EXPORT_TIMEOUT_SECONDS | Timeout in seconds for large data exports via the REST API (e.g., export(), get_by_session_id()). | 120 |
HH_HIGH_CONCURRENCY | Set to "true" to optimize for high-concurrency workloads. | false |
Resource Attributes
| Variable | Description | Default |
|---|
HH_SERVICE_NAME | Override the OpenTelemetry service.name resource attribute. | Auto-detected |
HH_SERVICE_VERSION | Override the OpenTelemetry service.version resource attribute. | Auto-detected |
Span Limits
| Variable | Description | Default |
|---|
HH_MAX_ATTRIBUTES | Maximum number of attributes per span. Core HoneyHive attributes are preserved even when limits are reached. | 128 |
HH_MAX_EVENTS | Maximum number of events per span. | 128 |
HH_MAX_LINKS | Maximum number of links per span. | 128 |
Experiments
| Variable | Description | Default |
|---|
HH_EXPERIMENT_ID | Override the experiment ID. | - |
HH_EXPERIMENT_NAME | Override the experiment name. | - |
HH_EXPERIMENT_VARIANT | Tag the experiment variant. | - |
HH_EXPERIMENT_GROUP | Tag the experiment group. | - |
Proxy
| Variable | Description | Default |
|---|
HH_HTTP_PROXY | HTTP proxy URL for SDK requests. Falls back to standard HTTP_PROXY. | - |
HH_HTTPS_PROXY | HTTPS proxy URL for SDK requests. Falls back to standard HTTPS_PROXY. | - |
HH_NO_PROXY | Comma-separated list of hosts to bypass the proxy. Falls back to standard NO_PROXY. | - |
Telemetry
| Variable | Description | Default |
|---|
HH_TELEMETRY | Enable or disable SDK telemetry. Also accepts HONEYHIVE_TELEMETRY. | true |
All HH_* variables also accept a HONEYHIVE_* prefix (e.g., HONEYHIVE_API_KEY instead of HH_API_KEY). The SDK resolves both prefixes automatically. Where an additional alias exists (e.g., HONEYHIVE_SERVER_URL), it is noted in the table above.
