--- title: Configuring the Ruby SDK description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: >- Docs > APM > Application Instrumentation > Configure the Datadog SDK > Configuring the Ruby 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](https://docs.datadoghq.com/getting_started/tagging/unified_service_tagging.md). 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](https://docs.datadoghq.com/tracing/trace_collection/dd_libraries/ruby.md#additional-configuration). ## Configurations keys{% #configurations-keys %} **368** configuration keys available for this library. {% collapsible-section open=null %} ### General Settings{% #registry-general %} (11) {% icon name="icon-link-wui" /%} Top-level Datadog configuration: API keys, service identity, Agent connection, intake site, hostname, global tags, and proxy settings. `DD_AGENT_HOST` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` The application's environment. Sets the "env" tag on every span.`DD_EXTERNAL_ENV` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v2.24.0` Sets an external environment identifier attached to emitted telemetry for origin and environment attribution.`DD_HOSTNAME` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `ruby` **Aliases**:`OTEL_SERVICE_NAME` Your application's default service name, set as the service tag on traces.`DD_SITE` {% icon name="icon-link-wui" /%} **Type**: `string` Datadog site used to select the Datadog intake domain for agentless requests, such as telemetry and AI Guard API calls.`DD_TAGS` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Your application version, set as the version tag on traces. {% /collapsible-section %} {% collapsible-section %} ### Tracing Core{% #registry-trace_core %} (13) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `30` Timeout (in seconds) for connecting to the Datadog Agent when sending trace data.`DD_TRACE_AGENT_URL` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables the legacy tracing analytics feature (deprecated).`DD_TRACE_CLIENT_IP_HEADER` {% icon name="icon-link-wui" /%} **Type**: `string` Name of an optional custom HTTP header used to resolve the client IP address.`DD_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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_MAPPING` {% icon name="icon-link-wui" /%} **Type**: `map` Maps detected peer service names to normalized values before they are attached to spans.`DD_TRACE_REPORT_HOSTNAME` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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_X_DATADOG_TAGS_MAX_LENGTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `512` Maximum length of the `x-datadog-tags` header for trace tag propagation. Set to 0 to disable. {% /collapsible-section %} {% collapsible-section %} ### Trace Sampling{% #registry-trace_sampling %} (5) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Trace Propagation{% #registry-trace_propagation %} (12) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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.
` for incoming requests and `http.response.headers.
` for outgoing responses) or `
:` to control the tag key.`DD_TRACE_HTTP_CLIENT_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `net/http` integration`DD_TRACE_HTTP_ERROR_STATUS_CODES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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_PROPAGATION_BEHAVIOR_EXTRACT` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When set to true, stops extracting after the first successful trace context extraction.`DD_TRACE_PROPAGATION_STYLE` {% icon name="icon-link-wui" /%} **Type**: `array` **Aliases**:`OTEL_PROPAGATORS` Distributed tracing propagation formats to use for both extraction and injection.`DD_TRACE_PROPAGATION_STYLE_EXTRACT` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Trace Integrations{% #registry-trace_integrations %} (209) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **Type**: `string` **Aliases**:`DISABLE_DATADOG_RAILS` Disables the Datadog Rails integration auto-instrumentation.`DD_REDIS_COMMAND_ARGS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When enabled, includes Redis command arguments in span resource names and tags; otherwise only the command name is shown. #### Configuration Kinds Each integration can support one or more of these configuration patterns. Replace `` with the integration name (for example, `GRPC`, `AWS`, `REDIS`). {% collapsible-section #dd-trace-integration-enabled %} #### `DD_TRACE__ENABLED` (59 integrations) {% icon name="icon-link-wui" /%} 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`, `CLIENT_IP`, `CONCURRENT_RUBY`, `DALLI`, `DELAYED_JOB`, `ELASTICSEARCH`, `ETHON`, `EXCON`, `FARADAY`, `GRAPE`, `GRAPHQL`, `GRPC`, `HANAMI`, `HTTP`, `HTTPCLIENT`, `HTTPRB`, `INFERRED_PROXY_SERVICES`, `KAFKA`, `KARAFKA`, `LOGRAGE`, `MEMCACHED_COMMAND`, `MONGO`, `MYSQL2`, `OPENSEARCH`, `PEER_SERVICE_DEFAULTS`, `PG`, `PRESTO`, `QUE`, `QUE_TAG_ARGS`, `QUE_TAG_DATA`, `RACECAR`, `RACK`, `RAILS`, `RAKE`, `REDIS`, `REMOVE_INTEGRATION_SERVICE_NAMES`, `RESOURCE_RENAMING`, `RESQUE`, `REST_CLIENT`, `RODA`, `SEMANTIC_LOGGER`, `SEQUEL`, `SHORYUKEN`, `SIDEKIQ`, `SINATRA`, `SNEAKERS`, `STRIPE`, `SUCKER_PUNCH`, `TEST_MODE`, `TRILOGY`, `WATERDROP` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-analytics-enabled %} #### `DD_TRACE__ANALYTICS_ENABLED` (43 integrations) {% icon name="icon-link-wui" /%} 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` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-analytics-sample-rate %} #### `DD_TRACE__ANALYTICS_SAMPLE_RATE` (43 integrations) {% icon name="icon-link-wui" /%} 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` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-peer-service %} #### `DD_TRACE__PEER_SERVICE` (17 integrations) {% icon name="icon-link-wui" /%} 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` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-service-name %} #### `DD_TRACE__SERVICE_NAME` (17 integrations) {% icon name="icon-link-wui" /%} 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` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-distributed-tracing %} #### `DD_TRACE__DISTRIBUTED_TRACING` (14 integrations) {% icon name="icon-link-wui" /%} 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` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-error-status-codes %} #### `DD_TRACE__ERROR_STATUS_CODES` (5 integrations) {% icon name="icon-link-wui" /%} Define which HTTP status codes are treated as errors for this integration. Available integrations:`EXCON`, `FARADAY`, `GRAPE`, `HTTPCLIENT`, `HTTPRB` {% /collapsible-section %} #### Per-Integration Settings (60 integrations) Each section lists all configuration keys available for a specific integration. {% collapsible-section #integration-action-cable %} #### ACTION_CABLE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTION_CABLE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Action Cable integration.`DD_TRACE_ACTION_CABLE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Action Cable integration.`DD_TRACE_ACTION_CABLE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Action Cable integration. {% /collapsible-section %} {% collapsible-section #integration-action-mailer %} #### ACTION_MAILER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTION_MAILER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Action Mailer integration.`DD_TRACE_ACTION_MAILER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Action Mailer integration.`DD_TRACE_ACTION_MAILER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Action Mailer integration. {% /collapsible-section %} {% collapsible-section #integration-action-pack %} #### ACTION_PACK (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTION_PACK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the Action Pack integration.`DD_TRACE_ACTION_PACK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Action Pack integration.`DD_TRACE_ACTION_PACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Action Pack integration. {% /collapsible-section %} {% collapsible-section #integration-action-view %} #### ACTION_VIEW (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTION_VIEW_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Action View integration.`DD_TRACE_ACTION_VIEW_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Action View integration.`DD_TRACE_ACTION_VIEW_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Action View integration. {% /collapsible-section %} {% collapsible-section #integration-active-job %} #### ACTIVE_JOB (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTIVE_JOB_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Active Job integration.`DD_TRACE_ACTIVE_JOB_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Active Job integration.`DD_TRACE_ACTIVE_JOB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Active Job integration. {% /collapsible-section %} {% collapsible-section #integration-active-model-serializers %} #### ACTIVE_MODEL_SERIALIZERS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Active Model Serializers integration.`DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Active Model Serializers integration.`DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Active Model Serializers integration. {% /collapsible-section %} {% collapsible-section #integration-active-record %} #### ACTIVE_RECORD (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTIVE_RECORD_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Active Record integration.`DD_TRACE_ACTIVE_RECORD_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Active Record integration.`DD_TRACE_ACTIVE_RECORD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Active Record integration. {% /collapsible-section %} {% collapsible-section #integration-active-support %} #### ACTIVE_SUPPORT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Active Support integration.`DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Active Support integration.`DD_TRACE_ACTIVE_SUPPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Active Support integration. {% /collapsible-section %} {% collapsible-section #integration-aws %} #### AWS (5) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the AWS integration.`DD_TRACE_AWS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the AWS integration.`DD_TRACE_AWS_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the AWS integration.`DD_TRACE_AWS_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-client-ip %} #### CLIENT_IP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CLIENT_IP_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section #integration-concurrent-ruby %} #### CONCURRENT_RUBY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CONCURRENT_RUBY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether the Concurrent Ruby integration propagates tracing context. {% /collapsible-section %} {% collapsible-section #integration-dalli %} #### DALLI (5) {% icon name="icon-link-wui" /%} `DD_TRACE_DALLI_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Dalli integration.`DD_TRACE_DALLI_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Dalli integration.`DD_TRACE_DALLI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Dalli integration.`DD_TRACE_DALLI_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Dalli integration.`DD_TRACE_DALLI_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-delayed-job %} #### DELAYED_JOB (3) {% icon name="icon-link-wui" /%} `DD_TRACE_DELAYED_JOB_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Delayed Job integration.`DD_TRACE_DELAYED_JOB_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Delayed Job integration.`DD_TRACE_DELAYED_JOB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Delayed Job integration. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch %} #### ELASTICSEARCH (5) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Elasticsearch integration.`DD_TRACE_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for elasticsearch. When disabled, spans for elasticsearch operations are not created.`DD_TRACE_ELASTICSEARCH_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Elasticsearch integration.`DD_TRACE_ELASTICSEARCH_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-ethon %} #### ETHON (6) {% icon name="icon-link-wui" /%} `DD_TRACE_ETHON_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Ethon integration.`DD_TRACE_ETHON_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Ethon integration.`DD_TRACE_ETHON_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `ethon` integration`DD_TRACE_ETHON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Ethon integration.`DD_TRACE_ETHON_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Ethon integration.`DD_TRACE_ETHON_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-excon %} #### EXCON (7) {% icon name="icon-link-wui" /%} `DD_TRACE_EXCON_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Excon integration.`DD_TRACE_EXCON_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Excon integration.`DD_TRACE_EXCON_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `excon` integration`DD_TRACE_EXCON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Excon integration.`DD_TRACE_EXCON_ERROR_STATUS_CODES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Excon integration.`DD_TRACE_EXCON_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-faraday %} #### FARADAY (7) {% icon name="icon-link-wui" /%} `DD_TRACE_FARADAY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Faraday integration.`DD_TRACE_FARADAY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Faraday integration.`DD_TRACE_FARADAY_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `faraday` integration`DD_TRACE_FARADAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Faraday integration.`DD_TRACE_FARADAY_ERROR_STATUS_CODES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Faraday integration.`DD_TRACE_FARADAY_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-grape %} #### GRAPE (4) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the Grape integration.`DD_TRACE_GRAPE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Grape integration.`DD_TRACE_GRAPE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Grape integration.`DD_TRACE_GRAPE_ERROR_STATUS_CODES` {% icon name="icon-link-wui" /%} **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'`) {% /collapsible-section %} {% collapsible-section #integration-graphql %} #### GRAPHQL (6) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the GraphQL integration.`DD_TRACE_GRAPHQL_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the GraphQL integration.`DD_TRACE_GRAPHQL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for graphql. When disabled, spans for graphql operations are not created.`DD_TRACE_GRAPHQL_ERROR_EXTENSIONS` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Surfaces GraphQL errors in Error Tracking.`DD_TRACE_GRAPHQL_WITH_UNIFIED_TRACER` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables GraphQL instrumentation using the UnifiedTrace tracer (recommended for graphql >= 2.2) to support the Endpoints list. {% /collapsible-section %} {% collapsible-section #integration-grpc %} #### GRPC (6) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `grpc` integration`DD_TRACE_GRPC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for grpc. When disabled, spans for grpc operations are not created.`DD_TRACE_GRPC_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the gRPC integration.`DD_TRACE_GRPC_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-hanami %} #### HANAMI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HANAMI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Hanami integration. {% /collapsible-section %} {% collapsible-section #integration-http %} #### HTTP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the net/http integration.`DD_TRACE_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for http. When disabled, spans for http operations are not created. {% /collapsible-section %} {% collapsible-section #integration-httpclient %} #### HTTPCLIENT (7) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPCLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HTTPCLIENT_ANALYTICS_ENABLED` Enables analytics for the httpclient integration.`DD_TRACE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `httpclient` integration`DD_TRACE_HTTPCLIENT_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the httpclient integration.`DD_TRACE_HTTPCLIENT_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-httprb %} #### HTTPRB (7) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPRB_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the httprb integration.`DD_TRACE_HTTPRB_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the httprb integration.`DD_TRACE_HTTPRB_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `httprb` integration`DD_TRACE_HTTPRB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the httprb integration.`DD_TRACE_HTTPRB_ERROR_STATUS_CODES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the httprb integration.`DD_TRACE_HTTPRB_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-inferred-proxy-services %} #### INFERRED_PROXY_SERVICES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section #integration-kafka %} #### KAFKA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_KAFKA_ENABLED`, `DD_TRACE_INTEGRATION_KAFKA_ENABLED` Enables tracing for the Kafka integration. {% /collapsible-section %} {% collapsible-section #integration-karafka %} #### KARAFKA (2) {% icon name="icon-link-wui" /%} `DD_TRACE_KARAFKA_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `karafka` integration`DD_TRACE_KARAFKA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Karafka integration. {% /collapsible-section %} {% collapsible-section #integration-lograge %} #### LOGRAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOGRAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables injecting trace correlation fields into Lograge logs when log injection is enabled. {% /collapsible-section %} {% collapsible-section #integration-memcached-command %} #### MEMCACHED_COMMAND (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MEMCACHED_COMMAND_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enable memcached command tagging if DD_TRACE_MEMCACHED_COMMAND_ENABLED is enabled {% /collapsible-section %} {% collapsible-section #integration-mongo %} #### MONGO (6) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the MongoDB integration.`DD_TRACE_MONGO_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-mysql2 %} #### MYSQL2 (5) {% icon name="icon-link-wui" /%} `DD_TRACE_MYSQL2_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the mysql2 integration.`DD_TRACE_MYSQL2_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the mysql2 integration.`DD_TRACE_MYSQL2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for mysql2. When disabled, spans for mysql2 operations are not created.`DD_TRACE_MYSQL2_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the mysql2 integration.`DD_TRACE_MYSQL2_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-net %} #### NET (2) {% icon name="icon-link-wui" /%} `DD_TRACE_NET_HTTP_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the net/http integration.`DD_TRACE_NET_HTTP_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-opensearch %} #### OPENSEARCH (6) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OPENSEARCH_ANALYTICS_ENABLED` Enables analytics for the OpenSearch integration.`DD_TRACE_OPENSEARCH_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for opensearch. When disabled, spans for opensearch operations are not created.`DD_TRACE_OPENSEARCH_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the OpenSearch integration.`DD_TRACE_OPENSEARCH_RESOURCE_PATTERN` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `absolute` Controls whether OpenSearch span resource names use the full or relative URL path.`DD_TRACE_OPENSEARCH_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-peer-service-defaults %} #### PEER_SERVICE_DEFAULTS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section #integration-pg %} #### PG (5) {% icon name="icon-link-wui" /%} `DD_TRACE_PG_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the pg (Postgres) integration.`DD_TRACE_PG_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the pg (Postgres) integration.`DD_TRACE_PG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables instrumentation for pg. When disabled, spans for pg operations are not created.`DD_TRACE_PG_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the pg (Postgres) integration.`DD_TRACE_PG_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-presto %} #### PRESTO (5) {% icon name="icon-link-wui" /%} `DD_TRACE_PRESTO_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Presto integration.`DD_TRACE_PRESTO_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Presto integration.`DD_TRACE_PRESTO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Presto integration.`DD_TRACE_PRESTO_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Presto integration.`DD_TRACE_PRESTO_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-que %} #### QUE (4) {% icon name="icon-link-wui" /%} `DD_TRACE_QUE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Que integration.`DD_TRACE_QUE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Que integration.`DD_TRACE_QUE_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `que` integration`DD_TRACE_QUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Que integration. {% /collapsible-section %} {% collapsible-section #integration-que-tag-args %} #### QUE_TAG_ARGS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_QUE_TAG_ARGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables tagging a Que job's args field on spans. {% /collapsible-section %} {% collapsible-section #integration-que-tag-data %} #### QUE_TAG_DATA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_QUE_TAG_DATA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables tagging a Que job's data field on spans. {% /collapsible-section %} {% collapsible-section #integration-racecar %} #### RACECAR (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RACECAR_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Racecar integration.`DD_TRACE_RACECAR_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Racecar integration.`DD_TRACE_RACECAR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Racecar integration. {% /collapsible-section %} {% collapsible-section #integration-rack %} #### RACK (4) {% icon name="icon-link-wui" /%} `DD_TRACE_RACK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the Rack integration.`DD_TRACE_RACK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Rack integration.`DD_TRACE_RACK_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `rack` integration`DD_TRACE_RACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Rack integration. {% /collapsible-section %} {% collapsible-section #integration-rails %} #### RAILS (4) {% icon name="icon-link-wui" /%} `DD_TRACE_RAILS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the Rails integration.`DD_TRACE_RAILS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Rails integration.`DD_TRACE_RAILS_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `rails` integration`DD_TRACE_RAILS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Rails integration. {% /collapsible-section %} {% collapsible-section #integration-rake %} #### RAKE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RAKE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Rake integration.`DD_TRACE_RAKE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Rake integration.`DD_TRACE_RAKE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Rake integration. {% /collapsible-section %} {% collapsible-section #integration-redis %} #### REDIS (5) {% icon name="icon-link-wui" /%} `DD_TRACE_REDIS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Redis integration.`DD_TRACE_REDIS_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-remove-integration-service-names %} #### REMOVE_INTEGRATION_SERVICE_NAMES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section #integration-resource-renaming %} #### RESOURCE_RENAMING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESOURCE_RENAMING_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section #integration-resque %} #### RESQUE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RESQUE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Resque integration.`DD_TRACE_RESQUE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Resque integration.`DD_TRACE_RESQUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Resque integration. {% /collapsible-section %} {% collapsible-section #integration-rest-client %} #### REST_CLIENT (6) {% icon name="icon-link-wui" /%} `DD_TRACE_REST_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the RestClient integration.`DD_TRACE_REST_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the RestClient integration.`DD_TRACE_REST_CLIENT_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `rest-client` integration`DD_TRACE_REST_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the RestClient integration.`DD_TRACE_REST_CLIENT_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the RestClient integration.`DD_TRACE_REST_CLIENT_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-roda %} #### RODA (3) {% icon name="icon-link-wui" /%} `DD_RODA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Roda integration.`DD_RODA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Roda integration.`DD_TRACE_RODA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Roda integration. {% /collapsible-section %} {% collapsible-section #integration-semantic-logger %} #### SEMANTIC_LOGGER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SEMANTIC_LOGGER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables injecting trace correlation fields into Semantic Logger logs when log injection is enabled. {% /collapsible-section %} {% collapsible-section #integration-sequel %} #### SEQUEL (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SEQUEL_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Sequel integration.`DD_TRACE_SEQUEL_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Sequel integration.`DD_TRACE_SEQUEL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Sequel integration. {% /collapsible-section %} {% collapsible-section #integration-shoryuken %} #### SHORYUKEN (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SHORYUKEN_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Shoryuken integration.`DD_TRACE_SHORYUKEN_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Shoryuken integration.`DD_TRACE_SHORYUKEN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Shoryuken integration. {% /collapsible-section %} {% collapsible-section #integration-sidekiq %} #### SIDEKIQ (4) {% icon name="icon-link-wui" /%} `DD_TRACE_SIDEKIQ_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Sidekiq integration.`DD_TRACE_SIDEKIQ_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Sidekiq integration.`DD_TRACE_SIDEKIQ_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `sidekiq` integration`DD_TRACE_SIDEKIQ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Sidekiq integration. {% /collapsible-section %} {% collapsible-section #integration-sinatra %} #### SINATRA (4) {% icon name="icon-link-wui" /%} `DD_TRACE_SINATRA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` Enables analytics for the Sinatra integration.`DD_TRACE_SINATRA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Sinatra integration.`DD_TRACE_SINATRA_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `sinatra` integration`DD_TRACE_SINATRA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Sinatra integration. {% /collapsible-section %} {% collapsible-section #integration-sneakers %} #### SNEAKERS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SNEAKERS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Sneakers integration.`DD_TRACE_SNEAKERS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Sneakers integration.`DD_TRACE_SNEAKERS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Sneakers integration. {% /collapsible-section %} {% collapsible-section #integration-stripe %} #### STRIPE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_STRIPE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Stripe integration.`DD_TRACE_STRIPE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Stripe integration.`DD_TRACE_STRIPE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Stripe integration. {% /collapsible-section %} {% collapsible-section #integration-sucker-punch %} #### SUCKER_PUNCH (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SUCKER_PUNCH_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Sucker Punch integration.`DD_TRACE_SUCKER_PUNCH_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Sucker Punch integration.`DD_TRACE_SUCKER_PUNCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Sucker Punch integration. {% /collapsible-section %} {% collapsible-section #integration-test-mode %} #### TEST_MODE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TEST_MODE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables tracer test mode, using test-oriented trace flushing and writer behavior. {% /collapsible-section %} {% collapsible-section #integration-trilogy %} #### TRILOGY (5) {% icon name="icon-link-wui" /%} `DD_TRACE_TRILOGY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables analytics for the Trilogy integration.`DD_TRACE_TRILOGY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Sampling rate for analytics events generated by the Trilogy integration.`DD_TRACE_TRILOGY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables tracing for the Trilogy integration.`DD_TRACE_TRILOGY_PEER_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` Name of the external service for spans generated by the Trilogy integration.`DD_TRACE_TRILOGY_SERVICE_NAME` {% icon name="icon-link-wui" /%} **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`. {% /collapsible-section %} {% collapsible-section #integration-waterdrop %} #### WATERDROP (2) {% icon name="icon-link-wui" /%} `DD_TRACE_WATERDROP_DISTRIBUTED_TRACING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v2.30.0` If enabled, activates distributed tracing for the `waterdrop` integration`DD_TRACE_WATERDROP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.23.0` Enables tracing for the WaterDrop integration. {% /collapsible-section %} {% /collapsible-section %} {% collapsible-section %} ### Database Monitoring{% #registry-dbm %} (2) {% icon name="icon-link-wui" /%} Database Monitoring (DBM): SQL comment propagation modes and query identifier hashing for correlating database performance with application traces. `DD_DBM_INJECT_SQL_BASEHASH` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Trace Logging{% #registry-trace_logging %} (2) {% icon name="icon-link-wui" /%} Tracer log output settings: log levels, log file paths, log rotation, and startup diagnostics. `DD_TRACE_DEBUG` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` Prints startup configuration and diagnostics to logs to help assess tracing at application startup. {% /collapsible-section %} {% collapsible-section %} ### Continuous Profiling{% #registry-profiling %} (22) {% icon name="icon-link-wui" /%} Continuous Profiler configuration: enable/disable, upload settings, profiling types, engine options, code hotspots, endpoint profiling, and experimental features. `DD_PROFILING_ALLOCATION_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables a workaround for Ruby Dir interruption issues caused by profiling signals.`DD_PROFILING_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables preview heap profiling, collecting heap profiles (requires allocation profiling).`DD_PROFILING_EXPERIMENTAL_HEAP_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1` Sampling rate for heap profiling.`DD_PROFILING_EXPERIMENTAL_HEAP_SIZE_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.30.0` Use system resolver for dns instead of built-in libdatadog one`DD_PROFILING_GC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables garbage collection profiling, collecting GC activity in profiles.`DD_PROFILING_GVL_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `400` Maximum number of stack frames captured per thread sample in profiles.`DD_PROFILING_NATIVE_FILENAMES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether the profiler uses native filenames for stack frames from native code.`DD_PROFILING_NO_SIGNALS_WORKAROUND_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `false` Controls whether the profiler attempts to read context from OpenTelemetry.`DD_PROFILING_SHUTDOWN_ON_EXEC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Stops profiling before an exec call to avoid profiling state leaking into the new process.`DD_PROFILING_SIGHANDLER_SAMPLING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether the profiler samples directly from the signal handler for improved accuracy.`DD_PROFILING_SKIP_MYSQL2_CHECK` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Disables the profiler compatibility check of the libmysqlclient version used by mysql2.`DD_PROFILING_TIMELINE_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `60` Profiling: upload period in seconds (recording duration); controls how frequently profiles are uploaded`DD_PROFILING_UPLOAD_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `30.0` Maximum time, in seconds, the profiler waits for an upload HTTP request to complete before cancelling it. {% /collapsible-section %} {% collapsible-section %} ### Application Security{% #registry-appsec %} (25) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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_REQUEST_BODY_ANALYSIS` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `identification` Selects the AppSec automatic user instrumentation mode, which controls how user events are collected.`DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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 ``. 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` {% icon name="icon-link-wui" /%} **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 ``. 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Override the default rules file provided. Must be a path to a valid JSON rules file`DD_APPSEC_SCA_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_APPSEC_STACKTRACE_ENABLED` Enables security-related stack traces generation when security events occur.`DD_APPSEC_TRACE_RATE_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `100` Controls the maximum amount of AppSec traces, per second.`DD_APPSEC_WAF_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `5000` Limits the WAF synchronous execution time (in microseconds)`DD_ERROR_TRACKING_HANDLED_ERRORS` {% icon name="icon-link-wui" /%} **Type**: `string` Controls whether Error Tracking reports handled errors from user code, third-party gems, or both.`DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE` {% icon name="icon-link-wui" /%} **Type**: `array` Comma-separated list of paths, file names, or gem names whose handled errors should be reported by Error Tracking. {% /collapsible-section %} {% collapsible-section %} ### Dynamic Instrumentation & Debugging{% #registry-debugging %} (6) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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_PROBE_FILE` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `array` Comma-separated list of additional identifier keywords to redact in captured snapshot data`DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v2.32.0` Symbol Database (SymDB): enables uploading symbol information (for Live Debugging / Dynamic Instrumentation). Default: true. {% /collapsible-section %} {% collapsible-section %} ### CI Visibility{% #registry-civisibility %} (2) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit SHA reported as CI metadata and used for git metadata tagging when enabled.`DD_GIT_REPOSITORY_URL` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Crash Tracking & Diagnostics{% #registry-crashtracking %} (1) {% icon name="icon-link-wui" /%} Crash tracking for capturing and reporting application crashes, and heap snapshot configuration. `DD_CRASHTRACKING_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Log Submission & Correlation{% #registry-logs %} (2) {% icon name="icon-link-wui" /%} Direct log submission to Datadog, agentless log forwarding, log injection for trace-log correlation, and OpenTelemetry log export. `DD_LOGS_INJECTION` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v2.34.0` Enables collection and export of logs produced via the OpenTelemetry Logs API. {% /collapsible-section %} {% collapsible-section %} ### Runtime Metrics{% #registry-runtime_metrics %} (5) {% icon name="icon-link-wui" /%} Runtime metrics collection and DogStatsD connection configuration for metric submission. `DD_HEALTH_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables health metrics collection.`DD_METRIC_AGENT_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8125` Port of the Datadog Agent StatsD endpoint that this library sends metrics to.`DD_RUNTIME_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables adding a runtime-id tag to runtime metrics (experimental). Alias for DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED. {% /collapsible-section %} {% collapsible-section %} ### Data Streams Monitoring{% #registry-data_streams %} (1) {% icon name="icon-link-wui" /%} Data Streams Monitoring for tracking end-to-end latency across message queues and streaming pipelines. `DD_DATA_STREAMS_ENABLED` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### Instrumentation Telemetry{% #registry-telemetry %} (7) {% icon name="icon-link-wui" /%} Tracer self-reporting telemetry: heartbeat intervals, dependency and log collection, and telemetry forwarder configuration. `DD_INSTRUMENTATION_TELEMETRY_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the agentless telemetry intake URL.`DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables the instrumentation telemetry dependency collector, which detects application dependencies at runtime and reports them to Datadog.`DD_TELEMETRY_HEARTBEAT_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `60.0` Interval, in seconds, between telemetry heartbeat messages emitted by the tracer.`DD_TELEMETRY_LOG_COLLECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether internal tracer logs are forwarded as part of instrumentation telemetry.`DD_TELEMETRY_METRICS_AGGREGATION_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `10.0` Interval at which instrumentation telemetry metrics are aggregated before being sent.`DD_TELEMETRY_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether instrumentation telemetry sends internal metrics. {% /collapsible-section %} {% collapsible-section %} ### Remote Configuration{% #registry-remote_config %} (3) {% icon name="icon-link-wui" /%} Remote Configuration for receiving live configuration updates from Datadog. `DD_REMOTE_CONFIG_BOOT_TIMEOUT_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Startup timeout for Remote Configuration; if exceeded, the application proceeds using local configuration.`DD_REMOTE_CONFIG_POLL_INTERVAL_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `5.0` Sets how often, in seconds, the Datadog Agent is queried for Remote Configuration updates.`DD_REMOTE_CONFIGURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_REMOTE_CONFIG_ENABLED` Enable or disable remote configuration. {% /collapsible-section %} {% collapsible-section %} ### OpenTelemetry Compatibility{% #registry-otel %} (29) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1000` **Since**: `v2.34.0` Interval, in milliseconds, between two consecutive OTLP log export operations.`OTEL_EXPORTER_OTLP_ENDPOINT` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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://:4317/4318` based on protocol. For `http/protobuf`, `/v1/metrics` is appended if missing.`OTEL_EXPORTER_OTLP_METRICS_HEADERS` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `array` Configures which propagators are used for extracting and injecting trace context.`OTEL_RESOURCE_ATTRIBUTES` {% icon name="icon-link-wui" /%} **Type**: `map` Set OpenTelemetry resource attributes as a list of `(key, value)` pairs.`OTEL_SERVICE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `ruby` Your application's default service name, set as the service tag on traces. Alias for DD_SERVICE.`OTEL_TRACES_EXPORTER` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `decimal` Sets the trace sampling rate, controlling the fraction of traces kept. Alias for DD_TRACE_SAMPLE_RATE.`OTEL_TRACES_SAMPLER_ARG` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} {% collapsible-section %} ### AI & LLM Observability{% #registry-ai_observability %} (5) {% icon name="icon-link-wui" /%} AI observability features: AI Guard content scanning, LLM Observability, and per-provider integration settings. `DD_AI_GUARD_ENABLED` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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./api/v2/ai-guard` (the tracer appends `/evaluate`).`DD_AI_GUARD_MAX_CONTENT_SIZE` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **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` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v2.25.0` Timeout used in calls to the AI Guard REST API in milliseconds (default 5000) {% /collapsible-section %} {% collapsible-section %} ### Instrumentation & Platform{% #registry-instrumentation %} (5) {% icon name="icon-link-wui" /%} Instrumentation setup and platform-specific configuration: auto-injection, third-party library detection, and platform adapters. `DD_INJECT_FORCE` {% icon name="icon-link-wui" /%} **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.`DD_INJECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `tracer` Indicates whether the library was loaded via Datadog single-step instrumentation (SSI) injection.`DD_INSTRUMENTATION_INSTALL_ID` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the install ID included in instrumentation telemetry payloads and headers. This can be used to correlate telemetry to a specific installation.`DD_INSTRUMENTATION_INSTALL_TIME` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the install time included in instrumentation telemetry payloads and headers.`DD_INSTRUMENTATION_INSTALL_TYPE` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the install type included in instrumentation telemetry payloads and headers. {% /collapsible-section %} {% collapsible-section %} ### Miscellaneous{% #registry-misc %} (1) {% icon name="icon-link-wui" /%} 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` {% icon name="icon-link-wui" /%} **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. {% /collapsible-section %} (function(){document.querySelectorAll(".registry-copy-link").forEach(function(e){e.addEventListener("click",function(t){t.preventDefault(),t.stopPropagation();const n=window.location.origin+window.location.pathname+e.getAttribute("href");navigator.clipboard.writeText(n).then(function(){e.matches("a")&&(e.classList.add("registry-copy-link--copied"),setTimeout(function(){e.classList.remove("registry-copy-link--copied")},1500))}),history.replaceState(null,"",e.getAttribute("href"))})});function e(){const n=window.location.hash;if(!n)return;const e=document.getElementById(n.substring(1));if(!e)return;let t=e;for(;t;)t.tagName==="DETAILS"&&(t.open=!0),t=t.parentElement;e.tagName==="DETAILS"&&(e.open=!0),setTimeout(function(){e.scrollIntoView({behavior:"smooth",block:"start"})},100)}e(),window.addEventListener("hashchange",e)})() ## Further Reading{% #further-reading %} - [Source code](https://github.com/DataDog/dd-trace-rb/) - [Propagating trace context](https://docs.datadoghq.com/tracing/trace_collection/trace_context_propagation.md) - [OpenTelemetry Environment Variable Configurations](https://docs.datadoghq.com/opentelemetry/interoperability/environment_variable_support.md)