Configuring the Ruby SDK

Docs > APM > Application Instrumentation > Configure the Datadog SDK > Configuring the Ruby SDK

After you set up the SDK with your code and configure the Agent to collect APM data, optionally configure the SDK as desired, including setting up Unified Service Tagging.

To verify your runtime configuration and confirm settings, view the current configuration of your service in Datadog. Navigate to the APM Service Page, click Service Config, and select the SDK Configuration tab.

For additional configuration options beyond the environment variables listed below, see Additional Ruby configuration.

Configuration keys

365 configuration keys available for this library.

General Settings

(12)

Top-level Datadog configuration: API keys, service identity, Agent connection, intake site, hostname, global tags, and proxy settings.

DD_AGENT_HOST: Type: string
Default: 127.0.0.1
Hostname or IP address of the Datadog Agent that this library sends trace data to.
DD_API_KEY: Type: string
Aliases:DATADOG_API_KEY
Sets the Datadog API key used to authenticate outbound requests when running in agentless mode (sending data directly to Datadog without a local Agent). Required for agentless CI test reporting and LLM Observability agentless mode.
DD_APM_TRACING_ENABLED: Type: boolean
Default: true
Aliases:DD_TRACING_ENABLED
Enables or disables sending APM trace data. When disabled, tracing still runs to support other products, but only periodic heartbeat traces and manually kept traces are sent.
DD_APP_KEY: Type: string
Since: v2.25.0
Sets the application key used to authenticate LLM Observability dataset and experiment requests in agentless mode. If agentless mode is enabled and this is not set, dataset/experiment operations that require an application key will fail.
DD_ENV: Type: string
The application’s environment. Sets the “env” tag on every span.
DD_EXTERNAL_ENV: Type: string
Since: v2.24.0
Sets an external environment identifier attached to emitted telemetry for origin and environment attribution.
DD_FLAGGING_EVALUATION_COUNTS_ENABLED: Type: boolean
Default: true
Since: v2.37.0
Enables server-side reporting of OpenFeature flag evaluation counts. When enabled (the default), the tracer aggregates flag evaluations and periodically sends per-flag evaluation counts — including the first and last evaluation timestamps — to Datadog’s flag-evaluation track, alongside the existing feature_flag.evaluations metrics. Set to false to stop sending evaluation-count data; other feature-flag telemetry (metrics and exposures) is unaffected. Takes effect only when the Datadog OpenFeature flagging provider is enabled.
DD_HOSTNAME: Type: string
Since: v2.33.0
Overrides the hostname used for tagging and telemetry when hostname auto-detection is unreliable. The value must be a valid hostname; invalid values are ignored and hostname auto-detection is used instead.
DD_SERVICE: Type: string
Default: ruby
Aliases:OTEL_SERVICE_NAME
Your application’s default service name, set as the service tag on traces.
DD_SITE: Type: string
Datadog site used to select the Datadog intake domain for agentless requests, such as telemetry and AI Guard API calls.
DD_TAGS: Type: map
Aliases:OTEL_RESOURCE_ATTRIBUTES
Custom tags applied to traces, provided as comma-separated key:value pairs (e.g. layer:api,team:intake).
DD_VERSION: Type: string
Your application version, set as the version tag on traces.

Tracing Core

(17)

Core distributed tracing engine: Agent connection, trace and span ID generation, span lifecycle management, peer service mapping, resource normalization, query string obfuscation, and DB client configuration.

DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED: Type: boolean
Default: true
Controls whether the tracer generates 128-bit W3C trace IDs (32-character hex) or 64-bit Datadog trace IDs (16-character hex). 128-bit IDs are required for full W3C traceparent interoperability.
DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED: Type: boolean
Default: true
Controls whether 128-bit trace IDs are logged in their full 32-character format or truncated to 16 characters. Set to false for compatibility with systems that expect the shorter format.
DD_TRACE_AGENT_PORT: Type: int
Default: 8126
The port of the Trace Agent that the tracer submits to. If the Agent configuration sets receiver_port or DD_APM_RECEIVER_PORT to something other than the default 8126, then DD_TRACE_AGENT_PORT or DD_TRACE_AGENT_URL must match it.
DD_TRACE_AGENT_TIMEOUT_SECONDS: Type: int
Default: 30
Timeout (in seconds) for connecting to the Datadog Agent when sending trace data.
DD_TRACE_AGENT_URL: Type: string
URL endpoint where this library sends trace data to the Datadog Agent. Can use HTTP or a Unix domain socket. Has priority over agent.host and agent.port. If the Agent configuration sets receiver_port or DD_APM_RECEIVER_PORT to something other than the default 8126, then DD_TRACE_AGENT_PORT or DD_TRACE_AGENT_URL must match it.
DD_TRACE_ANALYTICS_ENABLED: Type: boolean
Enables the legacy tracing analytics feature (deprecated).
DD_TRACE_CLIENT_IP_ENABLED: Type: boolean
Default: false
Enables or disables the automatic collection of client IP addresses from HTTP request headers. When enabled, the IP address is stored in the http.client_ip span tag.
DD_TRACE_CLIENT_IP_HEADER: Type: string
Name of an optional custom HTTP header used to resolve the client IP address.
DD_TRACE_ENABLED: Type: boolean
Default: true
Aliases:OTEL_TRACES_EXPORTER
Enables or disables tracing. When disabled, instrumentation still runs but no trace data is sent.
DD_TRACE_NATIVE_SPAN_EVENTS: Type: boolean
Forces the tracer to always send span events using the native span events format, which can be useful in agentless setups.
DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED: Type: boolean
Default: false
When enabled, the tracer computes default peer.service values for eligible spans using the v1 peer-service default algorithm under Naming Schema v0. When disabled, Naming Schema v0 leaves peer.service unset.
DD_TRACE_PEER_SERVICE_MAPPING: Type: map
Maps detected peer service names to normalized values before they are attached to spans.
DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED: Type: boolean
Default: false
When enabled, integrations under Naming Schema v0 stop using inferred service names and fall back to the application service name. Use this to make all spans report under DD_SERVICE regardless of integration.
DD_TRACE_REPORT_HOSTNAME: Type: boolean
Default: false
Whether to report the system’s hostname for each trace. When disabled, the hostname of the Agent is used instead.
DD_TRACE_RESOURCE_RENAMING_ALWAYS_SIMPLIFIED_ENDPOINT: Type: boolean
Default: false
Since: v2.23.0
When enabled, always sets the http.endpoint tag to the result of the Resource Renaming simplification algorithm, even when an explicit endpoint is available.
DD_TRACE_RESOURCE_RENAMING_ENABLED: Type: boolean
Default: false
Since: v2.23.0
Controls whether the http.endpoint tag is computed and added for incoming HTTP requests. This is disabled by default unless application security is enabled at startup, and can be explicitly enabled or disabled with this setting.
DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH: Type: int
Default: 512
Maximum length of the x-datadog-tags header for trace tag propagation. Set to 0 to disable.

Trace Sampling

(5)

Sampling rules and rates that determine which traces and spans are kept or dropped, including per-service rules, rate limiting, and priority sampling.

DD_SPAN_SAMPLING_RULES: Type: string
Span sampling: JSON rules used to decide per-span sampling priority (single-span sampling). If both DD_SPAN_SAMPLING_RULES and DD_SPAN_SAMPLING_RULES_FILE are set, the file setting is ignored. Rules can match spans by service/name and apply a sample rate and optional max-per-second limit.
DD_SPAN_SAMPLING_RULES_FILE: Type: string
Points to a JSON file that contains the span sampling rules. DD_SPAN_SAMPLING_RULES takes precedence over this variable. See DD_SPAN_SAMPLING_RULES for the rule format.
DD_TRACE_RATE_LIMIT: Type: int
Default: 100
Sets the maximum number of traces to sample per second; applies only when either DD_TRACE_SAMPLING_RULES or DD_TRACE_SAMPLE_RATE is set.
DD_TRACE_SAMPLE_RATE: Type: decimal
Aliases:OTEL_TRACES_SAMPLER
Controls the ingestion sample rate (between 0.0 and 1.0) between the Agent and the backend. Use OTEL_TRACES_SAMPLER as an alias
DD_TRACE_SAMPLING_RULES: Type: string
Semi-colon separated list of sampling rules. The rule is matched in order of specification. The first match in a list is used. Per entry: The item “sample_rate” is required in decimal format. The item “service” is optional in regular expression format, to match on service name. The item “name” is optional in regular expression format, to match on operation name. To give a rate of 50% to any traces in a service starting with the text “cart”: ‘[{“sample_rate”:0.5, “service”:“cart.”}]’ To give a rate of 20% to any traces which have an operation name of “http.request”: ‘[{“sample_rate”:0.2, “name”:“http.request”}]’ To give a rate of 100% to any traces within a service named “background” and with an operation name of “sql.query”: ‘[{“sample_rate”:1.0, “service”:“background”, “name”:“sql.query”}] To give a rate of 10% to all traces ‘[{“sample_rate”:0.1}]’ To configure multiple rules, separate by semi-colon and order from most specific to least specific: ‘[{“sample_rate”:0.5, “service”:“cart.”}, {“sample_rate”:0.2, “name”:“http.request”}, {“sample_rate”:1.0, “service”:“background”, “name”:“sql.query”}, {“sample_rate”:0.1}]’ If no rules are specified, or none match, default internal sampling logic will be used.

