Configuration

ddtrace can be configured using environment variables. They are listed below:

Variable Name

Type

Default value

Description

DD_ENV

String

Set an application’s environment e.g. prod, pre-prod, staging. Added in v0.36.0. See Unified Service Tagging for more information.

DD_SERVICE

String

(autodetected)

Set the service name to be used for this application. A default is provided for these integrations: Bottle, Flask, Grpc, Pyramid, Pylons, Tornado, Celery, Django and Falcon. Added in v0.36.0. See Unified Service Tagging for more information.

DD_SERVICE_MAPPING

String

Define service name mappings to allow renaming services in traces, e.g. postgres:postgresql,defaultdb:postgresql.

DD_TAGS

String

Set global tags to be attached to every span. Value must be either comma or space separated. e.g. key1:value1,key2,value2 or key1:value key2:value2. Comma separated support added in v0.38.0 and space separated support added in v0.48.0.

DD_VERSION

String

Set an application’s version in traces and logs e.g. 1.2.3, 6c44da20, 2020.02.13. Generally set along with DD_SERVICE. Added in v0.36.0. See Unified Service Tagging for more information.

DD_SITE

String

datadoghq.com

Specify which site to use for uploading profiles. Set to datadoghq.eu to use EU site.

DD_TRACE_ENABLED

Boolean

True

Enable sending of spans to the Agent. Note that instrumentation will still be installed and spans will be generated. Added in v0.41.0 (formerly named DATADOG_TRACE_ENABLED).

DD_TRACE_DEBUG

Boolean

False

Enables debug logging in the tracer. Setting this flag will cause the library to create a root logging handler if one does not already exist. Added in v0.41.0 (formerly named DATADOG_TRACE_DEBUG).

DD_TRACE_<INTEGRATION>_ENABLED

Boolean

True

Enables <INTEGRATION> to be patched. For example, DD_TRACE_DJANGO_ENABLED=false will disable the Django integration from being installed. Added in v0.41.0.

DATADOG_PATCH_MODULES

String

Override the modules patched for this execution of the program. Must be a list in the module1:boolean,module2:boolean format. For example, boto:true,redis:false.

DD_LOGS_INJECTION

Boolean

True

Enables Logs Injection.

DD_TRACE_AGENT_URL

URL

http://localhost:8126

The URL to use to connect the Datadog agent. The url can starts with http:// to connect using HTTP or with unix:// to use a Unix Domain Socket.

DD_TRACE_STARTUP_LOGS

Boolean

False

Enable or disable start up diagnostic logging.

DD_TRACE_SAMPLE_RATE

Float

1.0

A float, f, 0.0 <= f <= 1.0. f*100% of traces will be sampled.

DD_PROFILING_ENABLED

Boolean

False

Enable Datadog profiling when using ddtrace-run.

DD_PROFILING_API_TIMEOUT

Float

10

The timeout in seconds before dropping events if the HTTP API does not reply.

DD_PROFILING_MAX_TIME_USAGE_PCT

Float

1

The percentage of maximum time the stack profiler can use when computing statistics. Must be greater than 0 and lesser or equal to 100.

DD_PROFILING_MAX_FRAMES

Integer

64

The maximum number of frames to capture in stack execution tracing.

DD_PROFILING_CAPTURE_PCT

Float

2

The percentage of events that should be captured (e.g. memory allocation). Greater values reduce the program execution speed. Must be greater than 0 lesser or equal to 100.

DD_PROFILING_UPLOAD_INTERVAL

Float

60

The interval in seconds to wait before flushing out recorded events.

DD_PROFILING_IGNORE_PROFILER

Boolean

True

Whether to ignore the profiler in the generated data.

DD_PROFILING_TAGS

String

The tags to apply to uploaded profile. Must be a list in the key1:value,key2:value2 format.