Trace Propagation

(13)

Distributed trace context propagation, extraction and injection behavior, baggage handling, header tagging, HTTP client and server configuration, and SQL comment injection for Database Monitoring.

DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED: Type: boolean
Default: true
Since: v2.30.0
Controls whether process-level tags (such as entrypoint metadata) are collected and attached to tracing payloads.
DD_TRACE_BAGGAGE_TAG_KEYS: Type: array
Default: user.id, session.id, account.id
Comma-separated list of baggage keys to copy into span tags. Set to * to tag all baggage items; if unset, a default allowlist is used.
DD_TRACE_HEADER_TAGS: Type: array
Comma-separated list of HTTP headers to apply automatically as span tags. Each entry can be either a bare header name (which is reported under http.request.headers.<header> for incoming requests and http.response.headers.<header> for outgoing responses) or <header>:<custom_tag_name> to control the tag key.
DD_TRACE_HTTP_CLIENT_ERROR_STATUSES: Type: string
Default: 400-499
Since: v2.23.0
Aliases:DD_HTTP_CLIENT_ERROR_STATUSES
Comma-separated list of HTTP status codes and ranges to treat as errors for HTTP client spans (for example, 400-499,500). When set, matching responses mark the span as an error.
DD_TRACE_HTTP_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the net/http integration
DD_TRACE_HTTP_ERROR_STATUS_CODES: Type: string
Default: 400-599
HTTP status codes that should be marked as errors for spans generated by the net/http instrumentation. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')
DD_TRACE_HTTP_SERVER_ERROR_STATUSES: Type: string
Default: 500-599
Since: v2.23.0
Aliases:DD_HTTP_SERVER_ERROR_STATUSES
Comma-separated list of HTTP status codes or ranges treated as errors for HTTP server spans (for example, 500-599,404). Overrides the default behavior of flagging only 5xx responses as errors.
DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED: Type: boolean
Default: false
Since: v2.33.0
Aliases:DD_TRACE_INFERRED_SPANS_ENABLED
When enabled, the tracer registers the inferred-proxy propagator, which reads x-dd-proxy* headers (currently x-dd-proxy=aws-apigateway) and starts an inferred proxy span as the parent of the server span, using header values for service, resource, and tags.
DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT: Type: string
Default: continue
Since: v2.36.0
Specifies how incoming distributed tracing headers should be handled at a service level. Accepted values are: continue: The SDK will continue the distributed trace if the incoming distributed tracing headers represent a valid trace context. restart: The SDK will always start a new trace. If the incoming distributed tracing headers represent a valid trace context, that trace context will be represented as a span link on service entry spans (as opposed to the parent span in the continue configuration). ignore: The SDK will always start a new trace and all incoming distributed tracing headers are ignored.
DD_TRACE_PROPAGATION_EXTRACT_FIRST: Type: boolean
Default: false
When set to true, stops extracting after the first successful trace context extraction.
DD_TRACE_PROPAGATION_STYLE: Type: array
Aliases:OTEL_PROPAGATORS
Distributed tracing propagation formats to use for both extraction and injection.
DD_TRACE_PROPAGATION_STYLE_EXTRACT: Type: array
Default: datadog, tracecontext, baggage
Aliases:DD_TRACE_PROPAGATION_STYLE
A comma-separated list of header formats from which to attempt to extract distributed tracing propagation data. The first format found with complete and valid headers is used to define the trace to continue.
DD_TRACE_PROPAGATION_STYLE_INJECT: Type: array
Default: datadog, tracecontext, baggage
Aliases:DD_TRACE_PROPAGATION_STYLE
Comma-separated list of header formats to include to propagate distributed traces between services.

Trace Integrations

(204)

Per-integration tracing configuration: enable/disable, analytics, service name, peer service overrides for library integrations and controls for disabling specific instrumentations.

General Integration Settings

DD_DISABLE_DATADOG_RAILS: Type: string
Aliases:DISABLE_DATADOG_RAILS
Disables the Datadog Rails integration auto-instrumentation.

Configuration Kinds

Each integration can support one or more of these configuration patterns. Replace <INTEGRATION> with the integration name (for example, GRPC, AWS, REDIS).

`DD_TRACE_<INTEGRATION>_ENABLED`

(54 integrations)

Enable or disable tracing for a specific integration.

Available integrations:ACTION_CABLE, ACTION_MAILER, ACTION_PACK, ACTION_VIEW, ACTIVE_JOB, ACTIVE_MODEL_SERIALIZERS, ACTIVE_RECORD, ACTIVE_SUPPORT, AWS, CONCURRENT_RUBY, DALLI, DELAYED_JOB, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRAPE, GRAPHQL, GRPC, HANAMI, HTTP, HTTPCLIENT, HTTPRB, KAFKA, KARAFKA, LOGRAGE, MEMCACHED_COMMAND, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, QUE, QUE_TAG_ARGS, QUE_TAG_DATA, RACECAR, RACK, RAILS, RAKE, REDIS, RESQUE, REST_CLIENT, RODA, SEMANTIC_LOGGER, SEQUEL, SHORYUKEN, SIDEKIQ, SINATRA, SNEAKERS, STRIPE, SUCKER_PUNCH, TEST_MODE, TRILOGY, WATERDROP

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`

(43 integrations)

Enable App Analytics (trace search) for spans produced by this integration.

Available integrations:ACTION_CABLE, ACTION_MAILER, ACTION_PACK, ACTION_VIEW, ACTIVE_JOB, ACTIVE_MODEL_SERIALIZERS, ACTIVE_RECORD, ACTIVE_SUPPORT, AWS, DALLI, DELAYED_JOB, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRAPE, GRAPHQL, GRPC, HTTP, HTTPCLIENT, HTTPRB, KAFKA, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, QUE, RACECAR, RACK, RAILS, RAKE, REDIS, RESQUE, REST_CLIENT, SEQUEL, SHORYUKEN, SIDEKIQ, SINATRA, SNEAKERS, STRIPE, SUCKER_PUNCH, TRILOGY

`DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE`

(43 integrations)

Set the App Analytics sample rate for this integration (0.0 to 1.0).

Available integrations:ACTION_CABLE, ACTION_MAILER, ACTION_PACK, ACTION_VIEW, ACTIVE_JOB, ACTIVE_MODEL_SERIALIZERS, ACTIVE_RECORD, ACTIVE_SUPPORT, AWS, DALLI, DELAYED_JOB, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRAPE, GRAPHQL, GRPC, HTTP, HTTPCLIENT, HTTPRB, KAFKA, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, QUE, RACECAR, RACK, RAILS, RAKE, REDIS, RESQUE, REST_CLIENT, SEQUEL, SHORYUKEN, SIDEKIQ, SINATRA, SNEAKERS, STRIPE, SUCKER_PUNCH, TRILOGY

`DD_TRACE_<INTEGRATION>_PEER_SERVICE`

(17 integrations)

Override the peer.service tag for outbound requests from this integration.

Available integrations:AWS, DALLI, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRPC, HTTPCLIENT, HTTPRB, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, REDIS, REST_CLIENT, TRILOGY

`DD_TRACE_<INTEGRATION>_SERVICE_NAME`

(17 integrations)

Override the service name for spans produced by this integration.

Available integrations:AWS, DALLI, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRPC, HTTPCLIENT, HTTPRB, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, REDIS, REST_CLIENT, TRILOGY

`DD_TRACE_<INTEGRATION>_DISTRIBUTED_TRACING`

(14 integrations)

Enable or disable distributed trace propagation for this integration.

Available integrations:ETHON, EXCON, FARADAY, GRPC, HTTPCLIENT, HTTPRB, KARAFKA, QUE, RACK, RAILS, REST_CLIENT, SIDEKIQ, SINATRA, WATERDROP

`DD_TRACE_<INTEGRATION>_ERROR_STATUS_CODES`

(5 integrations)

Define which HTTP status codes are treated as errors for this integration.

Available integrations:EXCON, FARADAY, GRAPE, HTTPCLIENT, HTTPRB

Per-Integration Settings (55 integrations)

Each section lists all configuration keys available for a specific integration.

ACTION_CABLE

(3)

DD_TRACE_ACTION_CABLE_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Action Cable integration.
DD_TRACE_ACTION_CABLE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Action Cable integration.
DD_TRACE_ACTION_CABLE_ENABLED: Type: boolean
Default: true
Enables tracing for the Action Cable integration.

ACTION_MAILER

(3)

DD_TRACE_ACTION_MAILER_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Action Mailer integration.
DD_TRACE_ACTION_MAILER_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Action Mailer integration.
DD_TRACE_ACTION_MAILER_ENABLED: Type: boolean
Default: true
Enables tracing for the Action Mailer integration.

ACTION_PACK

(3)

DD_TRACE_ACTION_PACK_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the Action Pack integration.
DD_TRACE_ACTION_PACK_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Action Pack integration.
DD_TRACE_ACTION_PACK_ENABLED: Type: boolean
Default: true
Enables tracing for the Action Pack integration.

ACTION_VIEW

(3)

DD_TRACE_ACTION_VIEW_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Action View integration.
DD_TRACE_ACTION_VIEW_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Action View integration.
DD_TRACE_ACTION_VIEW_ENABLED: Type: boolean
Default: true
Enables tracing for the Action View integration.

ACTIVE_JOB

(3)

DD_TRACE_ACTIVE_JOB_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Active Job integration.
DD_TRACE_ACTIVE_JOB_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Active Job integration.
DD_TRACE_ACTIVE_JOB_ENABLED: Type: boolean
Default: true
Enables tracing for the Active Job integration.

ACTIVE_MODEL_SERIALIZERS

(3)

DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Active Model Serializers integration.
DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Active Model Serializers integration.
DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ENABLED: Type: boolean
Default: true
Enables tracing for the Active Model Serializers integration.

ACTIVE_RECORD

(3)

DD_TRACE_ACTIVE_RECORD_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Active Record integration.
DD_TRACE_ACTIVE_RECORD_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Active Record integration.
DD_TRACE_ACTIVE_RECORD_ENABLED: Type: boolean
Default: true
Enables tracing for the Active Record integration.

ACTIVE_SUPPORT

(3)

DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Active Support integration.
DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Active Support integration.
DD_TRACE_ACTIVE_SUPPORT_ENABLED: Type: boolean
Default: true
Enables tracing for the Active Support integration.

AWS

(5)

DD_TRACE_AWS_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by the AWS SDK integration by setting the analytics sample rate to 1.0.
DD_TRACE_AWS_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the AWS integration.
DD_TRACE_AWS_ENABLED: Type: boolean
Default: true
Enables tracing for the AWS integration.
DD_TRACE_AWS_PEER_SERVICE: Type: string
Name of the external service for spans generated by the AWS integration.
DD_TRACE_AWS_SERVICE_NAME: Type: string
Default: aws
Service name used for spans generated by the AWS integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

CONCURRENT_RUBY

(1)

DD_TRACE_CONCURRENT_RUBY_ENABLED: Type: boolean
Default: true
Controls whether the Concurrent Ruby integration propagates tracing context.

DALLI

(5)

DD_TRACE_DALLI_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Dalli integration.
DD_TRACE_DALLI_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Dalli integration.
DD_TRACE_DALLI_ENABLED: Type: boolean
Default: true
Enables tracing for the Dalli integration.
DD_TRACE_DALLI_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Dalli integration.
DD_TRACE_DALLI_SERVICE_NAME: Type: string
Default: memcached
Service name used for spans generated by the Dalli integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

DELAYED_JOB

(3)

DD_TRACE_DELAYED_JOB_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Delayed Job integration.
DD_TRACE_DELAYED_JOB_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Delayed Job integration.
DD_TRACE_DELAYED_JOB_ENABLED: Type: boolean
Default: true
Enables tracing for the Delayed Job integration.

ELASTICSEARCH

(5)

DD_TRACE_ELASTICSEARCH_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Elasticsearch integration.
DD_TRACE_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the Elasticsearch integration.
DD_TRACE_ELASTICSEARCH_ENABLED: Type: boolean
Default: true
Enables instrumentation for elasticsearch. When disabled, spans for elasticsearch operations are not created.
DD_TRACE_ELASTICSEARCH_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Elasticsearch integration.
DD_TRACE_ELASTICSEARCH_SERVICE_NAME: Type: string
Default: elasticsearch
Service name used for spans generated by the Elasticsearch integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

ETHON

(6)

DD_TRACE_ETHON_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Ethon integration.
DD_TRACE_ETHON_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Ethon integration.
DD_TRACE_ETHON_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the ethon integration
DD_TRACE_ETHON_ENABLED: Type: boolean
Default: true
Enables tracing for the Ethon integration.
DD_TRACE_ETHON_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Ethon integration.
DD_TRACE_ETHON_SERVICE_NAME: Type: string
Default: ethon
Service name used for spans generated by the Ethon integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

EXCON

(7)

DD_TRACE_EXCON_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Excon integration.
DD_TRACE_EXCON_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Excon integration.
DD_TRACE_EXCON_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the excon integration
DD_TRACE_EXCON_ENABLED: Type: boolean
Default: true
Enables tracing for the Excon integration.
DD_TRACE_EXCON_ERROR_STATUS_CODES: Type: array
Default: 400-599
HTTP status codes that should be marked as errors for spans generated by the Excon integration. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')
DD_TRACE_EXCON_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Excon integration.
DD_TRACE_EXCON_SERVICE_NAME: Type: string
Default: excon
Service name used for spans generated by the Excon integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

FARADAY

(7)

DD_TRACE_FARADAY_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Faraday integration.
DD_TRACE_FARADAY_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Faraday integration.
DD_TRACE_FARADAY_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the faraday integration
DD_TRACE_FARADAY_ENABLED: Type: boolean
Default: true
Enables tracing for the Faraday integration.
DD_TRACE_FARADAY_ERROR_STATUS_CODES: Type: array
Default: 400-599
HTTP status codes that should be marked as errors for spans generated by the Faraday integration. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')
DD_TRACE_FARADAY_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Faraday integration.
DD_TRACE_FARADAY_SERVICE_NAME: Type: string
Default: faraday
Service name used for spans generated by the Faraday integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

GRAPE

(4)

DD_TRACE_GRAPE_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the Grape integration.
DD_TRACE_GRAPE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Grape integration.
DD_TRACE_GRAPE_ENABLED: Type: boolean
Default: true
Enables tracing for the Grape integration.
DD_TRACE_GRAPE_ERROR_STATUS_CODES: Type: array
Default: 500-599
HTTP status codes that should be marked as errors for spans generated by the Grape integration. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')

GRAPHQL

(6)

DD_TRACE_GRAPHQL_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the GraphQL integration.
DD_TRACE_GRAPHQL_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the GraphQL integration.
DD_TRACE_GRAPHQL_ENABLED: Type: boolean
Default: true
Enables instrumentation for graphql. When disabled, spans for graphql operations are not created.
DD_TRACE_GRAPHQL_ERROR_EXTENSIONS: Type: array
Comma-separated list of GraphQL error extension keys to capture as span tags. When unset, no extensions are captured.
DD_TRACE_GRAPHQL_ERROR_TRACKING: Type: boolean
Default: false
Surfaces GraphQL errors in Error Tracking.
DD_TRACE_GRAPHQL_WITH_UNIFIED_TRACER: Type: boolean
Default: false
Enables GraphQL instrumentation using the UnifiedTrace tracer (recommended for graphql >= 2.2) to support the Endpoints list.

GRPC

(6)

DD_TRACE_GRPC_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by the gRPC integration by setting the analytics sample rate to 1.0.
DD_TRACE_GRPC_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_GRPC_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the gRPC integration.
DD_TRACE_GRPC_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the grpc integration
DD_TRACE_GRPC_ENABLED: Type: boolean
Default: true
Enables instrumentation for grpc. When disabled, spans for grpc operations are not created.
DD_TRACE_GRPC_PEER_SERVICE: Type: string
Name of the external service for spans generated by the gRPC integration.
DD_TRACE_GRPC_SERVICE_NAME: Type: string
Default: grpc
Service name used for spans generated by the gRPC integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

HANAMI

(1)

DD_TRACE_HANAMI_ENABLED: Type: boolean
Default: true
Enables tracing for the Hanami integration.

HTTP

(3)

DD_TRACE_HTTP_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by the net/http integration by setting the analytics sample rate to 1.0.
DD_TRACE_HTTP_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the net/http integration.
DD_TRACE_HTTP_ENABLED: Type: boolean
Default: true
Enables instrumentation for http. When disabled, spans for http operations are not created.

HTTPCLIENT

(7)

DD_TRACE_HTTPCLIENT_ANALYTICS_ENABLED: Type: boolean
Default: false
Aliases:DD_HTTPCLIENT_ANALYTICS_ENABLED
Enables analytics for the httpclient integration.
DD_TRACE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_HTTPCLIENT_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the httpclient integration.
DD_TRACE_HTTPCLIENT_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the httpclient integration
DD_TRACE_HTTPCLIENT_ENABLED: Type: boolean
Default: true
Aliases:DD_INTEGRATION_HTTPCLIENT_ENABLED, DD_TRACE_INTEGRATION_HTTPCLIENT_ENABLED
Enables tracing for the httpclient integration.
DD_TRACE_HTTPCLIENT_ERROR_STATUS_CODES: Type: array
Default: 400-599
HTTP status codes that should be marked as errors for spans generated by the httpclient integration. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')
DD_TRACE_HTTPCLIENT_PEER_SERVICE: Type: string
Name of the external service for spans generated by the httpclient integration.
DD_TRACE_HTTPCLIENT_SERVICE_NAME: Type: string
Default: httpclient
Service name used for spans generated by the httpclient integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

HTTPRB

(7)

DD_TRACE_HTTPRB_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the httprb integration.
DD_TRACE_HTTPRB_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the httprb integration.
DD_TRACE_HTTPRB_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the httprb integration
DD_TRACE_HTTPRB_ENABLED: Type: boolean
Default: true
Enables tracing for the httprb integration.
DD_TRACE_HTTPRB_ERROR_STATUS_CODES: Type: string
Default: 400-599
HTTP status codes that should be marked as errors for spans generated by the httprb integration. Value can be a range (400...600), or an array of ranges/integers [403, 500...600]. If configured with environment variable, use dash for range ('400-599') and comma for adding element into an array ('403,500-599')
DD_TRACE_HTTPRB_PEER_SERVICE: Type: string
Name of the external service for spans generated by the httprb integration.
DD_TRACE_HTTPRB_SERVICE_NAME: Type: string
Default: httprb
Service name used for spans generated by the httprb integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

KAFKA

(3)

DD_TRACE_KAFKA_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by Kafka integrations by setting the analytics sample rate to 1.0.
DD_TRACE_KAFKA_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_KAFKA_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the Kafka integration.
DD_TRACE_KAFKA_ENABLED: Type: boolean
Default: true
Aliases:DD_INTEGRATION_KAFKA_ENABLED, DD_TRACE_INTEGRATION_KAFKA_ENABLED
Enables tracing for the Kafka integration.

KARAFKA

(2)

DD_TRACE_KARAFKA_DISTRIBUTED_TRACING: Type: boolean
Default: false
Since: v2.30.0
If enabled, activates distributed tracing for the karafka integration
DD_TRACE_KARAFKA_ENABLED: Type: boolean
Default: true
Enables tracing for the Karafka integration.

LOGRAGE

(1)

DD_TRACE_LOGRAGE_ENABLED: Type: boolean
Default: true
Enables injecting trace correlation fields into Lograge logs when log injection is enabled.

MEMCACHED_COMMAND

(1)

DD_TRACE_MEMCACHED_COMMAND_ENABLED: Type: boolean
Default: false
Enable memcached command tagging if DD_TRACE_MEMCACHED_COMMAND_ENABLED is enabled

MONGO

(6)

DD_TRACE_MONGO_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by MongoDB integrations by setting the analytics sample rate to 1.0.
DD_TRACE_MONGO_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_MONGO_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the MongoDB integration.
DD_TRACE_MONGO_ENABLED: Type: boolean
Default: true
Aliases:DD_INTEGRATION_MONGO_ENABLED, DD_TRACE_INTEGRATION_MONGO_ENABLED
Enables tracing for the MongoDB integration.
DD_TRACE_MONGO_JSON_COMMAND: Type: boolean
Default: false
Serializes the MongoDB command as JSON on spans to enable query introspection in the Datadog app.
DD_TRACE_MONGO_PEER_SERVICE: Type: string
Name of the external service for spans generated by the MongoDB integration.
DD_TRACE_MONGO_SERVICE_NAME: Type: string
Default: mongodb
Service name used for spans generated by the MongoDB integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

MYSQL2

(5)

DD_TRACE_MYSQL2_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the mysql2 integration.
DD_TRACE_MYSQL2_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the mysql2 integration.
DD_TRACE_MYSQL2_ENABLED: Type: boolean
Default: true
Enables instrumentation for mysql2. When disabled, spans for mysql2 operations are not created.
DD_TRACE_MYSQL2_PEER_SERVICE: Type: string
Name of the external service for spans generated by the mysql2 integration.
DD_TRACE_MYSQL2_SERVICE_NAME: Type: string
Default: mysql2
Service name used for spans generated by the mysql2 integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

NET

(2)

DD_TRACE_NET_HTTP_PEER_SERVICE: Type: string
Name of the external service for spans generated by the net/http integration.
DD_TRACE_NET_HTTP_SERVICE_NAME: Type: string
Default: net/http
Service name used for spans generated by the net/http integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

OPENSEARCH

(6)

DD_TRACE_OPENSEARCH_ANALYTICS_ENABLED: Type: boolean
Default: false
Aliases:DD_OPENSEARCH_ANALYTICS_ENABLED
Enables analytics for the OpenSearch integration.
DD_TRACE_OPENSEARCH_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_OPENSEARCH_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the OpenSearch integration.
DD_TRACE_OPENSEARCH_ENABLED: Type: boolean
Default: true
Enables instrumentation for opensearch. When disabled, spans for opensearch operations are not created.
DD_TRACE_OPENSEARCH_PEER_SERVICE: Type: string
Name of the external service for spans generated by the OpenSearch integration.
DD_TRACE_OPENSEARCH_RESOURCE_PATTERN: Type: string
Default: absolute
Controls whether OpenSearch span resource names use the full or relative URL path.
DD_TRACE_OPENSEARCH_SERVICE_NAME: Type: string
Default: opensearch
Service name used for spans generated by the OpenSearch integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

PG

(5)

DD_TRACE_PG_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the pg (Postgres) integration.
DD_TRACE_PG_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the pg (Postgres) integration.
DD_TRACE_PG_ENABLED: Type: boolean
Default: true
Enables instrumentation for pg. When disabled, spans for pg operations are not created.
DD_TRACE_PG_PEER_SERVICE: Type: string
Name of the external service for spans generated by the pg (Postgres) integration.
DD_TRACE_PG_SERVICE_NAME: Type: string
Default: pg
Service name used for spans generated by the pg (Postgres) integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

PRESTO

(5)

DD_TRACE_PRESTO_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Presto integration.
DD_TRACE_PRESTO_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Presto integration.
DD_TRACE_PRESTO_ENABLED: Type: boolean
Default: true
Enables tracing for the Presto integration.
DD_TRACE_PRESTO_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Presto integration.
DD_TRACE_PRESTO_SERVICE_NAME: Type: string
Default: presto
Service name used for spans generated by the Presto integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

QUE

(4)

DD_TRACE_QUE_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Que integration.
DD_TRACE_QUE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Que integration.
DD_TRACE_QUE_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the que integration
DD_TRACE_QUE_ENABLED: Type: boolean
Default: true
Enables tracing for the Que integration.

QUE_TAG_ARGS

(1)

DD_TRACE_QUE_TAG_ARGS_ENABLED: Type: boolean
Default: false
Enables tagging a Que job’s args field on spans.

QUE_TAG_DATA

(1)

DD_TRACE_QUE_TAG_DATA_ENABLED: Type: boolean
Default: false
Enables tagging a Que job’s data field on spans.

RACECAR

(3)

DD_TRACE_RACECAR_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Racecar integration.
DD_TRACE_RACECAR_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Racecar integration.
DD_TRACE_RACECAR_ENABLED: Type: boolean
Default: true
Enables tracing for the Racecar integration.

RACK

(4)

DD_TRACE_RACK_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the Rack integration.
DD_TRACE_RACK_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Rack integration.
DD_TRACE_RACK_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the rack integration
DD_TRACE_RACK_ENABLED: Type: boolean
Default: true
Enables tracing for the Rack integration.

RAILS

(4)

DD_TRACE_RAILS_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the Rails integration.
DD_TRACE_RAILS_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Rails integration.
DD_TRACE_RAILS_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the rails integration
DD_TRACE_RAILS_ENABLED: Type: boolean
Default: true
Enables tracing for the Rails integration.

RAKE

(3)

DD_TRACE_RAKE_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Rake integration.
DD_TRACE_RAKE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Rake integration.
DD_TRACE_RAKE_ENABLED: Type: boolean
Default: true
Enables tracing for the Rake integration.

REDIS

(6)

DD_REDIS_COMMAND_ARGS: Type: boolean
Default: false
When enabled, includes Redis command arguments in span resource names and tags; otherwise only the command name is shown.
DD_TRACE_REDIS_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables trace analytics for spans produced by Redis integrations by setting the analytics sample rate to 1.0.
DD_TRACE_REDIS_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Aliases:DD_REDIS_ANALYTICS_SAMPLE_RATE
Sampling rate for analytics events generated by the Redis integration.
DD_TRACE_REDIS_ENABLED: Type: boolean
Default: true
Aliases:DD_TRACE_INTEGRATION_REDIS_ENABLED, DD_INTEGRATION_REDIS_ENABLED
Enables instrumentation for redis. When disabled, spans for redis operations are not created.
DD_TRACE_REDIS_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Redis integration.
DD_TRACE_REDIS_SERVICE_NAME: Type: string
Default: redis
Service name used for spans generated by the Redis integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

RESQUE

(3)

DD_TRACE_RESQUE_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Resque integration.
DD_TRACE_RESQUE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Resque integration.
DD_TRACE_RESQUE_ENABLED: Type: boolean
Default: true
Enables tracing for the Resque integration.

REST_CLIENT

(6)

DD_TRACE_REST_CLIENT_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the RestClient integration.
DD_TRACE_REST_CLIENT_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the RestClient integration.
DD_TRACE_REST_CLIENT_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the rest-client integration
DD_TRACE_REST_CLIENT_ENABLED: Type: boolean
Default: true
Enables tracing for the RestClient integration.
DD_TRACE_REST_CLIENT_PEER_SERVICE: Type: string
Name of the external service for spans generated by the RestClient integration.
DD_TRACE_REST_CLIENT_SERVICE_NAME: Type: string
Default: rest_client
Service name used for spans generated by the RestClient integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

RODA

(3)

DD_RODA_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Roda integration.
DD_RODA_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Roda integration.
DD_TRACE_RODA_ENABLED: Type: boolean
Default: true
Enables tracing for the Roda integration.

SEMANTIC_LOGGER

(1)

DD_TRACE_SEMANTIC_LOGGER_ENABLED: Type: boolean
Default: true
Enables injecting trace correlation fields into Semantic Logger logs when log injection is enabled.

SEQUEL

(3)

DD_TRACE_SEQUEL_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Sequel integration.
DD_TRACE_SEQUEL_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Sequel integration.
DD_TRACE_SEQUEL_ENABLED: Type: boolean
Default: true
Enables tracing for the Sequel integration.

SHORYUKEN

(3)

DD_TRACE_SHORYUKEN_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Shoryuken integration.
DD_TRACE_SHORYUKEN_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Shoryuken integration.
DD_TRACE_SHORYUKEN_ENABLED: Type: boolean
Default: true
Enables tracing for the Shoryuken integration.

SIDEKIQ

(4)

DD_TRACE_SIDEKIQ_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Sidekiq integration.
DD_TRACE_SIDEKIQ_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Sidekiq integration.
DD_TRACE_SIDEKIQ_DISTRIBUTED_TRACING: Type: boolean
Default: false
Since: v2.30.0
If enabled, activates distributed tracing for the sidekiq integration
DD_TRACE_SIDEKIQ_ENABLED: Type: boolean
Default: true
Enables tracing for the Sidekiq integration.

SINATRA

(4)

DD_TRACE_SINATRA_ANALYTICS_ENABLED: Type: boolean
Enables analytics for the Sinatra integration.
DD_TRACE_SINATRA_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Sinatra integration.
DD_TRACE_SINATRA_DISTRIBUTED_TRACING: Type: boolean
Default: true
Since: v2.30.0
If enabled, activates distributed tracing for the sinatra integration
DD_TRACE_SINATRA_ENABLED: Type: boolean
Default: true
Enables tracing for the Sinatra integration.

SNEAKERS

(3)

DD_TRACE_SNEAKERS_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Sneakers integration.
DD_TRACE_SNEAKERS_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Sneakers integration.
DD_TRACE_SNEAKERS_ENABLED: Type: boolean
Default: true
Enables tracing for the Sneakers integration.

STRIPE

(3)

DD_TRACE_STRIPE_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Stripe integration.
DD_TRACE_STRIPE_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Stripe integration.
DD_TRACE_STRIPE_ENABLED: Type: boolean
Default: true
Enables tracing for the Stripe integration.

SUCKER_PUNCH

(3)

DD_TRACE_SUCKER_PUNCH_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Sucker Punch integration.
DD_TRACE_SUCKER_PUNCH_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Sucker Punch integration.
DD_TRACE_SUCKER_PUNCH_ENABLED: Type: boolean
Default: true
Enables tracing for the Sucker Punch integration.

TEST_MODE

(1)

DD_TRACE_TEST_MODE_ENABLED: Type: boolean
Default: false
Enables tracer test mode, using test-oriented trace flushing and writer behavior.

TRILOGY

(5)

DD_TRACE_TRILOGY_ANALYTICS_ENABLED: Type: boolean
Default: false
Enables analytics for the Trilogy integration.
DD_TRACE_TRILOGY_ANALYTICS_SAMPLE_RATE: Type: decimal
Default: 1.0
Sampling rate for analytics events generated by the Trilogy integration.
DD_TRACE_TRILOGY_ENABLED: Type: boolean
Default: true
Enables tracing for the Trilogy integration.
DD_TRACE_TRILOGY_PEER_SERVICE: Type: string
Name of the external service for spans generated by the Trilogy integration.
DD_TRACE_TRILOGY_SERVICE_NAME: Type: string
Default: trilogy
Service name used for spans generated by the Trilogy integration. May be overridden by DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED.

WATERDROP

(2)

DD_TRACE_WATERDROP_DISTRIBUTED_TRACING: Type: boolean
Default: false
Since: v2.30.0
If enabled, activates distributed tracing for the waterdrop integration
DD_TRACE_WATERDROP_ENABLED: Type: boolean
Default: true
Since: v2.23.0
Enables tracing for the WaterDrop integration.

Database Monitoring

(2)

Database Monitoring (DBM): SQL comment propagation modes and query identifier hashing for correlating database performance with application traces.

DD_DBM_INJECT_SQL_BASEHASH: Type: boolean
Default: false
Since: v2.29.0
Enables the injection of a “base hash” in SQL queries when DBM propagation is also enabled. This base hash is used to find matching spans, and enrich the queries with related values.
DD_DBM_PROPAGATION_MODE: Type: string
Default: disabled
Enables linking between data sent from APM and the Database Monitoring product when set to service or full. The service option enables the connection between DBM and APM services. The full option enables connection between database spans with database query events. Available for Postgres and MySQL.

Trace Logging

(2)

Tracer log output settings: log levels, log file paths, log rotation, and startup diagnostics.

DD_TRACE_DEBUG

Type: boolean
Default: false
Aliases:OTEL_LOG_LEVEL

Enables debug mode for the SDK. When set, the SDK emits verbose log messages for troubleshooting. Takes precedence over DD_TRACE_LOG_LEVEL when active. Use OTEL_LOG_LEVEL as an alias.

Language-specific notes:

PHP: log messages are written to the device or file set in the PHP error_log INI setting. The actual value may differ from php -i output because it can be overridden in PHP-FPM/Apache configuration files.

DD_TRACE_STARTUP_LOGS

Type: boolean
Prints startup configuration and diagnostics to logs to help assess tracing at application startup.

Continuous Profiling

(22)

Continuous Profiler configuration: enable/disable, upload settings, profiling types, engine options, code hotspots, endpoint profiling, and experimental features.

DD_PROFILING_ALLOCATION_ENABLED

Type: boolean
Default: false
Aliases:DD_PROFILING_DDPROF_ALLOC_ENABLED
If set to true, enables Allocation profiling (in Preview). Defaults to false.

DD_PROFILING_DIR_INTERRUPTION_WORKAROUND_ENABLED

Type: boolean
Default: true
Enables a workaround for Ruby Dir interruption issues caused by profiling signals.

DD_PROFILING_ENABLED

Type: boolean
Default: false
Aliases:DD_EXPERIMENTAL_PROFILING_ENABLED
Enables the continuous profiler, which collects CPU, heap, goroutine, and other runtime profiles and uploads them to Datadog.

DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

Type: boolean
Default: true
Aliases:DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED
Controls whether spans add a pprof label with the top-level request endpoint so profiles can be grouped by endpoint in the Datadog UI.

DD_PROFILING_EXPERIMENTAL_HEAP_ENABLED

Type: boolean
Default: false
Enables preview heap profiling, collecting heap profiles (requires allocation profiling).

DD_PROFILING_EXPERIMENTAL_HEAP_SAMPLE_RATE

Type: int
Default: 1
Sampling rate for heap profiling.

DD_PROFILING_EXPERIMENTAL_HEAP_SIZE_ENABLED

Type: boolean
Default: true
Enables collection of heap size profiles for heap profiling (requires allocation profiling and heap profiling).

DD_PROFILING_EXPERIMENTAL_USE_SYSTEM_DNS

Type: boolean
Default: true
Since: v2.30.0
Use system resolver for dns instead of built-in libdatadog one

DD_PROFILING_GC_ENABLED

Type: boolean
Default: true
Enables garbage collection profiling, collecting GC activity in profiles.

DD_PROFILING_GVL_ENABLED

Type: boolean
Default: true
Aliases:DD_PROFILING_PREVIEW_GVL_ENABLED
Enables GVL profiling to report time threads spend waiting for the Global VM Lock.

DD_PROFILING_HEAP_CLEAN_AFTER_GC_ENABLED

Type: boolean
Default: true
Controls whether heap profiling performs cleanup after garbage collection, rather than just at serialization time (requires GC profiling and heap profiling).

DD_PROFILING_MAX_FRAMES

Type: int
Default: 400
Maximum number of stack frames captured per thread sample in profiles.

DD_PROFILING_NATIVE_FILENAMES_ENABLED

Type: boolean
Default: true
Controls whether the profiler uses native filenames for stack frames from native code.

DD_PROFILING_NO_SIGNALS_WORKAROUND_ENABLED

Type: boolean
Enables a workaround mode that reduces reliance on profiling signals to avoid interrupt-related issues in some libraries.

DD_PROFILING_OVERHEAD_TARGET_PERCENTAGE

Type: decimal
Default: 2.0
Target overhead percentage for profiling; the profiler adjusts sampling to stay near this target.

DD_PROFILING_PREVIEW_OTEL_CONTEXT_ENABLED

Type: string
Default: false
Controls whether the profiler attempts to read context from OpenTelemetry.

DD_PROFILING_SHUTDOWN_ON_EXEC_ENABLED

Type: boolean
Default: true
Stops profiling before an exec call to avoid profiling state leaking into the new process.

DD_PROFILING_SIGHANDLER_SAMPLING_ENABLED

Type: boolean
Default: true
Controls whether the profiler samples directly from the signal handler for improved accuracy.

DD_PROFILING_SKIP_MYSQL2_CHECK

Type: boolean
Default: false
Disables the profiler compatibility check of the libmysqlclient version used by mysql2.

DD_PROFILING_TIMELINE_ENABLED

Type: boolean
Default: true
Aliases:DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED

Enable the timeline profile type

Note: This supersedes the DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED environment variable. (datadog.profiling.experimental_timeline_enabled INI setting), If both are set, this one takes precedence.

Language-specific notes:

PHP: This supersedes the datadog.profiling.experimental_timeline_enabled INI setting, which was available since 0.89

DD_PROFILING_UPLOAD_PERIOD

Type: int
Default: 60
Profiling: upload period in seconds (recording duration); controls how frequently profiles are uploaded

DD_PROFILING_UPLOAD_TIMEOUT

Type: decimal
Default: 30.0
Maximum time, in seconds, the profiler waits for an upload HTTP request to complete before cancelling it.

Application Security

(26)

Application Security configuration: ASM threat detection and blocking, user event tracking, IAST vulnerability detection, API Security schema discovery, and error tracking.

DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE: Type: decimal
Default: 0.5
Since: v2.29.0
Defines the probability of a downstream request body being sampled, or said differently, defines the overall number of requests for which the request and response body should be sampled / analysed.
DD_API_SECURITY_ENABLED: Type: boolean
Default: true
Aliases:DD_EXPERIMENTAL_API_SECURITY_ENABLED
Controls whether API Security features are enabled. If unset, API Security is enabled by default.
DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED: Type: boolean
Default: true
Controls whether API endpoint definitions are collected and reported for use in API Catalog. Disable to suppress endpoint discovery.
DD_API_SECURITY_MAX_DOWNSTREAM_BODY_BYTES: Type: int
Default: 10485760
Since: v2.37.0
Maximum size, in bytes, of a downstream HTTP response body that the tracer will buffer. Bodies larger than this limit are not read or kept in memory.
DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS: Type: int
Default: 1
Since: v2.29.0
The maximum number of downstream requests per request for which the request and response body should be analysed.
DD_API_SECURITY_REQUEST_SAMPLE_RATE: Type: decimal
Default: 0.1
Sets the sampling rate for API Security schema extraction. Values are clamped to the range 0.0 to 1.0; if unset or invalid, a default rate is used.
DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE: Type: string
Default: identification
Selects the AppSec automatic user instrumentation mode, which controls how user events are collected.
DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING: Type: string
Default: safe
Controls automated user events tracking for AppSec, including enabling/disabling it and selecting a tracking mode. Deprecated; prefer the appsec.auto_user_instrumentation.mode setting.
DD_APPSEC_BODY_PARSING_SIZE_LIMIT: Type: int
Default: 10485760
Since: v2.36.0
Sets the maximum number of bytes of HTTP request and response bodies to buffer and analyze for security features when running behind a proxy/external processing integration. Values of 0 or less disable body analysis, and bodies larger than the limit are truncated.
DD_APPSEC_ENABLED: Type: boolean
Default: false
Enables or disables the AppSec product inside the tracer. When enabled, the tracer initializes the AppSec module (in-app WAF, header/body collection, and AppSec telemetry).
DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML: Type: string
Path to a local HTML template file that will be returned when a request is blocked and the response should be HTML. If unset or invalid, the tracer uses the default blocking HTML template defined by the product RFC. The tracer decides HTML or JSON according to Accept header or the block action’s parameters.
DD_APPSEC_HTTP_BLOCKED_TEMPLATE_JSON: Type: string
Path to a local JSON template file that will be returned when a request is blocked and the response should be JSON. If unset or invalid, the tracer uses the default blocking HTML template defined by the product RFC. The tracer decides HTML or JSON according to Accept header or the block action’s parameters.
DD_APPSEC_HTTP_BLOCKED_TEMPLATE_TEXT: Type: string
Path to a plain-text template file used for blocked-request responses when plain text is the chosen format. If unset, the tracer uses its default text template or falls back to the JSON/HTML default behavior
DD_APPSEC_MAX_STACK_TRACE_DEPTH: Type: int
Default: 32
Aliases:DD_APPSEC_MAX_STACKTRACE_DEPTH
Maximum number of stack frames retained for any stack trace attached to an AppSec event. When the limit is reached, deeper frames are truncated and the top-of-stack frames are preserved. Lower the value to reduce event payload size.
DD_APPSEC_MAX_STACK_TRACE_DEPTH_TOP_PERCENT: Type: int
Default: 75
When the tracer must trim a stacktrace, this value controls how much of the top portion of the stacktrace is preserved at higher fidelity (a percentage). This lets implementations keep more of the top frames (most actionable) while trimming the less usefully deep frames
DD_APPSEC_MAX_STACK_TRACES: Type: int
Default: 2
Aliases:DD_APPSEC_MAX_STACKTRACES
Limits how many separate stacktraces are captured and attached to an AppSec/IAST event to keep payload sizes reasonable. Evidence stacktraces are useful for triage, but unbounded capture can leak sensitive data and consume excessive bandwidth; this limit balances evidence value and safety. Set to 0 to collect all.
DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP: Type: string
Default: (?i)pass|pw(?:or)?d|secret|(?:api|private|public|access)[_-]?key|token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)|bearer|authorization|jsessionid|phpsessid|asp\.net[_-]sessionid|sid|jwt
Regular expression used by the AppSec obfuscator to identify parameter keys whose entire value must be redacted. When a key path matches, the parameter is replaced with <redacted by datadog>. The default matches common credential names (password, token, authorization, jwt, etc.). Set to an empty string to disable key-based redaction.
DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP: Type: string
Default: (?i)(?:p(?:ass)?w(?:or)?d|pass(?:[_-]?phrase)?|secret(?:[_-]?key)?|(?:(?:api|private|public|access)[_-]?)key(?:[_-]?id)?|(?:(?:auth|access|id|refresh)[_-]?)?token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?|jsessionid|phpsessid|asp\.net(?:[_-]|-)sessionid|sid|jwt)(?:\s*=[^;]|"\s*:\s*"[^"]+")|bearer\s+[a-z0-9\._\-]+|token:[a-z0-9]{13}|gh[opsu]_[0-9a-zA-Z]{36}|ey[I-L][\w=-]+\.ey[I-L][\w=-]+(?:\.[\w.+\/=-]+)?|[\-]{5}BEGIN[a-z\s]+PRIVATE\sKEY[\-]{5}[^\-]+[\-]{5}END[a-z\s]+PRIVATE\sKEY|ssh-rsa\s*[a-z0-9\/\.+]{100,}
Regular expression used to find and redact sensitive substrings inside parameter values and highlights. Matches are replaced with <redacted by datadog>. This regexp complements the key regexp: the key regexp takes precedence; when no key match exists, the value regexp runs. The default pattern targeted at tokens, JWTs, private key blocks, and other credential shapes. Empty string disables the value regexp
DD_APPSEC_RASP_ENABLED: Type: boolean
Default: true
Turns on the tracer’s RASP / Exploit Prevention capabilities. When enabled the tracer runs synchronous, pre-execution checks and may generate block actions or exploit signals. RASP may have separate activation and implementation details per language; enabling it usually activates extra synchronous instrumentation and additional evidence capture for detections
DD_APPSEC_RULES: Type: string
Override the default rules file provided. Must be a path to a valid JSON rules file
DD_APPSEC_SCA_ENABLED: Type: boolean
Enables the tracer’s runtime Software Composition Analysis (Runtime SCA) capability, which reports runtime dependency/SBOM information and powers runtime vulnerability detection. Useful for testing and demonstrations as well as production runtime vulnerability workflows; SCA may have billing/usage implications and language compatibility constraints described in the SCA runbooks
DD_APPSEC_STACK_TRACE_ENABLED: Type: boolean
Default: true
Aliases:DD_APPSEC_STACKTRACE_ENABLED
Enables security-related stack traces generation when security events occur.
DD_APPSEC_TRACE_RATE_LIMIT: Type: int
Default: 100
Controls the maximum amount of AppSec traces, per second.
DD_APPSEC_WAF_TIMEOUT: Type: string
Default: 5000
Limits the WAF synchronous execution time (in microseconds)
DD_ERROR_TRACKING_HANDLED_ERRORS: Type: string
Controls whether Error Tracking reports handled errors from user code, third-party gems, or both.
DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE: Type: array
Comma-separated list of paths, file names, or gem names whose handled errors should be reported by Error Tracking.

Dynamic Instrumentation & Debugging

(7)

Remote debugging capabilities: Dynamic Instrumentation for live probes, Exception Replay for automatic variable capture, Symbol Database for source-level debugging, and Code Origin for Spans for linking spans back to source code.

DD_DYNAMIC_INSTRUMENTATION_ENABLED: Type: boolean
Default: false
Enables Dynamic Instrumentation, allowing log probes and metric probes to be added to running services from the Datadog UI without redeploying.
DD_DYNAMIC_INSTRUMENTATION_MAX_TIME_TO_SERIALIZE: Type: int
Default: 200
Since: v2.38.0
Maximum duration (in milliseconds) to run serialization for probe snapshots.
DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE: Type: string
Default: false
Path to a local probe definition JSON file. When set, the tracer loads probe definitions from this file at startup instead of subscribing to remote configuration.
DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS: Type: array
Comma-separated list of additional identifier keywords to redact in captured snapshot data
DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES: Type: array
Comma-separated list of object types to redact from dynamic logs and snapshots. Supports * wildcards (e.g. Secret* matches SecretKey).
DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS: Type: array
Default: []
Since: v2.28.0
Comma-separated list of identifier keywords to exclude from the default redaction list. Useful to prevent common keywords like password from being treated as sensitive for your use case.
DD_SYMBOL_DATABASE_UPLOAD_ENABLED: Type: boolean
Default: true
Since: v2.32.0
Symbol Database (SymDB): enables uploading symbol information (for Live Debugging / Dynamic Instrumentation). Default: true.

CI Visibility

(2)

CI Visibility and Test Optimization: test reporting, code coverage collection, git metadata, flaky test management, test skipping, and CI provider integration.

DD_GIT_COMMIT_SHA: Type: string
Overrides the git commit SHA reported as CI metadata and used for git metadata tagging when enabled.
DD_GIT_REPOSITORY_URL: Type: string
Overrides the git repository URL reported as CI metadata and used for git metadata tagging when enabled. Any embedded credentials in the URL are stripped before use.

Crash Tracking & Diagnostics

(1)

Crash tracking for capturing and reporting application crashes, and heap snapshot configuration.

DD_CRASHTRACKING_ENABLED: Type: boolean
Default: true
Enables Crash Tracking. When enabled, the tracer initializes crash tracking and configures JVM crash/OOM hooks (for example, -XX:OnError and -XX:OnOutOfMemoryError) to run Datadog-provided scripts that upload hs_err_pid*.log crash logs and OOME notifications. Default: true.

Log Submission & Correlation

(2)

Direct log submission to Datadog, agentless log forwarding, log injection for trace-log correlation, and OpenTelemetry log export.

DD_LOGS_INJECTION

Type: boolean
Default: true

Enables or disables automatic injection of correlation identifiers (trace ID, span ID) into application logs.

Language-specific notes:

.NET: Your logger needs a source that sets the trace_id mapping correctly. The default source for .NET applications, csharp, does this automatically.

DD_LOGS_OTEL_ENABLED

Type: boolean
Default: false
Since: v2.34.0
Enables collection and export of logs produced via the OpenTelemetry Logs API.

Runtime Metrics

(5)

Runtime metrics collection and DogStatsD connection configuration for metric submission.

DD_HEALTH_METRICS_ENABLED: Type: boolean
Default: false
Enables health metrics collection.
DD_METRIC_AGENT_PORT: Type: int
Default: 8125
Port of the Datadog Agent StatsD endpoint that this library sends metrics to.
DD_RUNTIME_METRICS_ENABLED: Type: boolean
Default: false
Enables or disables the collection of runtime metrics (such as garbage collection stats, memory usage, and thread counts) for the application.
DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED: Type: boolean
Default: false
Aliases:DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED
When enabled, adds a runtime-id tag to runtime metrics to distinguish individual processes.
DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED: Type: boolean
Default: false
Enables adding a runtime-id tag to runtime metrics (experimental). Alias for DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED.

Data Streams Monitoring

(1)

Data Streams Monitoring for tracking end-to-end latency across message queues and streaming pipelines.

DD_DATA_STREAMS_ENABLED: Type: boolean
Default: false
Since: v2.23.0
Enables Data Streams Monitoring (DSM) and its checkpoint propagation. When enabled, the tracer registers the DSM propagator and reports pathway statistics and payloads.

Instrumentation Telemetry

(6)

Tracer self-reporting telemetry: heartbeat intervals, dependency and log collection, and telemetry forwarder configuration.

DD_INSTRUMENTATION_TELEMETRY_ENABLED: Type: boolean
Default: true
Allows Datadog to collect environmental and diagnostic information about your application and runtime to improve the product. Set to false to opt out of instrumentation telemetry.
DD_TELEMETRY_AGENTLESS_URL: Type: string
Overrides the agentless telemetry intake URL.
DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED: Type: boolean
Default: true
Enables the instrumentation telemetry dependency collector, which detects application dependencies at runtime and reports them to Datadog.
DD_TELEMETRY_LOG_COLLECTION_ENABLED: Type: boolean
Default: true
Controls whether internal tracer logs are forwarded as part of instrumentation telemetry.
DD_TELEMETRY_METRICS_AGGREGATION_INTERVAL: Type: decimal
Default: 10.0
Interval at which instrumentation telemetry metrics are aggregated before being sent.
DD_TELEMETRY_METRICS_ENABLED: Type: boolean
Default: true
Controls whether instrumentation telemetry sends internal metrics.

Remote Configuration

(2)

Remote Configuration for receiving live configuration updates from Datadog.

DD_REMOTE_CONFIG_BOOT_TIMEOUT_SECONDS: Type: decimal
Default: 1.0
Startup timeout for Remote Configuration; if exceeded, the application proceeds using local configuration.
DD_REMOTE_CONFIGURATION_ENABLED: Type: boolean
Default: true
Aliases:DD_REMOTE_CONFIG_ENABLED
Enable or disable remote configuration.

OpenTelemetry Compatibility

(29)

Standard OpenTelemetry environment variables supported by Datadog SDKs: resource attributes, propagators, trace sampler, OTLP exporter configuration, and batch span processor settings.

DD_METRICS_OTEL_ENABLED: Type: boolean
Default: false
Since: v2.23.0
Enables OpenTelemetry metrics export. Metrics are disabled by default and are only enabled when this is set to a truthy value.
OTEL_BLRP_EXPORT_TIMEOUT: Type: int
Default: 30000
Since: v2.34.0
Maximum time, in milliseconds, allowed for a single OTLP log export request before it is cancelled.
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE: Type: int
Default: 512
Since: v2.34.0
Maximum number of records in a single OTLP Payload. Must be less than or equal to max queue size.
OTEL_BLRP_MAX_QUEUE_SIZE: Type: int
Default: 2048
Since: v2.34.0
Maximum number of log records held in memory. New records are dropped when this limit is reached.
OTEL_BLRP_SCHEDULE_DELAY: Type: int
Default: 1000
Since: v2.34.0
Interval, in milliseconds, between two consecutive OTLP log export operations.
OTEL_EXPORTER_OTLP_ENDPOINT: Type: string
Since: v2.23.0
Specifies the base URL for sending OTLP data for all signals unless overridden. Default (gRPC): http://localhost:4317 . Default (HTTP): http://localhost:4318 .
OTEL_EXPORTER_OTLP_HEADERS: Type: map
Since: v2.23.0
Configuration key to set custom headers for OTLP export (fallback for metrics-specific headers). Used when metrics-specific OTLP headers are not set. Format: api-key=key,other=value.
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: Type: string
Since: v2.34.0
Aliases:OTEL_EXPORTER_OTLP_ENDPOINT
URL for sending OTLP logs. Takes precedence over OTEL_EXPORTER_OTLP_ENDPOINT. Defaults to http://localhost:4317 for gRPC and http://localhost:4318/v1/logs for HTTP.
OTEL_EXPORTER_OTLP_LOGS_HEADERS: Type: map
Since: v2.34.0
Aliases:OTEL_EXPORTER_OTLP_HEADERS
A map of headers to apply to all outgoing otlp logs.
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL: Type: string
Default: http/protobuf
Since: v2.34.0
Aliases:OTEL_EXPORTER_OTLP_PROTOCOL
Specifies the OTLP transport protocol to be used for log data.
OTEL_EXPORTER_OTLP_LOGS_TIMEOUT: Type: int
Default: 10000
Since: v2.34.0
Aliases:OTEL_EXPORTER_OTLP_TIMEOUT
Specifies the timeout (in milliseconds) for a single outgoing OTLP logs request. Takes precedence over the general OTEL_EXPORTER_OTLP_TIMEOUT.
OTEL_EXPORTER_OTLP_METRICS_ENDPOINT: Type: string
Since: v2.23.0
Aliases:OTEL_EXPORTER_OTLP_ENDPOINT
If non-empty, used as the OTLP metrics endpoint. Otherwise falls back to OTEL_EXPORTER_OTLP_ENDPOINT, then to http://<DD_TRACE_AGENT_URL host>:4317/4318 based on protocol. For http/protobuf, /v1/metrics is appended if missing.
OTEL_EXPORTER_OTLP_METRICS_HEADERS: Type: map
Since: v2.23.0
Specifies a comma-separated list of key-value pairs to be used as headers on outgoing OTLP metrics requests (for example, api-key=key,other-config=value). Takes precedence over the general OTEL_EXPORTER_OTLP_HEADERS.
OTEL_EXPORTER_OTLP_METRICS_PROTOCOL: Type: string
Default: http/protobuf
Since: v2.24.0
Aliases:OTEL_EXPORTER_OTLP_PROTOCOL
Selects the protocol used for OpenTelemetry OTLP metrics export. Only http/protobuf is supported.
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE: Type: string
Default: delta
Since: v2.23.0
Controls metrics aggregation temporality. Accepted values: delta or cumulative (case-insensitive); empty/invalid values are treated as delta.
OTEL_EXPORTER_OTLP_METRICS_TIMEOUT: Type: int
Default: 10000
Since: v2.24.0
Aliases:OTEL_EXPORTER_OTLP_TIMEOUT
Timeout, in milliseconds, for a single outgoing OTLP metrics request. Takes precedence over OTEL_EXPORTER_OTLP_TIMEOUT.
OTEL_EXPORTER_OTLP_PROTOCOL: Type: string
Default: http/protobuf
Since: v2.23.0
Specifies the transport protocol to use for all signals unless overridden. Accepted values: grpc, http/protobuf, http/json.
OTEL_EXPORTER_OTLP_TIMEOUT: Type: int
Default: 10000
Since: v2.23.0
Default timeout, in milliseconds, for OTLP export requests. Used as a fallback when a signal-specific timeout is not set.
OTEL_LOG_LEVEL: Type: boolean
Default: false
Enables debug mode, producing verbose tracer logs (not recommended for production or sensitive environments) when set to debug. Alias for DD_TRACE_DEBUG.
OTEL_LOGS_EXPORTER: Type: string
Default: otlp
Since: v2.34.0
Datadog SDKs that support OTLP log export should default to otlp; all others should default to None/null.
OTEL_METRIC_EXPORT_INTERVAL: Type: int
Default: 10000
Since: v2.23.0
Interval, in milliseconds, between metric export attempts. The default of 10000 (10s) is Datadog’s recommended value and differs from the OpenTelemetry specification default of 60000 ms.
OTEL_METRIC_EXPORT_TIMEOUT: Type: int
Default: 7500
Since: v2.23.0
Maximum time, in milliseconds, allowed to collect and export a single batch of metrics. The default of 7500 (7.5s) is Datadog’s recommended value and differs from the OpenTelemetry specification default of 30000 ms.
OTEL_METRICS_EXPORTER: Type: string
Default: otlp
Since: v2.23.0
Specifies the OpenTelemetry metrics exporter. The only accepted values are otlp and none. Setting it to none disables both OTel metric emission and APM runtime metrics (equivalent to DD_RUNTIME_METRICS_ENABLED=false).
OTEL_PROPAGATORS: Type: array
Configures which propagators are used for extracting and injecting trace context.
OTEL_RESOURCE_ATTRIBUTES: Type: map
Set OpenTelemetry resource attributes as a list of (key, value) pairs.
OTEL_SERVICE_NAME: Type: string
Default: ruby
Your application’s default service name, set as the service tag on traces. Alias for DD_SERVICE.
OTEL_TRACES_EXPORTER: Type: boolean
Default: true
Enables or disables tracing. When disabled, instrumentation still runs but no trace data is sent. Alias for DD_TRACE_ENABLED.
OTEL_TRACES_SAMPLER: Type: decimal
Sets the trace sampling rate, controlling the fraction of traces kept. Alias for DD_TRACE_SAMPLE_RATE.
OTEL_TRACES_SAMPLER_ARG: Type: decimal
Default: 1.0
Sets the argument for OTEL_TRACES_SAMPLER when using the traceidratio sampler (for example, OTEL_TRACES_SAMPLER_ARG=0.25). This is used to derive the tracer sample rate when mapping OpenTelemetry configuration.

AI & LLM Observability

(5)

AI observability features: AI Guard content scanning, LLM Observability, and per-provider integration settings.

DD_AI_GUARD_ENABLED: Type: boolean
Default: false
Since: v2.25.0
Enables AI Guard request inspection in the tracer; when disabled, AI Guard checks are skipped.
DD_AI_GUARD_ENDPOINT: Type: string
Since: v2.25.0
AI Guard: sets the base endpoint URL for the AI Guard REST API. If unset, defaults to https://app.<DD_SITE>/api/v2/ai-guard (the tracer appends /evaluate).
DD_AI_GUARD_MAX_CONTENT_SIZE: Type: int
Default: 524288
Since: v2.25.0
Max size of the content property set in the meta-struct
DD_AI_GUARD_MAX_MESSAGES_LENGTH: Type: int
Default: 16
Since: v2.25.0
Maximum number of conversational messages allowed to be set in the meta-struct
DD_AI_GUARD_TIMEOUT: Type: int
Default: 10000
Since: v2.25.0
Timeout used in calls to the AI Guard REST API in milliseconds (default 5000)

Instrumentation & Platform

(1)

Instrumentation setup and platform-specific configuration: auto-injection, third-party library detection, and platform adapters.

DD_INJECT_FORCE: Type: boolean
Default: false
Single Step Instrumentation (SSI): forces the tracer javaagent to load even when multiple JVM agents are detected. This bypasses SSI guardrails that would otherwise abort startup to avoid running multiple agents. Can be set via DD_INJECT_FORCE or system property dd.inject.force. Default: false.

Miscellaneous

(1)

Configuration keys that don't fit into the other categories yet. Treat this list as a backlog: each key here should eventually find a real home.

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED: Type: boolean
Default: false
Since: v2.23.0
Enables the experimental feature-flag provider that evaluates flags from remote configuration. If not enabled, the provider is a no-op and returns default values.