--- title: Configuring the Java SDK description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: >- Docs > APM > Application Instrumentation > Configure the Datadog SDK > Configuring the Java SDK --- # Configuring the Java 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. All configuration options below have system property and environment variable equivalents. If the same key type is set for both, the system property configuration takes priority. System properties can be set as JVM flags. ### Converting between system properties and environment variables{% #converting-between-system-properties-and-environment-variables %} Unless otherwise stated, you can convert between system properties and environment variables with the following transformations: - To set a system property as an environment variable, uppercase the property name and replace `.` or `-` with `_`. For example, `dd.service` becomes `DD_SERVICE`. - To set an environment variable as a system property, lowercase the variable name and replace `_` with `.` For example, `DD_TAGS` becomes `dd.tags`. **Note**: When using the Java tracer's system properties, list the properties before `-jar`. This ensures the properties are read in as JVM options. ## Configurations keys{% #configurations-keys %} **1077** configuration keys available for this library. {% collapsible-section open=null %} ### General Settings{% #registry-general %} (10) {% 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` Overrides the default trace Agent host address for trace submission. Ignored if `DD_TRACE_AGENT_URL` is set.`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_ENV` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the global `env` tag applied to all telemetry emitted by the tracer (traces, metrics, logs, profiles). Use it to separate environments such as `prod`, `staging`, or `dev`.`DD_PROXY_NO_PROXY` {% icon name="icon-link-wui" /%} **Type**: `string` Configuration key to set a list of hosts that should bypass the proxy. The list is space-separated.`DD_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` **Aliases**:`DD_SERVICE_NAME`, `OTEL_SERVICE_NAME` Sets the service name used as the `service` tag on every span. If not specified, the SDK tries to determine the service name automatically. **Language-specific notes:** - **.NET**: falls back to the IIS application name, process entry assembly, or process name. - **Java**: falls back to the Java agent's auto-detected service name based on the application class. - **Node.js**: falls back to the `name` field in `package.json`. `DD_SERVICE_MAPPING` {% icon name="icon-link-wui" /%} **Type**: `map` Define service name mappings to allow renaming services in traces, for example: `postgres:postgresql,defaultdb:postgresql`. Available in version 0.47+.`DD_SITE` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `datadoghq.com` Sets the site domain used to build agentless intake URLs. If unset, a default site is used.`DD_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` Custom tags applied to traces, profiles, and metrics, provided as comma-separated `key:value` pairs (for example, `layer:api,team:intake`).`DD_VERSION` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the application's version, used as the `version` tag in traces and logs (for example: `1.2.3`, `6c44da20`, `2020.02.13`). **Language-specific notes:** - **PHP**: starting with version `0.90.0`, changes made at runtime through `ini_set('datadog.version', ...)` are also applied to the current root span. {% /collapsible-section %} {% collapsible-section %} ### Tracing Core{% #registry-trace_core %} (46) {% 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_HTTP_CLIENT_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `400-499` Client HTTP status codes that mark spans as errors.`DD_HTTP_SERVER_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `500-599` Server HTTP status codes that mark spans as errors.`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_ARGS` {% icon name="icon-link-wui" /%} **Type**: `string` Azure App Services: extra command-line arguments for launching the external `trace-agent` process (whitespace/comma-separated). If unset, no extra args are passed.`DD_TRACE_AGENT_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` Azure App Services: path to the external `trace-agent` executable to launch. If unset, the tracer will not start the external trace-agent process.`DD_TRACE_AGENT_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `-1` **Aliases**:`DD_AGENT_PORT` Sets the port where profiles are sent (the port where the Agent is listening for connections). Ignored if `DD_TRACE_AGENT_URL` is set. Defaults to`8126`.`DD_TRACE_AGENT_PROTOCOL_VERSION` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `0.4` **Since**: `v1.62.0` Protocol version to use for requests to the agent. The version configured must be supported by the agent version installed or all traces will be dropped.`DD_TRACE_AGENT_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10` Timeout in seconds for network interactions with the Datadog Agent.`DD_TRACE_AGENT_UNIX_DOMAIN_SOCKET` {% icon name="icon-link-wui" /%} **Type**: `string` This can be used to direct trace traffic to a proxy, to later be sent to a remote Datadog Agent.`DD_TRACE_AGENT_URL` {% icon name="icon-link-wui" /%} **Type**: `string` **Aliases**:`DD_TRACE_URL` Sets the URL endpoint where traces are sent. Overrides `DD_AGENT_HOST` and `DD_TRACE_AGENT_PORT` if set. Defaults to `http://:` .`DD_TRACE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` Enables the legacy Trace Analytics feature for all integrations by setting the `analytics.sample_rate` metric on spans using each integration's configured analytics sample rate. Superseded by App Analytics in newer Datadog deployments.`DD_TRACE_CLASSES_EXCLUDE` {% icon name="icon-link-wui" /%} **Type**: `string` A list of fully qualified classes (that may end with a wildcard to denote a prefix) which will be ignored (not modified) by the tracer. Must use the jvm internal representation for names (eg package.ClassName$Nested and not package.ClassName.Nested)`DD_TRACE_CLIENT_IP_HEADER` {% icon name="icon-link-wui" /%} **Type**: `string` Configures a custom header name from which to source the http.client_ip tag value. If this variable is set, all other IP-related headers are ignored (for example, setting DD_TRACE_CLIENT_IP_HEADER=custom-ip-header and including the header custom-ip-header: 5.6.7.9 in a request results in a span tagged with "http.client_ip": "5.6.7.9"). If an empty string or null value is passed, IP headers are queried in this order: - x-forwarded-for - x-real-ip - true-client-ip - x-client-ip - x-forwarded - forwarded-for - x-cluster-client-ip - fastly-client-ip - cf-connecting-ip - cf-connecting-ipv6`DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10` An integer representing the maximum depth of an AWS SDK request/reponse payload to use for AWS payload tagging.`DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_TAGS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `758` An integer representing the maximum number of tags to extract per a span to be used for AWS payload tagging.`DD_TRACE_CLOUD_PAYLOAD_TAGGING_SERVICES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `["S3", "Sqs", "Kinesis", "Sns", "DynamoDB", "ApiGatewayV2", "EventBridge", "ApiGateway"]` To enable AWS payload tagging for additional services, use this setting.`DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING` {% icon name="icon-link-wui" /%} **Type**: `array` A comma-separated string of JSONPath entries to redact from AWS SDK requests. Setting this enables AWS payload tagging for requests.`DD_TRACE_CLOUD_RESPONSE_PAYLOAD_TAGGING` {% icon name="icon-link-wui" /%} **Type**: `array` A comma-separated string of JSONPath entries to redact from AWS SDK responses. Setting this enables AWS payload tagging for responses.`DD_TRACE_CONFIG` {% icon name="icon-link-wui" /%} **Type**: `string` Path to valid Java properties file which contains the agent configuration **Notes**: When OTEL_JAVAAGENT_CONFIGURATION_FILE and DD_TRACE_CONFIG are both set we apply the configuration from both files. This is an exception to the usual rule where the Datadog setting overrides the OTel one`DD_TRACE_DB_CLIENT_SPLIT_BY_HOST` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When set to `true` db spans get assigned the remote database hostname as the service name`DD_TRACE_DB_CLIENT_SPLIT_BY_INSTANCE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Set the service name of HTTP requests to `pdo-`. For example, a `PDO->query()` call to a database host `datadoghq.com` has the service name `pdo-datadoghq.com` instead of the default service name of `pdo`.`DD_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACING_ENABLED` Enable framework and library instrumentation. When false, the application code doesn't generate any traces. See also `DD_APM_TRACING_ENABLED`.`DD_TRACE_EXPERIMENTAL_FEATURES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `string` **Supported Input**: A comma-separated list of configuration options that support experimental features. **Supported Values**: `all`, `DD_TAGS` (Java, .NET) **Caveats**: Only supported in Java and .NET **Description**: Enables experimental features for specific configuration options. When enabled, these features may provide additional functionality but are not yet considered stable and may change or be removed in future releases. You can enable all experimental features using the keyword `all`, or list individual features explicitly.`DD_TRACE_FLUSH_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` Trace writer flush interval (seconds): controls how often the tracer flushes/sends traces. Default: 1.0s.`DD_TRACE_GLOBAL_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` Global tags: key/value tags applied everywhere (on all spans and runtime metrics). Merged from `dd.trace.global.tags` (legacy) and `dd.tags`/`dd.trace.tags` (and adjusted by `DD_ENV`/`DD_VERSION`). Default: empty.`DD_TRACE_HEALTH_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` When set to `true` sends tracer health metrics`DD_TRACE_HEALTH_METRICS_STATSD_HOST` {% icon name="icon-link-wui" /%} **Type**: `string` Statsd host to send health metrics to`DD_TRACE_HEALTH_METRICS_STATSD_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` Statsd port to send health metrics to`DD_TRACE_JMX_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` A list of span tags to be added to every jmx metric.`DD_TRACE_METHODS` {% icon name="icon-link-wui" /%} **Type**: `string` List of methods to trace. Accepts a semicolon (`;`) separated list where each entry has the format `Namespace.TypeName[MethodNames]`, where `MethodNames` is either a comma (`,`) separated list of method names or the `*` wildcard. For generic types, replace the angled brackets and the type parameters' names with a backtick (```) followed by the number of generic type parameters. For example, `Dictionary` must be written as `Dictionary`2`. For generic methods, you only need to specify the method name. **Note:** The wildcard method support (`[*]`) selects all methods in a type except constructors, property getters and setters, `Equals`, `Finalize`, `GetHashCode`, and `ToString` `DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP` {% icon name="icon-link-wui" /%} **Type**: `string` **Aliases**:`DD_OBFUSCATION_QUERY_STRING_REGEXP` A regex to redact sensitive data from incoming requests' query string reported in the `http.url` tag (matches are replaced with).`DD_TRACE_PARTIAL_FLUSH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables incrementally flushing large traces to the Datadog Agent, reducing the chance of rejection by the Agent. Use only when you have long-lived traces or traces with many spans. Valid values are `true` or `false`. Added in version 1.26.0, only compatible with the Datadog Agent 7.26.0+.`DD_TRACE_PARTIAL_FLUSH_MIN_SPANS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1000` Minimum number of finished spans accumulated in a trace before a partial flush is triggered. Invalid values are ignored.`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_PIPE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Datadog Agent named pipe: sets the Windows named pipe name/path used as the HTTP transport to communicate with the Datadog Agent (instead of TCP or a Unix domain socket). When set, the tracer's HTTP client uses a NamedPipe socket factory. Default: unset.`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**: `v1.60.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_SECURE_RANDOM` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Secure random ID generation: when enabled, forces the tracer to use the `SECURE_RANDOM` ID generation strategy (based on `SecureRandom`) for trace/span IDs. This is also forced on AWS Lambda SnapStart (`AWS_LAMBDA_INITIALIZATION_TYPE=snap-start`). Default: false.`DD_TRACE_SPAN_ATTRIBUTE_SCHEMA` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `v0` Selects the span attribute and naming schema version used by integrations. Accepted values: `v0`, `v1`.`DD_TRACE_SPAN_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` A list of default tags to be added to every span.`DD_TRACE_SPLIT_BY_TAGS` {% icon name="icon-link-wui" /%} **Type**: `string` Used to rename the service name associated with spans to be identified with the corresponding span tag`DD_TRACE_STATS_COMPUTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.55.0` **Aliases**:`DD_TRACE_TRACER_METRICS_ENABLED` Controls whether client-side trace statistics computation is enabled. When enabled, the tracer pre-aggregates span stats for ingestion.`DD_TRACE_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` **Aliases**:`DD_TAGS` A list of default tags to be added to every span, profile, and JMX metric. If DD_ENV or DD_VERSION is used, it overrides any env or version tag defined in DD_TAGS. Available for versions 0.50.0+.`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.`DD_WRITER_TYPE` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `DDAgentWriter` Default value sends traces to the Agent. Configuring with `LoggingWriter` instead writes traces out to the console. {% /collapsible-section %} {% collapsible-section %} ### Trace Sampling{% #registry-trace_sampling %} (6) {% 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` JSON array 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.`DD_TRACE_WEBSOCKET_MESSAGES_INHERIT_SAMPLING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` By default, websocket messages preserve the same sampling as the span captured during the handshake. This ensures that, if a handshake span has been sampled, all the messages in its session will also be sampled. To disable that behavior and sample each websocket message independently, set this configuration to `false`. {% /collapsible-section %} {% collapsible-section %} ### Trace Propagation{% #registry-trace_propagation %} (24) {% 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_DBM_ALWAYS_APPEND_SQL_COMMENT` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` When the `DD_DBM_PROPAGATION_MODE` is set, a comment is injected in SQL queries. Most of the time it is prepended. This config forces the comment to be appended at all times.`DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Controls whether process-level tags (such as entrypoint metadata) are collected and attached to tracing payloads.`DD_HTTP_SERVER_ROUTE_BASED_NAMING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` When set to `false` http framework routes are not used for resource names. *This can change resource names and derived metrics if changed.*`DD_HTTP_SERVER_TAG_QUERY_STRING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables or disables reporting the query string on server spans. Default value is true.`DD_PROPAGATION_STYLE_EXTRACT` {% icon name="icon-link-wui" /%} **Type**: `string` 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. Deprecated since version 1.9.0`DD_PROPAGATION_STYLE_INJECT` {% icon name="icon-link-wui" /%} **Type**: `string` A comma-separated list of header formats to include to propagate distributed traces between services. Deprecated since version 1.9.0`DD_TRACE_BAGGAGE_MAX_BYTES` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8192` Configuration key to set the maximum number of bytes that can be injected into the baggage header when propagating to a downstream service. Default value is 8192 bytes.`DD_TRACE_BAGGAGE_MAX_ITEMS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `64` Configuration key to set the maximum number of items that can be injected into the baggage header when propagating to a downstream service. Default value is 64 items.`DD_TRACE_BAGGAGE_TAG_KEYS` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `["user.id", "session.id", "account.id"]` **Supported Input**: A comma-separated string representing a list of case-sensitive baggage keys **Caveats**: Not supported in C++ **Description**: A comma-separated list of baggage keys that are automatically applied as span tags to the local root span. For example, a baggage key `user.id` is tagged as `baggage.user.id` This feature only applies to baggage extracted from incoming HTTP headers. Baggage set with the baggage API is not included. - To tag all baggage items, set the value to `*`. Use this with caution to avoid exposing sensitive data in tags. - To disable this feature, set the value to an empty string.`DD_TRACE_HEADER_BAGGAGE` {% icon name="icon-link-wui" /%} **Type**: `map` Accepts a map of case-insensitive header keys to baggage keys and automatically applies matching request header values as baggage on traces. On propagation the reverse mapping is applied: Baggage is mapped to headers. Available since version 1.3.0.`DD_TRACE_HEADER_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` **Since**: `v1.57.0` Automatically apply specified HTTP headers as span tags. If a custom tag name is not specified, the tag key defaults to http.request.headers.for request headers and http.response.headers.for response headers.`DD_TRACE_HTTP_CLIENT_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `400-499` **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_CLIENT_PATH_RESOURCE_NAME_MAPPING` {% icon name="icon-link-wui" /%} **Type**: `map` Maps HTTP client request paths to custom resource names. Uses the same format as `dd.trace.http.server.path-resource-name-mapping`, but applies to HTTP client spans instead of server spans.`DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Set the service name of HTTP requests to `host-`, for example a `curl_exec()` call to `https://datadoghq.com` has the service name `host-datadoghq.com` instead of the default service name of `curl`.`DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_HTTP_CLIENT_TAG_QUERY_STRING` By default, query string parameters and fragments are added to the `http.url` tag on web client spans. Set to `false` to prevent the collection of this data.`DD_TRACE_HTTP_SERVER_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `500-599` **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_HTTP_SERVER_PATH_RESOURCE_NAME_MAPPING` {% icon name="icon-link-wui" /%} **Type**: `map` Maps HTTP request paths to custom resource names. Provide a comma-separated list of `pattern:resource_name` pairs: – `pattern`: An Ant-style path pattern that must match the value of the `http.path_group` span tag. – `resource_name`: The custom resource name to assign if the pattern matches. If `*` is used as the `resource_name` for a matching pattern, the original, unnormalized request path combined with the HTTP method is used as the resource name. For example, given the rule `/test/**:*`, a `GET` request for `/test/some/path` results in the resource name `GET /test/some/path`. Mappings are evaluated in order of priority, and the first matching rule applies. Unmatched request paths use the default normalization behavior. Request path | Resource path ———— | ————- `/admin/index.jsp` | `/admin-page` `/admin/user/12345/delete` | `/admin/user` `/user/12345` | `/user/?``DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `continue` 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**: `string` Specifies trace context propagation formats for extraction and injection in a comma-separated list. May be overridden by extract-specific or inject-specific configurations.`DD_TRACE_PROPAGATION_STYLE_EXTRACT` {% icon name="icon-link-wui" /%} **Type**: `string` A comma-separated list of propagation styles to use for extraction. When set, this overrides `DD_TRACE_PROPAGATION_STYLE` for extraction.`DD_TRACE_PROPAGATION_STYLE_INJECT` {% icon name="icon-link-wui" /%} **Type**: `string` **Configuration**: `tracePropagationStyle.inject` A comma-separated list of header formats to include to propagate distributed traces between services.`DD_TRACE_REQUEST_HEADER_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` Accepts a map of case-insensitive header keys to tag names and automatically applies matching request header values as tags on traces. Also accepts entries without a specified tag name that are automatically mapped to tags of the form `http.request.headers.`. Available since version 0.96.0.`DD_TRACE_RESPONSE_HEADER_TAGS` {% icon name="icon-link-wui" /%} **Type**: `map` Accepts a map of case-insensitive header keys to tag names and automatically applies matching response header values as tags on traces. Also accepts entries without a specified tag name that are automatically mapped to tags of the form `http.response.headers.`. Available since version 0.96.0. {% /collapsible-section %} {% collapsible-section %} ### Trace Integrations{% #registry-trace_integrations %} (814) {% 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_EXPERIMENTAL_DEFER_INTEGRATIONS_UNTIL` {% icon name="icon-link-wui" /%} **Type**: `string` Instrumentation (experimental): defers integration matching/activation until a configured delay (parsed as a simple duration). When the delay is recognized and 5 seconds, deferred matching is resumed later via a scheduled task.`DD_GRPC_CLIENT_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16}` A range of errors can be accepted. By default, gRPC status codes 1 to 16 are reported as errors for gRPC clients. This configuration overrides that. Ex. `dd.grpc.client.error.statuses=1-4,7-10``DD_GRPC_SERVER_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `{2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16}` A range of errors can be accepted. By default, gRPC status codes 2 to 16 are reported as errors for gRPC servers. This configuration overrides that. Ex. `dd.grpc.server.error.statuses=2-4,7-10``DD_HYSTRIX_MEASURED_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Hystrix: when enabled, marks Hystrix spans as measured (`span.setMeasured(true)`), so they contribute to trace metrics. Default: false.`DD_HYSTRIX_TAGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` By default the Hystrix group, command, and circuit state tags are not enabled. This property enables them.`DD_IGNITE_CACHE_INCLUDE_KEYS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Ignite: when enabled, includes the cache key as a span tag (`ignite.cache.key`) on Ignite cache spans. Default: false.`DD_INTEGRATIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tracer: global toggle for automatic instrumentation integrations. When disabled, integrations are not enabled by default (effectively disabling auto-instrumentation unless explicitly enabled). Default: true.`DD_JDK_SOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enable native JDK support for Unix Domain Sockets.`DD_JMS_PROPAGATION_DISABLED_QUEUES` {% icon name="icon-link-wui" /%} **Type**: `string` JMS: comma-separated list of queue names for which trace-context propagation is disabled (no header injection/extraction). Useful for mixed environments or when propagation should be avoided for specific destinations.`DD_JMS_PROPAGATION_DISABLED_TOPICS` {% icon name="icon-link-wui" /%} **Type**: `string` JMS: comma-separated list of topic names for which trace-context propagation is disabled (no header injection/extraction). Useful for mixed environments or when propagation should be avoided for specific destinations.`DD_JMS_UNACKNOWLEDGED_MAX_AGE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `3600` JMS: maximum age (in seconds) of the oldest unacknowledged message span in client-acknowledge sessions before the tracer implicitly finishes the captured spans, preventing unbounded accumulation. Default: 3600.`DD_JMXFETCH_CHECK_PERIOD` {% icon name="icon-link-wui" /%} **Type**: `int` How often to send JMX metrics (in ms).`DD_JMXFETCH_CONFIG` {% icon name="icon-link-wui" /%} **Type**: `string` Additional metrics configuration file for JMX metrics collection. The Java Agent looks for `jvm_direct:true` in the `instance` section in the `yaml` file to change configuration.`DD_JMXFETCH_CONFIG_DIR` {% icon name="icon-link-wui" /%} **Type**: `string` Additional configuration directory for JMX metrics collection. The Java Agent looks for `jvm_direct:true` in the `instance` section in the `yaml` file to change configuration.`DD_JMXFETCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enable collection of JMX metrics by Java Tracing Agent.`DD_JMXFETCH_INITIAL_REFRESH_BEANS_PERIOD` {% icon name="icon-link-wui" /%} **Type**: `int` JMXFetch: sets the initial beans refresh period passed to JMXFetch (controls how often it refreshes the list of MBeans during the initial phase). If unset, JMXFetch uses its default behavior.`DD_JMXFETCH_METRICS_CONFIGS` {% icon name="icon-link-wui" /%} **Type**: `string` JMXFetch (deprecated): comma-separated list of additional metric config YAML files to load (passed to JMXFetch as metric config files).`DD_JMXFETCH_MULTIPLE_RUNTIME_SERVICES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` JMXFetch/runtime metrics: when enabled, collects service names from entry traces and supplies them to JMXFetch so runtime metrics can be reported for multiple services (up to the configured limit). Default: false.`DD_JMXFETCH_MULTIPLE_RUNTIME_SERVICES_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10` JMXFetch/runtime metrics: maximum number of distinct service names to track/report when multiple-runtime-services is enabled. Default: 10.`DD_JMXFETCH_REFRESH_BEANS_PERIOD` {% icon name="icon-link-wui" /%} **Type**: `int` How often to refresh list of available JMX beans (in seconds).`DD_JMXFETCH_START_DELAY` {% icon name="icon-link-wui" /%} **Type**: `string` JMXFetch/JMX initialization: delay (in seconds) before starting the JMX subsystem (used by JMXFetch and other features that require JMX). Default: 15.`DD_JMXFETCH_STATSD_HOST` {% icon name="icon-link-wui" /%} **Type**: `string` **Aliases**:`DD_DOGSTATSD_HOST` Override the address of the trace Agent host that the default tracer attempts to submit DogStatsD metrics to. Use `DD_AGENT_HOST` to override `DD_DOGSTATSD_HOST`.`DD_JMXFETCH_STATSD_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Aliases**:`DD_DOGSTATSD_PORT` Overrides the default trace Agent port for DogStatsD metric submission. If the Agent configuration sets `dogstatsd_port` or `DD_DOGSTATSD_PORT` to something other than the default `8125`, then the library configuration `DD_DOGSTATSD_PORT` must match it.`DD_KAFKA_CLIENT_BASE64_DECODING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Kafka client propagation: when enabled, base64-decodes Kafka header values before extracting trace context (helps when header values are base64-mangled). Default: false.`DD_KAFKA_CLIENT_PROPAGATION_DISABLED_TOPICS` {% icon name="icon-link-wui" /%} **Type**: `string` Kafka client propagation: comma-separated list of topic names for which trace-context propagation is disabled (no header injection/extraction). Useful for mixed client environments or to avoid propagation for specific topics.`DD_RABBIT_INCLUDE_ROUTINGKEY_IN_RESOURCE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` RabbitMQ AMQP instrumentation: when enabled, includes the routing key in the span resource name for `basic.publish` (formats as `basic.publish -> `). Default: true.`DD_RABBIT_PROPAGATION_DISABLED_EXCHANGES` {% icon name="icon-link-wui" /%} **Type**: `string` RabbitMQ AMQP instrumentation: list of exchange names for which trace context propagation should be disabled (no header injection/extraction).`DD_RABBIT_PROPAGATION_DISABLED_QUEUES` {% icon name="icon-link-wui" /%} **Type**: `string` RabbitMQ AMQP instrumentation: list of queue names for which trace context propagation should be disabled (no header injection/extraction).`DD_RESILIENCE4J_MEASURED_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` Resilience4j instrumentation: when enabled, marks Resilience4j spans as `measured` to ensure they contribute to stats/metrics. Default: false.`DD_RESILIENCE4J_TAG_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` Resilience4j instrumentation: when enabled, adds Resilience4j metrics as span tags (for example retry/circuit-breaker metrics). Default: false.`DD_SPARK_APP_NAME_AS_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Spark instrumentation: when enabled, uses the Spark application name (`spark.app.name`) as the Datadog service name for Spark spans (unless running on Databricks or a user-defined service name is set). Default: false.`DD_SPARK_TASK_HISTOGRAM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Spark instrumentation: when enabled, computes and reports histogram-based task metrics (p50/max skew, and distributions for task runtime / bytes read/written / shuffle / spilled bytes) on Spark stage spans. Default: true.`DD_SPRING_DATA_REPOSITORY_INTERFACE_RESOURCE_NAME` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Spring Data instrumentation: when enabled, uses the repository interface + method for span resource names (more specific naming). When disabled, uses only the method name. Default: true.`DD_TRACE_AKKA_FORK_JOIN_EXECUTOR_TASK_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Akka concurrency instrumentation: fully qualified class name of a custom/shaded `AkkaForkJoinTask` wrapper to instrument for context propagation (used as a configured matching type). Default: empty (use built-in Akka class).`DD_TRACE_AKKA_FORK_JOIN_POOL_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Akka concurrency instrumentation: fully qualified class name of a custom/shaded Akka ForkJoinPool to instrument for context propagation (used as a configured matching type). Default: empty (use built-in Akka class).`DD_TRACE_AKKA_FORK_JOIN_TASK_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Akka concurrency instrumentation: fully qualified class name of a custom/shaded `ForkJoinTask` subclass to instrument for context propagation. When set, the instrumentation also matches the configured class in addition to the default Akka `ForkJoinTask`. Default: empty (use built-in Akka class).`DD_TRACE_AWSADD_SPAN_POINTERS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_AWSADD_SPAN_POINTERS` AWS: when enabled, adds span pointers (span links) to spans for supported AWS operations (e.g., S3 object and DynamoDB item) so the touched resource can be uniquely identified. Default: true.`DD_TRACE_AXIS_PROMOTE_RESOURCE_NAME` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Axis2: when enabled, promotes the SOAP action (or destination address) extracted from Axis2 messages to the local root span resource name for server-side traces. Default: false.`DD_TRACE_AXIS_TRANSPORT_CLASS_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Axis2: fully qualified class name of a custom transport sender to instrument. When set, the tracer instruments that transport sender (in addition to known defaults) to create `axis2.transport` spans and inject propagation headers. Default: empty.`DD_TRACE_EXPERIMENTAL_JDBC_POOL_WAITING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` JDBC connection pool instrumentation: when enabled, creates `pool.waiting` spans to measure time spent blocked waiting for a connection from the pool (e.g., HikariCP/DBCP2). Spans are only created when blocking is detected. Default: false.`DD_TRACE_EXPERIMENTAL_JEE_SPLIT_BY_DEPLOYMENT` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` JEE split-by-deployment: when enabled (and the service name is not explicitly set), allows overriding span service names using per-classloader contextual service name, so different deployments (webapps) can be reported as separate services. Default: false.`DD_USM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Universal Service Monitoring (USM): when enabled, activates USM as a target system so USM-specific instrumentations/features can be installed by the Java tracer agent. Default: false. #### 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` (516 integrations) {% icon name="icon-link-wui" /%} Enable or disable tracing for a specific integration. Available integrations:`AGENT_V0_5`, `AKKA_ACTOR`, `AKKA_ACTOR_MAILBOX`, `AKKA_ACTOR_RECEIVE`, `AKKA_ACTOR_SEND`, `AKKA_CONCURRENT`, `AKKA_HTTP`, `AKKA_HTTP_CLIENT`, `AKKA_HTTP_SERVER`, `AKKA_HTTP2`, `ALLOCATEDIRECT`, `AMQP`, `AMQP_E2E_DURATION`, `ANNOTATIONS_LEGACY_TRACING`, `APACHE_HTTP_CLIENT`, `APACHE_HTTP_CLIENT5`, `APACHE_HTTP_CORE`, `APACHE_HTTP_CORE_5`, `APACHE_HTTPASYNCCLIENT`, `APACHE_HTTPASYNCCLIENT5`, `APACHE_HTTPCLIENT`, `APACHE_HTTPCLIENT5`, `APACHE_HTTPCORE`, `APACHE_HTTPCORE_5`, `APACHE_SPARK`, `ARMERIA`, `ARMERIA_GRPC`, `ARMERIA_GRPC_CLIENT`, `ARMERIA_GRPC_MESSAGE`, `ARMERIA_GRPC_SERVER`, `ARMERIA_JETTY`, `AUTH0_JWT`, `AVRO`, `AWS_DYNAMODB`, `AWS_LAMBDA`, `AWS_PROPAGATION`, `AWS_S3`, `AWS_SDK_E2E_DURATION`, `AWS_SDK_LEGACY_TRACING`, `AWS_SDK_PROPAGATION`, `AXIS2`, `AXWAY_API`, `CAFFEINE`, `CASSANDRA`, `CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION`, `CI_VISIBILITY`, `CICS`, `CLASSLOADING`, `CLIENT_IP`, `CLIENT_IP_RESOLVER`, `COMMONS_FILEUPLOAD`, `COMMONS_HTTP_CLIENT`, `CONFLUENT_SCHEMA_REGISTRY`, `CONSUMER_TASK`, `COUCHBASE_3`, `CUCUMBER_5`, `CXF`, `CXF_INVOKER`, `DATANUCLEUS`, `DB2`, `DBCP2`, `DBM`, `DBSTATEMENTRULE`, `DEFINECLASS`, `DIRECTALLOCATION`, `DO_NOT_TRACE_ANNOTATION`, `DROPWIZARD`, `DROPWIZARD_VIEW`, `DYNAMODB`, `ELASTICSEARCH_BODY`, `ELASTICSEARCH_BODY_AND_PARAMS`, `ELASTICSEARCH_PARAMS`, `ELASTICSEARCH_REST`, `ELASTICSEARCH_REST_5`, `ELASTICSEARCH_REST_6`, `ELASTICSEARCH_REST_7`, `ELASTICSEARCH_TRANSPORT`, `ELASTICSEARCH_TRANSPORT_2`, `ELASTICSEARCH_TRANSPORT_5`, `ELASTICSEARCH_TRANSPORT_6`, `ELASTICSEARCH_TRANSPORT_7`, `EMR_AWS_SDK`, `EVENTBRIDGE`, `EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE`, `FFM_NATIVE_TRACING`, `FINATRA`, `FJP`, `FJP_WORKQUEUE`, `FORCEMANUALDROPTAGINTERCEPTOR`, `FORCESAMPLINGPRIORITYTAGINTERCEPTOR`, `FREEMARKER`, `GIT_METADATA`, `GLASSFISH`, `GOOGLE_HTTP_CLIENT`, `GOOGLE_PUBSUB`, `GOOGLE_PUBSUB_E2E_DURATION`, `GOOGLE_PUBSUB_LEGACY_TRACING`, `GRADLE`, `GRADLE_BUILD_LISTENER`, `GRADLE_BUILD_SCOPE_SERVICES`, `GRADLE_DAEMON_JVM_OPTIONS`, `GRADLE_DAEMON_LOGGING`, `GRADLE_PLUGIN_INJECTOR`, `GRAPHQL_JAVA`, `GRIZZLY`, `GRIZZLY_CLIENT`, `GRIZZLY_FILTERCHAIN`, `GRPC_CLIENT`, `GRPC_MESSAGE`, `GRPC_NETTY`, `GRPC_SERVER`, `GRPC_SERVER_CODE_ORIGIN`, `GSON`, `GUAVA`, `HAZELCAST`, `HAZELCAST_LEGACY`, `HEADER_TAGS_LEGACY_PARSING`, `HIBERNATE`, `HIBERNATE_CORE`, `HIKARI`, `HTTPASYNCCLIENT`, `HTTPASYNCCLIENT4_LEGACY_TRACING`, `HTTPASYNCCLIENT5`, `HTTPCLIENT`, `HTTPCLIENT5`, `HTTPCORE`, `HTTPCORE_5`, `HTTPURLCONNECTION`, `HYSTRIX`, `IAST_RESULTSET`, `IASTINSTRUMENTATION`, `IGNITE`, `INFERRED_PROXY_SERVICES`, `INPUTSTREAM`, `INTEGRATION_APACHE_HTTPASYNCCLIENT_MATCHING_SHORTCUT`, `INTEGRATION_DATANUCLEUS_MATCHING_SHORTCUT`, `INTEGRATION_DROPWIZARD_MATCHING_SHORTCUT`, `INTEGRATION_GRPC_MATCHING_SHORTCUT`, `INTEGRATION_GRPC_SERVER_MATCHING_SHORTCUT`, `INTEGRATION_HIBERNATE_CORE_MATCHING_SHORTCUT`, `INTEGRATION_HIBERNATE_MATCHING_SHORTCUT`, `INTEGRATION_HTTPASYNCCLIENT_MATCHING_SHORTCUT`, `INTEGRATION_HTTPASYNCCLIENT5_MATCHING_SHORTCUT`, `INTEGRATION_HTTPCLIENT_MATCHING_SHORTCUT`, `INTEGRATION_HTTPCLIENT5_MATCHING_SHORTCUT`, `INTEGRATION_JAVA_CONCURRENT_MATCHING_SHORTCUT`, `INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_MATCHING_SHORTCUT`, `INTEGRATION_OPENTELEMETRY_METRICS_MATCHING_SHORTCUT`, `INTEGRATION_REJECTED_EXECUTION_HANDLER_MATCHING_SHORTCUT`, `JACKSON`, `JACKSON_1`, `JACKSON_2`, `JACKSON_2_12`, `JACKSON_2_16`, `JACKSON_2_6`, `JACKSON_2_8`, `JACKSON_CORE`, `JACOCO`, `JAKARTA_JMS`, `JAKARTA_MAIL`, `JAKARTA_MAIL_BODY`, `JAKARTA_MAIL_TRANSPORT`, `JAKARTA_RS`, `JAKARTA_RS_ANNOTATIONS`, `JAKARTA_RS_FILTER`, `JAKARTA_WEBSOCKET`, `JAKARTA_WS`, `JAKARTARS`, `JAVA_COMPLETABLEFUTURE`, `JAVA_CONCURRENT`, `JAVA_CONCURRENT_OTHER`, `JAVA_HTTP_CLIENT`, `JAVA_LANG`, `JAVA_LANG_21`, `JAVA_LANG_22`, `JAVA_LANG_APPSEC`, `JAVA_LANG_MANAGEMENT`, `JAVA_MODULE`, `JAVA_NET`, `JAVA_TIMER`, `JAVAX_MAIL`, `JAVAX_MAIL_BODY`, `JAVAX_MAIL_TRANSPORT`, `JAVAX_WEBSOCKET`, `JAX_RS`, `JAX_RS_ANNOTATIONS`, `JAX_RS_CLIENT`, `JAX_RS_EXCEPTION_AS_ERROR`, `JAX_RS_FILTER`, `JAX_WS`, `JAXRS`, `JBOSS_LOGMANAGER`, `JBOSS_MODULES`, `JDBC`, `JDBC_DATASOURCE`, `JDBC_RESULTSET`, `JEDIS`, `JEE_ENV_ENTRY`, `JERSEY`, `JETTY`, `JETTY_CLIENT`, `JETTY_CONCURRENT`, `JETTY_WEBSOCKET`, `JMS`, `JMS_1`, `JMS_2`, `JMS_E2E_DURATION`, `JMS_LEGACY_TRACING`, `JMS_PROPAGATION`, `JMS_TIME_IN_QUEUE`, `JMXFETCH_ACTIVEMQ`, `JMXFETCH_CASSANDRA`, `JMXFETCH_CONFLUENT_PLATFORM`, `JMXFETCH_HAZELCAST`, `JMXFETCH_HIVE`, `JMXFETCH_HIVEMQ`, `JMXFETCH_HUDI`, `JMXFETCH_IGNITE`, `JMXFETCH_JBOSS_WILDFLY`, `JMXFETCH_KAFKA`, `JMXFETCH_KUBE_APISERVER_METRICS`, `JMXFETCH_PRESTO`, `JMXFETCH_SOLR`, `JMXFETCH_SONARQUBE`, `JMXFETCH_TOMCAT`, `JMXFETCH_WEBLOGIC`, `JMXFETCH_WEBSPHERE`, `JNI`, `JOSE_JWT`, `JSP`, `JSP_COMPILE`, `JSP_RENDER`, `JUNIT_38`, `JUNIT_4`, `JUNIT_4_CUCUMBER`, `JUNIT_4_MUNIT`, `JUNIT_5`, `JUNIT_5_CUCUMBER`, `JUNIT_5_SPOCK`, `JUNIT4`, `JWT`, `KAFKA`, `KAFKA_0_11`, `KAFKA_3_8`, `KAFKA_CLIENT_PROPAGATION`, `KAFKA_CONNECT`, `KAFKA_E2E_DURATION`, `KAFKA_LEGACY_TRACING`, `KAFKA_PROPAGATION`, `KAFKA_STREAMS`, `KAFKA_STREAMS_E2E_DURATION`, `KAFKA_TIME_IN_QUEUE`, `KARATE`, `KOTLIN_COROUTINE`, `LEGACY_E2E_DURATION`, `LETTUCE`, `LETTUCE_4`, `LETTUCE_4_ASYNC`, `LETTUCE_5`, `LETTUCE_5_ASYNC`, `LETTUCE_5_RX`, `LIBERTY`, `LIBERTY_CLASSLOADING`, `LOG4J`, `LOG4J_1`, `LOG4J_2`, `LOGBACK`, `LOGS_INTAKE`, `LOGS_INTAKE_LOG4J_2`, `LOGS_INTAKE_LOGBACK`, `MAVEN`, `MICRONAUT`, `MICRONAUT_HTTP_SERVER_NETTY`, `MICRONAUT_HTTP_SERVER_NETTY_2`, `MICRONAUT_HTTP_SERVER_NETTY_3`, `MICRONAUT_HTTP_SERVER_NETTY_4`, `MICRONAUT_SPAN_ORIGIN`, `MMAP`, `MONGO`, `MONGO_3_1`, `MONGO_3_4`, `MONGO_3_6`, `MONGO_3_8`, `MONGO_REACTIVESTREAMS`, `MULE`, `MULE_JPMS`, `MULTIPART`, `NATIVE_IMAGE`, `NETTY`, `NETTY_3_8`, `NETTY_4_0`, `NETTY_4_1`, `NETTY_4_1_HTTP2`, `NETTY_CONCURRENT`, `NETTY_EVENT_EXECUTOR`, `NETTY_PROMISE`, `NEW_TASK_FOR`, `NING`, `NOT_NOT_TRACE`, `OGNL`, `OKHTTP`, `OKHTTP_2`, `OKHTTP_3`, `OPENAI_JAVA`, `OPENSEARCH_REST`, `OPENSEARCH_TRANSPORT`, `OPENTELEMETRY_1`, `OPENTELEMETRY_1_47`, `OPENTELEMETRY_ANNOTATIONS`, `OPENTELEMETRY_ANNOTATIONS_1_20`, `OPENTELEMETRY_ANNOTATIONS_1_26`, `OPENTELEMETRY_BETA`, `OPENTELEMETRY_EXPERIMENTAL`, `OPENTELEMETRY_METRICS`, `OPENTRACING`, `OPENTRACING_GLOBALTRACER`, `ORG_JSON`, `OSGI`, `PEER_HOSTNAME`, `PEER_SERVICE_DEFAULTS`, `PEERSERVICETAGINTERCEPTOR`, `PEKKO_ACTOR`, `PEKKO_ACTOR_MAILBOX`, `PEKKO_ACTOR_RECEIVE`, `PEKKO_ACTOR_SEND`, `PEKKO_CONCURRENT`, `PEKKO_HTTP`, `PEKKO_HTTP_CLIENT`, `PEKKO_HTTP_SERVER`, `PEKKO_HTTP2`, `PEKKO_SCHEDULER`, `PERF_METRICS`, `PLAY`, `PLAY_ACTION`, `PLAY_WS`, `POWERMOCK`, `PROPAGATION_STYLE_B3_PADDING`, `PROTOBUF`, `QUARTZ`, `RABBIT_LEGACY_TRACING`, `RABBIT_PROPAGATION`, `RABBIT_TIME_IN_QUEUE`, `RABBITMQ`, `RABBITMQ_E2E_DURATION`, `RABBITMQ_LEGACY_TRACING`, `RABBITMQ_PROPAGATION`, `RABBITMQ_TIME_IN_QUEUE`, `RATPACK`, `RATPACK_REQUEST_BODY`, `REACTIVE_STREAMS`, `REACTIVE_STREAMS_1`, `REACTOR_CORE`, `REACTOR_NETTY`, `REACTOR_NETTY_1`, `REDIS`, `REDISCALA`, `REDISCALA_CONNECTION`, `REDISSON`, `REJECTED_EXECUTION_HANDLER`, `REMOVE_INTEGRATION_SERVICE_NAMES`, `RENAISSANCE`, `RESILIENCE4J`, `RESILIENCE4J_REACTOR`, `RESOLVER`, `RESOURCE_RENAMING`, `RESOURCENAMERULE`, `RESPONSE`, `RESTEASY`, `RESTLET_HTTP`, `RESTLET_HTTP_SERVER`, `RMI`, `RMI_CLIENT`, `RMI_CLIENT_CONTEXT_PROPAGATOR`, `RMI_CONTEXT_PROPAGATOR`, `RMI_SERVER`, `RMI_SERVER_CONTEXT_PROPAGATOR`, `RUNNABLE`, `RUNNABLE_FUTURE`, `RXJAVA`, `S3`, `SCALA_CONCURRENT`, `SCALA_FUTURE_OBJECT`, `SCALA_PROMISE_COMPLETE`, `SCALA_PROMISE_COMPLETION_PRIORITY`, `SCALA_PROMISE_RESOLVE`, `SCALATEST`, `SERVELET_RESPONSE`, `SERVICE_DISCOVERY`, `SERVICENAMETAGINTERCEPTOR`, `SERVICETALK`, `SERVICETALK_CONCURRENT`, `SERVLET`, `SERVLET_2`, `SERVLET_3`, `SERVLET_3_ASYNC_CONTEXT`, `SERVLET_5`, `SERVLET_5_ASYNC_CONTEXT`, `SERVLET_COOKIE`, `SERVLET_DISPATCHER`, `SERVLET_FILTER`, `SERVLET_PRINCIPAL`, `SERVLET_REQUEST`, `SERVLET_REQUEST_BODY`, `SERVLET_RESPONSE`, `SERVLET_SERVICE`, `SERVLET_SESSION`, `SERVLETCONTEXTTAGINTERCEPTOR`, `SETUP_TEARDOWN`, `SFN`, `SFN_INJECT_DATADOG_ATTRIBUTE`, `SHUTDOWN`, `SLICK`, `SNAKEYAML`, `SNS`, `SNS_INJECT_DATADOG_ATTRIBUTE`, `SOCKET`, `SOFARPC`, `SPARK`, `SPARK_EXECUTOR`, `SPARK_EXIT`, `SPARK_LAUNCHER`, `SPARK_OPENLINEAGE`, `SPARKJAVA`, `SPARKJAVA_2_4`, `SPRAY_HTTP`, `SPRAY_HTTP_SERVER`, `SPRING_ASYNC`, `SPRING_BEANS`, `SPRING_BOOT`, `SPRING_BOOT_SPAN_ORIGIN`, `SPRING_CLOUD_ZUUL`, `SPRING_CORE`, `SPRING_DATA`, `SPRING_JMS`, `SPRING_MESSAGING`, `SPRING_MESSAGING_4`, `SPRING_MESSAGING_E2E_DURATION`, `SPRING_MESSAGING_KOTLIN`, `SPRING_PATH_FILTER`, `SPRING_RABBIT`, `SPRING_SCHEDULING`, `SPRING_SCHEDULING_LEGACY_TRACING`, `SPRING_SECURITY`, `SPRING_WEB`, `SPRING_WEB_CODE_ORIGIN`, `SPRING_WEBFLUX`, `SPRING_WEBFLUX_CLIENT`, `SPRING_WEBFLUX_FUNCTIONAL`, `SPRING_WS`, `SPRING_WS_2`, `SPYMEMCACHED`, `SQS`, `SQS_BODY_PROPAGATION`, `SQS_INJECT_DATADOG_ATTRIBUTE`, `SQS_LEGACY_TRACING`, `SQS_PROPAGATION`, `SQS_TIME_IN_QUEUE`, `SSLSOCKET`, `STATUS404DECORATOR`, `STATUS404RULE`, `STRICT_WRITES`, `STRUCTURED_TASK_SCOPE`, `STRUCTURED_TASK_SCOPE_21`, `STRUCTURED_TASK_SCOPE_25`, `SUREFIRE`, `SYNAPSE3`, `SYNAPSE3_CLIENT`, `SYNAPSE3_SERVER`, `TASK_RUNNER`, `TASK_UNWRAPPING`, `TEST_ORDER`, `TEST_RETRY`, `TESTNG`, `TESTNG_6`, `TESTNG_7`, `TESTNG_ITR`, `THREAD_POOL_EXECUTORS_LEGACY_TRACING`, `THROWABLES`, `THYMELEAF`, `TIBCO`, `TIBCO_BW`, `TINYLOG`, `TOMCAT`, `TOMCAT_CLASSLOADING`, `TOMCAT_WEBSOCKET`, `TRACE`, `TRACE_ANNOTATION`, `TRACE_CONFIG`, `TRACER_METRICS`, `TRACER_METRICS_BUFFERING`, `TWILIO_SDK`, `UNDERTOW`, `UNDERTOW_2_0`, `UNDERTOW_2_2`, `UNDERTOW_LEGACY_TRACING`, `UNDERTOW_REQUEST_PARSE`, `URLASRESOURCENAMERULE`, `URLCONNECTION`, `VALKEY`, `VELOCITY`, `VERTX`, `VERTX_3_4`, `VERTX_3_5`, `VERTX_3_9`, `VERTX_4_0`, `VERTX_5_0`, `VERTX_REDIS_CLIENT`, `VERTX_SQL_CLIENT`, `VIRTUAL_THREAD`, `WALLCLOCK`, `WEAVER`, `WEBSOCKET`, `WEBSOCKET_MESSAGES`, `WEBSPHERE_JMX`, `WILDFLY`, `ZIO_EXPERIMENTAL` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-analytics-enabled %} #### `DD_TRACE__ANALYTICS_ENABLED` (119 integrations) {% icon name="icon-link-wui" /%} Enable App Analytics (trace search) for spans produced by this integration. Available integrations:`AEROSPIKE`, `AKKA_HTTP`, `AKKA_HTTP_CLIENT`, `AKKA_HTTP_SERVER`, `AMQP`, `APACHE_HTTP_CLIENT`, `APACHE_HTTP_CLIENT5`, `APACHE_HTTPASYNCCLIENT`, `APACHE_HTTPCLIENT`, `APACHE_HTTPCLIENT5`, `ARMERIA`, `ARMERIA_GRPC`, `ARMERIA_GRPC_CLIENT`, `ARMERIA_GRPC_SERVER`, `AWS_SDK`, `AXIS2`, `AXWAY_HTTP`, `AZURE_FUNCTIONS`, `CASSANDRA`, `CICS`, `COMMONS_HTTP_CLIENT`, `COUCHBASE`, `CUCUMBER`, `CUCUMBER_5`, `DATANUCLEUS`, `FINATRA`, `GOOGLE_HTTP_CLIENT`, `GOOGLE_PUBSUB`, `GRAPHQL_JAVA`, `GRIZZLY`, `GRIZZLY_CLIENT`, `GRPC_CLIENT`, `GRPC_SERVER`, `HAZELCAST_SDK`, `HIBERNATE_CORE`, `HTTPASYNCCLIENT`, `HTTPCLIENT`, `HTTPCLIENT5`, `HTTPURLCONNECTION`, `IGNITE`, `JAKARTA_WS`, `JAVA_HTTP_CLIENT`, `JAX_RS`, `JAX_RS_CLIENT`, `JAX_WS`, `JAXRS`, `JDBC`, `JDBC_DATASOURCE`, `JEDIS`, `JETTY`, `JETTY_CLIENT`, `JMS`, `JSP`, `KAFKA_STREAMS`, `LETTUCE`, `LIBERTY`, `MICRONAUT`, `MULE`, `NETTY`, `NETTY_3_9`, `NETTY_4_0`, `NING`, `OKHTTP`, `OKHTTP_2`, `OKHTTP_3`, `OPENAI_JAVA`, `OPENSEARCH`, `OPENTELEMETRY_ANNOTATIONS`, `OPENTELEMETRY_ANNOTATIONS_1`, `PEKKO_HTTP`, `PEKKO_HTTP_CLIENT`, `PEKKO_HTTP_SERVER`, `PLAY`, `PLAY_WS`, `QUARTZ`, `RABBITMQ`, `RATPACK`, `REDISCALA`, `REDISSON`, `RESILIENCE4J`, `RESILIENCE4J_RETRY`, `RESTLET_HTTP`, `RESTLET_HTTP_SERVER`, `RMI`, `RMI_CLIENT`, `RMI_SERVER`, `SERVLET`, `SERVLET_2`, `SERVLET_3`, `SERVLET_DISPATCHER`, `SERVLET_FILTER`, `SERVLET_RESPONSE`, `SERVLET_SERVICE`, `SOFARPC`, `SPARK_EXECUTOR`, `SPRAY`, `SPRING_DATA`, `SPRING_MESSAGING`, `SPRING_SCHEDULING`, `SPRING_WEB`, `SPRING_WEBFLUX`, `SPRING_WEBFLUX_CLIENT`, `SPYMEMCACHED`, `SYNAPSE3`, `TIBCO_BW`, `TOMCAT`, `TRACE_ANNOTATION`, `TRACE_CONFIG`, `TRACE_FFM`, `TWILIO_SDK`, `UNDERTOW_HTTP`, `UNDERTOW_HTTP_SERVER`, `URLCONNECTION`, `VALKEY`, `VERTX`, `VERTX_REDIS_CLIENT`, `VERTX_ROUTE_HANDLER`, `VERTX_SQL_CLIENT`, `WEBSOCKET` {% /collapsible-section %} {% collapsible-section #dd-trace-integration-analytics-sample-rate %} #### `DD_TRACE__ANALYTICS_SAMPLE_RATE` (124 integrations) {% icon name="icon-link-wui" /%} Set the App Analytics sample rate for this integration (0.0 to 1.0). Available integrations:`AEROSPIKE`, `AKKA_HTTP`, `AKKA_HTTP_CLIENT`, `AKKA_HTTP_SERVER`, `AMQP`, `APACHE_HTTP_CLIENT`, `APACHE_HTTP_CLIENT5`, `APACHE_HTTPASYNCCLIENT`, `APACHE_HTTPCLIENT`, `APACHE_HTTPCLIENT5`, `ARMERIA`, `ARMERIA_GRPC`, `ARMERIA_GRPC_CLIENT`, `ARMERIA_GRPC_SERVER`, `AWS_SDK`, `AXIS2`, `AXWAY_HTTP`, `AZURE_FUNCTIONS`, `CASSANDRA`, `CICS`, `COMMONS_HTTP_CLIENT`, `COUCHBASE`, `CUCUMBER`, `CUCUMBER_5`, `DATANUCLEUS`, `ELASTICSEARCH`, `FINATRA`, `GOOGLE_HTTP_CLIENT`, `GOOGLE_PUBSUB`, `GRAPHQL_JAVA`, `GRIZZLY`, `GRIZZLY_CLIENT`, `GRPC`, `GRPC_CLIENT`, `GRPC_SERVER`, `HAZELCAST_SDK`, `HIBERNATE_CORE`, `HTTPASYNCCLIENT`, `HTTPCLIENT`, `HTTPCLIENT5`, `HTTPURLCONNECTION`, `IGNITE`, `JAKARTA_WS`, `JAVA_HTTP_CLIENT`, `JAX_RS`, `JAX_RS_CLIENT`, `JAX_WS`, `JAXRS`, `JDBC`, `JDBC_DATASOURCE`, `JEDIS`, `JETTY`, `JETTY_CLIENT`, `JMS`, `JSP`, `KAFKA`, `KAFKA_STREAMS`, `LETTUCE`, `LIBERTY`, `MICRONAUT`, `MONGO`, `MULE`, `NETTY`, `NETTY_3_9`, `NETTY_4_0`, `NING`, `OKHTTP`, `OKHTTP_2`, `OKHTTP_3`, `OPENAI_JAVA`, `OPENSEARCH`, `OPENTELEMETRY_ANNOTATIONS`, `OPENTELEMETRY_ANNOTATIONS_1`, `PEKKO_HTTP`, `PEKKO_HTTP_CLIENT`, `PEKKO_HTTP_SERVER`, `PLAY`, `PLAY_WS`, `QUARTZ`, `RABBITMQ`, `RATPACK`, `REDIS`, `REDISCALA`, `REDISSON`, `RESILIENCE4J`, `RESILIENCE4J_RETRY`, `RESTLET_HTTP`, `RESTLET_HTTP_SERVER`, `RMI`, `RMI_CLIENT`, `RMI_SERVER`, `SERVLET`, `SERVLET_2`, `SERVLET_3`, `SERVLET_DISPATCHER`, `SERVLET_FILTER`, `SERVLET_RESPONSE`, `SERVLET_SERVICE`, `SOFARPC`, `SPARK_EXECUTOR`, `SPRAY`, `SPRING_DATA`, `SPRING_MESSAGING`, `SPRING_SCHEDULING`, `SPRING_WEB`, `SPRING_WEBFLUX`, `SPRING_WEBFLUX_CLIENT`, `SPYMEMCACHED`, `SYNAPSE3`, `TIBCO_BW`, `TOMCAT`, `TRACE_ANNOTATION`, `TRACE_CONFIG`, `TRACE_FFM`, `TWILIO_SDK`, `UNDERTOW_HTTP`, `UNDERTOW_HTTP_SERVER`, `URLCONNECTION`, `VALKEY`, `VERTX`, `VERTX_REDIS_CLIENT`, `VERTX_ROUTE_HANDLER`, `VERTX_SQL_CLIENT`, `WEBSOCKET` {% /collapsible-section %} #### Per-Integration Settings (535 integrations) Each section lists all configuration keys available for a specific integration. {% collapsible-section #integration-aerospike %} #### AEROSPIKE (2) {% icon name="icon-link-wui" /%} `DD_TRACE_AEROSPIKE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AEROSPIKE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Aerospike integration`DD_TRACE_AEROSPIKE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AEROSPIKE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Aerospike integration {% /collapsible-section %} {% collapsible-section #integration-agent-v0-5 %} #### AGENT_V0_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AGENT_V0_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Datadog Agent communication: when enabled, allows using and probing the Datadog Agent trace intake `v0.5/traces` endpoint (preferred over v0.4/v0.3 when available). Default: false. {% /collapsible-section %} {% collapsible-section #integration-akka-actor %} #### AKKA_ACTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_ACTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AKKA_ACTOR_ENABLED`, `DD_INTEGRATION_AKKA_ACTOR_ENABLED` Enables Akka actor context-propagation instrumentation (captures trace context into actor message envelopes and restores/cleans it during mailbox and actor message processing) {% /collapsible-section %} {% collapsible-section #integration-akka-actor-mailbox %} #### AKKA_ACTOR_MAILBOX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_ACTOR_MAILBOX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AKKA_ACTOR_MAILBOX_ENABLED`, `DD_INTEGRATION_AKKA_ACTOR_MAILBOX_ENABLED` Enables Akka Actor Mailbox (AkkaMailbox) instrumentation {% /collapsible-section %} {% collapsible-section #integration-akka-actor-receive %} #### AKKA_ACTOR_RECEIVE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_ACTOR_RECEIVE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AKKA_ACTOR_RECEIVE_ENABLED`, `DD_INTEGRATION_AKKA_ACTOR_RECEIVE_ENABLED` Enables Akka Actor Receive (AkkaActorCell) instrumentation {% /collapsible-section %} {% collapsible-section #integration-akka-actor-send %} #### AKKA_ACTOR_SEND (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_ACTOR_SEND_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AKKA_ACTOR_SEND_ENABLED`, `DD_TRACE_INTEGRATION_AKKA_ACTOR_SEND_ENABLED` Enables Akka actor send context propagation (captures trace context into `akka.dispatch.Envelope` and activates it when messages are routed/sent) {% /collapsible-section %} {% collapsible-section #integration-akka-concurrent %} #### AKKA_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AKKA_CONCURRENT_ENABLED`, `DD_TRACE_INTEGRATION_AKKA_CONCURRENT_ENABLED` Enables Akka concurrency context propagation across actor messaging and Akka fork-join execution (captures/restores trace context for envelopes, actor/mailbox processing, and fork-join tasks, and blocks propagation during lazy ActorSystem init) {% /collapsible-section %} {% collapsible-section #integration-akka-http %} #### AKKA_HTTP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AKKA_HTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Akka HTTP tracing`DD_TRACE_AKKA_HTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AKKA_HTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Akka HTTP spans`DD_TRACE_AKKA_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AKKA_HTTP_ENABLED`, `DD_INTEGRATION_AKKA_HTTP_ENABLED` Enables Akka HTTP tracing (creates spans for inbound and outbound HTTP requests, propagates context through Akka streams/actors, and installs AppSec/IAST hooks in request parsing/unmarshalling when those products are enabled) {% /collapsible-section %} {% collapsible-section #integration-akka-http-client %} #### AKKA_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AKKA_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Akka HTTP client request tracing`DD_TRACE_AKKA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AKKA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Akka HTTP client request spans`DD_TRACE_AKKA_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AKKA_HTTP_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_AKKA_HTTP_CLIENT_ENABLED` Enables Akka HTTP client tracing (creates spans for `HttpExt.singleRequest`/`singleRequestImpl`, injects propagation headers, and avoids leaking parent scope into long-lived connection pools) {% /collapsible-section %} {% collapsible-section #integration-akka-http-server %} #### AKKA_HTTP_SERVER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_HTTP_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AKKA_HTTP_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Akka HTTP server request tracing`DD_TRACE_AKKA_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AKKA_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Akka HTTP server request spans`DD_TRACE_AKKA_HTTP_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AKKA_HTTP_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_AKKA_HTTP_SERVER_ENABLED` Enables Akka HTTP server tracing (wraps `bindAndHandle`/`bindAndHandleAsync` handlers to create request/response spans and integrates with the default ExceptionHandler for AppSec error reporting) {% /collapsible-section %} {% collapsible-section #integration-akka-http2 %} #### AKKA_HTTP2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AKKA_HTTP2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AKKA_HTTP2_ENABLED`, `DD_INTEGRATION_AKKA_HTTP2_ENABLED` Enables Akka HTTP/2 (AkkaHttp2Server) instrumentation {% /collapsible-section %} {% collapsible-section #integration-allocatedirect %} #### ALLOCATEDIRECT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ALLOCATEDIRECT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ALLOCATEDIRECT_ENABLED`, `DD_INTEGRATION_ALLOCATEDIRECT_ENABLED` Enables AllocateDirect (ByteBuffer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-amqp %} #### AMQP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_AMQP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AMQP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by RabbitMQ AMQP instrumentation (publish/consume and Channel command spans)`DD_TRACE_AMQP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AMQP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by RabbitMQ AMQP spans`DD_TRACE_AMQP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AMQP_ENABLED`, `DD_TRACE_INTEGRATION_AMQP_ENABLED` Enables RabbitMQ AMQP client instrumentation (creates spans for Channel commands and message publish/consume, and propagates trace context via AMQP headers) {% /collapsible-section %} {% collapsible-section #integration-amqp-e2e-duration %} #### AMQP_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AMQP_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AMQP_E2E_DURATION_ENABLED` AMQP/RabbitMQ instrumentation: when enabled, records end-to-end duration for messaging spans (sets `record.e2e_duration_ms` when the end-to-end start time is available). Default: false. {% /collapsible-section %} {% collapsible-section #integration-annotations %} #### ANNOTATIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ANNOTATIONS` {% icon name="icon-link-wui" /%} **Type**: `string` A list of method annotations to treat as `@Trace`. {% /collapsible-section %} {% collapsible-section #integration-annotations-legacy-tracing %} #### ANNOTATIONS_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ANNOTATIONS_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_ANNOTATIONS_LEGACY_TRACING_ENABLED` `@Trace` / trace-annotations instrumentation: when enabled, uses the legacy operation name `trace.annotation` (unless `operationName` is set explicitly on the annotation). When disabled, uses the traced method name as operation name (improved span naming). Default: true. {% /collapsible-section %} {% collapsible-section #integration-apache-http-client %} #### APACHE_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_APACHE_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_APACHE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_APACHE_HTTP_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_APACHE_HTTP_CLIENT_ENABLED` Enables Apache HttpClient (ApacheHttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-http-client5 %} #### APACHE_HTTP_CLIENT5 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTP_CLIENT5_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_APACHE_HTTP_CLIENT5_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTP_CLIENT5_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_APACHE_HTTP_CLIENT5_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTP_CLIENT5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_APACHE_HTTP_CLIENT5_ENABLED`, `DD_TRACE_INTEGRATION_APACHE_HTTP_CLIENT5_ENABLED` Enables Apache HttpClient 5 (ApacheHttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-http-core %} #### APACHE_HTTP_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTP_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_HTTP_CORE_ENABLED`, `DD_INTEGRATION_APACHE_HTTP_CORE_ENABLED` Enables Apache HttpCore (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-http-core-5 %} #### APACHE_HTTP_CORE_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTP_CORE_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_APACHE_HTTP_CORE_5_ENABLED`, `DD_TRACE_INTEGRATION_APACHE_HTTP_CORE_5_ENABLED` Enables Apache HttpCore 5 (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-httpasyncclient %} #### APACHE_HTTPASYNCCLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPASYNCCLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_APACHE_HTTPASYNCCLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ApacheHttpAsyncClient integration`DD_TRACE_APACHE_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_APACHE_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ApacheHttpAsyncClient integration`DD_TRACE_APACHE_HTTPASYNCCLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_APACHE_HTTPASYNCCLIENT_ENABLED`, `DD_TRACE_INTEGRATION_APACHE_HTTPASYNCCLIENT_ENABLED` Enables Apache HttpAsyncClient (ApacheHttpAsyncClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-httpasyncclient5 %} #### APACHE_HTTPASYNCCLIENT5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPASYNCCLIENT5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_HTTPASYNCCLIENT5_ENABLED`, `DD_INTEGRATION_APACHE_HTTPASYNCCLIENT5_ENABLED` Enables Apache HttpAsyncClient 5 (ApacheHttpAsyncClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-httpclient %} #### APACHE_HTTPCLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPCLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_APACHE_HTTPCLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Apache HttpClient request tracing`DD_TRACE_APACHE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_APACHE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Apache HttpClient request spans`DD_TRACE_APACHE_HTTPCLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_HTTPCLIENT_ENABLED`, `DD_INTEGRATION_APACHE_HTTPCLIENT_ENABLED` Enables Apache HttpClient tracing (creates spans for outbound HttpClient requests in v4/v5, injects propagation headers, and adds IAST taint tracking for HttpClient 5 request URIs when IAST is enabled) {% /collapsible-section %} {% collapsible-section #integration-apache-httpclient5 %} #### APACHE_HTTPCLIENT5 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPCLIENT5_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_APACHE_HTTPCLIENT5_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_APACHE_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ApacheHttpClient integration`DD_TRACE_APACHE_HTTPCLIENT5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_HTTPCLIENT5_ENABLED`, `DD_INTEGRATION_APACHE_HTTPCLIENT5_ENABLED` Enables Apache HttpClient 5 (ApacheHttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-httpcore %} #### APACHE_HTTPCORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPCORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_HTTPCORE_ENABLED`, `DD_INTEGRATION_APACHE_HTTPCORE_ENABLED` Enables Apache HttpCore (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-httpcore-5 %} #### APACHE_HTTPCORE_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_HTTPCORE_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_APACHE_HTTPCORE_5_ENABLED`, `DD_TRACE_INTEGRATION_APACHE_HTTPCORE_5_ENABLED` Enables Apache HttpCore 5 (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-apache-spark %} #### APACHE_SPARK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APACHE_SPARK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_APACHE_SPARK_ENABLED`, `DD_INTEGRATION_APACHE_SPARK_ENABLED` Enables Apache Spark instrumentation (injects Datadog listeners to trace Spark application/job execution and capture Spark SQL plan metadata; can also integrate with OpenLineage when enabled) {% /collapsible-section %} {% collapsible-section #integration-armeria %} #### ARMERIA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_ARMERIA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Armeria tracing (gRPC client/server calls)`DD_TRACE_ARMERIA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_ARMERIA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Armeria spans`DD_TRACE_ARMERIA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ARMERIA_ENABLED`, `DD_TRACE_INTEGRATION_ARMERIA_ENABLED` Enables Armeria instrumentation (adds tracing for Armeria gRPC client/server calls and provides JettyService helpers to manage Jetty HttpChannel lifecycle under Armeria) {% /collapsible-section %} {% collapsible-section #integration-armeria-grpc %} #### ARMERIA_GRPC (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_GRPC_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_ARMERIA_GRPC_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Armeria gRPC tracing`DD_TRACE_ARMERIA_GRPC_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_ARMERIA_GRPC_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Armeria gRPC spans`DD_TRACE_ARMERIA_GRPC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ARMERIA_GRPC_ENABLED`, `DD_TRACE_INTEGRATION_ARMERIA_GRPC_ENABLED` Enables Armeria gRPC tracing (instruments gRPC client calls and installs a tracing ServerInterceptor when gRPC services are registered) {% /collapsible-section %} {% collapsible-section #integration-armeria-grpc-client %} #### ARMERIA_GRPC_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_GRPC_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_ARMERIA_GRPC_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ArmeriaGrpcClient integration`DD_TRACE_ARMERIA_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_ARMERIA_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ArmeriaGrpcClient integration`DD_TRACE_ARMERIA_GRPC_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ARMERIA_GRPC_CLIENT_ENABLED`, `DD_INTEGRATION_ARMERIA_GRPC_CLIENT_ENABLED` Enables Armeria gRPC Client (ArmeriaGrpcClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-armeria-grpc-message %} #### ARMERIA_GRPC_MESSAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_GRPC_MESSAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_ARMERIA_GRPC_MESSAGE_ENABLED`, `DD_TRACE_INTEGRATION_ARMERIA_GRPC_MESSAGE_ENABLED` Armeria gRPC instrumentation: enables message-level spans. When enabled, creates a `grpc.message` span for each received message (e.g., streaming responses) on the client side. Default: false. {% /collapsible-section %} {% collapsible-section #integration-armeria-grpc-server %} #### ARMERIA_GRPC_SERVER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_GRPC_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_ARMERIA_GRPC_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the HandlerRegistryBuilder integration`DD_TRACE_ARMERIA_GRPC_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_ARMERIA_GRPC_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the HandlerRegistryBuilder integration`DD_TRACE_ARMERIA_GRPC_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ARMERIA_GRPC_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_ARMERIA_GRPC_SERVER_ENABLED` Enables Armeria gRPC Server (HandlerRegistryBuilder) instrumentation {% /collapsible-section %} {% collapsible-section #integration-armeria-jetty %} #### ARMERIA_JETTY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ARMERIA_JETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ARMERIA_JETTY_ENABLED`, `DD_TRACE_INTEGRATION_ARMERIA_JETTY_ENABLED` Enables Armeria JettyService instrumentation (captures the Jetty HttpChannel in the Armeria request context and recycles it when the response completes) {% /collapsible-section %} {% collapsible-section #integration-auth0-jwt %} #### AUTH0_JWT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AUTH0_JWT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AUTH0_JWT_ENABLED`, `DD_INTEGRATION_AUTH0_JWT_ENABLED` Enables Auth0 JWT (JWTParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-avro %} #### AVRO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AVRO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AVRO_ENABLED`, `DD_TRACE_INTEGRATION_AVRO_ENABLED` Enables AVRO instrumentation {% /collapsible-section %} {% collapsible-section #integration-aws-dynamodb %} #### AWS_DYNAMODB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_DYNAMODB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AWS_DYNAMODB_ENABLED`, `DD_INTEGRATION_AWS_DYNAMODB_ENABLED` Enables AWS DynamoDB (DynamoDbClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-aws-lambda %} #### AWS_LAMBDA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_LAMBDA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_AWS_LAMBDA_ENABLED`, `DD_INTEGRATION_AWS_LAMBDA_ENABLED` Enables AWS Lambda (LambdaHandler) instrumentation {% /collapsible-section %} {% collapsible-section #integration-aws-propagation %} #### AWS_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_AWS_PROPAGATION_ENABLED` AWS propagation: when enabled, allows extracting/injecting trace context via the AWS X-Ray trace header (`X-Amzn-Trace-Id`) in addition to Datadog propagation. Default: true. {% /collapsible-section %} {% collapsible-section #integration-aws-s3 %} #### AWS_S3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_S3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AWS_S3_ENABLED`, `DD_TRACE_INTEGRATION_AWS_S3_ENABLED` Enables AWS S3 (S3Client) instrumentation {% /collapsible-section %} {% collapsible-section #integration-aws-sdk %} #### AWS_SDK (2) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AWS_SDK_ANALYTICS_ENABLED` Enables trace analytics for spans produced by AWS SDK request tracing`DD_TRACE_AWS_SDK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AWS_SDK_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by AWS SDK request spans {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-e2e-duration %} #### AWS_SDK_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AWS_SDK_E2E_DURATION_ENABLED` AWS SDK (SQS) messaging: when enabled, records end-to-end duration on SQS message consumer spans (sets `record.e2e_duration_ms`). Default: false. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-legacy-tracing %} #### AWS_SDK_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AWS_SDK_LEGACY_TRACING_ENABLED` AWS SDK instrumentation: enables legacy tracing behavior (affects service naming and span structure). When disabled, the tracer avoids creating extra underlying Netty HTTP client spans for AWS SDK calls. Default: false. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-propagation %} #### AWS_SDK_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_AWS_SDK_PROPAGATION_ENABLED` AWS SDK clients: when enabled, injects trace context using the AWS X-Ray header (`X-Amzn-Trace-Id`) on outgoing AWS SDK HTTP requests. Used together with `DD_TRACE_AWS_PROPAGATION_ENABLED` (disabling either disables AWS propagation). Default: true. {% /collapsible-section %} {% collapsible-section #integration-axis2 %} #### AXIS2 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_AXIS2_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AXIS2_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Axis2 integration`DD_TRACE_AXIS2_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AXIS2_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Axis2 integration`DD_TRACE_AXIS2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_AXIS2_ENABLED`, `DD_INTEGRATION_AXIS2_ENABLED` Enables Axis2 instrumentation {% /collapsible-section %} {% collapsible-section #integration-axway-api %} #### AXWAY_API (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AXWAY_API_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_AXWAY_API_ENABLED`, `DD_TRACE_INTEGRATION_AXWAY_API_ENABLED` Enables Axway API (AxwayHTTPPlugin) instrumentation {% /collapsible-section %} {% collapsible-section #integration-axway-http %} #### AXWAY_HTTP (2) {% icon name="icon-link-wui" /%} `DD_TRACE_AXWAY_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AXWAY_HTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the AxwayHTTPPlugin integration`DD_TRACE_AXWAY_HTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AXWAY_HTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the AxwayHTTPPlugin integration {% /collapsible-section %} {% collapsible-section #integration-azure-functions %} #### AZURE_FUNCTIONS (2) {% icon name="icon-link-wui" /%} `DD_TRACE_AZURE_FUNCTIONS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_AZURE_FUNCTIONS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the AzureFunctions integration`DD_TRACE_AZURE_FUNCTIONS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_AZURE_FUNCTIONS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the AzureFunctions integration {% /collapsible-section %} {% collapsible-section #integration-caffeine %} #### CAFFEINE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CAFFEINE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CAFFEINE_ENABLED`, `DD_TRACE_INTEGRATION_CAFFEINE_ENABLED` Enables Caffeine (BoundedLocalCache) instrumentation {% /collapsible-section %} {% collapsible-section #integration-cassandra %} #### CASSANDRA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_CASSANDRA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_CASSANDRA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Datastax Cassandra driver tracing`DD_TRACE_CASSANDRA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_CASSANDRA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Cassandra driver spans`DD_TRACE_CASSANDRA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_CASSANDRA_ENABLED`, `DD_INTEGRATION_CASSANDRA_ENABLED` Enables Datastax Cassandra driver tracing (captures cluster contact points and wraps sessions so CQL operations are traced with the correct peer information) {% /collapsible-section %} {% collapsible-section #integration-cassandra-keyspace-statement-extraction %} #### CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` By default, the keyspace is extracted only if it is configured during session creation. When set to `true`, the keyspace can also be extracted by examining the metadata in the query results. {% /collapsible-section %} {% collapsible-section #integration-ci-visibility %} #### CI_VISIBILITY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CI_VISIBILITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CI_VISIBILITY_ENABLED`, `DD_TRACE_INTEGRATION_CI_VISIBILITY_ENABLED` Enables CI Visibility test instrumentation (auto-instruments test frameworks and build tools like JUnit 4/5, TestNG, ScalaTest, and Gradle to report test execution and enable test optimization features) {% /collapsible-section %} {% collapsible-section #integration-cics %} #### CICS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_CICS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_CICS_ANALYTICS_ENABLED` Enables analytics for the CICS integration`DD_TRACE_CICS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.61.0` **Aliases**:`DD_CICS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the CICS integration`DD_TRACE_CICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_CICS_ENABLED`, `DD_INTEGRATION_CICS_ENABLED` Enables CICS integration {% /collapsible-section %} {% collapsible-section #integration-classloading %} #### CLASSLOADING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CLASSLOADING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CLASSLOADING_ENABLED`, `DD_TRACE_INTEGRATION_CLASSLOADING_ENABLED` Enables agent classloading helpers (forces class loaders to delegate loading of agent bootstrap packages and widens resource/class lookup for environments like OSGi and JBoss Modules) {% /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-client-ip-resolver %} #### CLIENT_IP_RESOLVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CLIENT_IP_RESOLVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` HTTP server spans: enables resolving and tagging the client IP address (from `Forwarded` / `X-Forwarded-*` headers and/or the peer address) as `http.client_ip`. Used primarily for AppSec. Default: true. {% /collapsible-section %} {% collapsible-section #integration-commons-fileupload %} #### COMMONS_FILEUPLOAD (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COMMONS_FILEUPLOAD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_COMMONS_FILEUPLOAD_ENABLED`, `DD_TRACE_INTEGRATION_COMMONS_FILEUPLOAD_ENABLED` Enables Commons FileUpload (CommonsFileUpload) instrumentation {% /collapsible-section %} {% collapsible-section #integration-commons-http-client %} #### COMMONS_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_COMMONS_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_COMMONS_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Apache Commons HttpClient request tracing`DD_TRACE_COMMONS_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_COMMONS_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Apache Commons HttpClient request spans`DD_TRACE_COMMONS_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_COMMONS_HTTP_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_COMMONS_HTTP_CLIENT_ENABLED` Enables Apache Commons HttpClient tracing (creates spans for `HttpClient.executeMethod`, injects propagation headers, and enables IAST taint tracking on HttpMethodBase when IAST is enabled) {% /collapsible-section %} {% collapsible-section #integration-confluent-schema-registry %} #### CONFLUENT_SCHEMA_REGISTRY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CONFLUENT_SCHEMA_REGISTRY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_TRACE_INTEGRATION_CONFLUENT_SCHEMA_REGISTRY_ENABLED`, `DD_INTEGRATION_CONFLUENT_SCHEMA_REGISTRY_ENABLED` Enables Confluent Schema Registry (ConfluentSchemaRegistry) instrumentation {% /collapsible-section %} {% collapsible-section #integration-consumer-task %} #### CONSUMER_TASK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CONSUMER_TASK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CONSUMER_TASK_ENABLED`, `DD_TRACE_INTEGRATION_CONSUMER_TASK_ENABLED` Enables Consumer Task (ConsumerTask) instrumentation {% /collapsible-section %} {% collapsible-section #integration-couchbase %} #### COUCHBASE (2) {% icon name="icon-link-wui" /%} `DD_TRACE_COUCHBASE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_COUCHBASE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Couchbase Java SDK tracing`DD_TRACE_COUCHBASE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_COUCHBASE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Couchbase Java SDK spans {% /collapsible-section %} {% collapsible-section #integration-couchbase-3 %} #### COUCHBASE_3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COUCHBASE_3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_COUCHBASE_3_ENABLED`, `DD_TRACE_INTEGRATION_COUCHBASE_3_ENABLED` Enables Couchbase Java SDK 3.x tracing (creates spans for Couchbase core `BaseRequest` operations and enriches them with cluster/seed and error context) {% /collapsible-section %} {% collapsible-section #integration-cucumber %} #### CUCUMBER (2) {% icon name="icon-link-wui" /%} `DD_TRACE_CUCUMBER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_CUCUMBER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Cucumber integration`DD_TRACE_CUCUMBER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_CUCUMBER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Cucumber integration {% /collapsible-section %} {% collapsible-section #integration-cucumber-5 %} #### CUCUMBER_5 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_CUCUMBER_5_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_CUCUMBER_5_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Cucumber integration`DD_TRACE_CUCUMBER_5_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_CUCUMBER_5_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Cucumber integration`DD_TRACE_CUCUMBER_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CUCUMBER_5_ENABLED`, `DD_TRACE_INTEGRATION_CUCUMBER_5_ENABLED` Enables Cucumber 5 (Cucumber) instrumentation {% /collapsible-section %} {% collapsible-section #integration-cxf %} #### CXF (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CXF_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_CXF_ENABLED`, `DD_INTEGRATION_CXF_ENABLED` Enables CXF (Invoker) instrumentation {% /collapsible-section %} {% collapsible-section #integration-cxf-invoker %} #### CXF_INVOKER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CXF_INVOKER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_CXF_INVOKER_ENABLED`, `DD_TRACE_INTEGRATION_CXF_INVOKER_ENABLED` Enables CXF Invoker (Invoker) instrumentation {% /collapsible-section %} {% collapsible-section #integration-datanucleus %} #### DATANUCLEUS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_DATANUCLEUS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_DATANUCLEUS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Datanucleus integration`DD_TRACE_DATANUCLEUS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_DATANUCLEUS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Datanucleus integration`DD_TRACE_DATANUCLEUS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_DATANUCLEUS_ENABLED`, `DD_INTEGRATION_DATANUCLEUS_ENABLED` Enables DataNucleus instrumentation {% /collapsible-section %} {% collapsible-section #integration-db2 %} #### DB2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DB2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_DB2_ENABLED`, `DD_INTEGRATION_DB2_ENABLED` Enables DB2 JDBC tracing (instruments DB2 connections and prepared statements so JDBC queries are traced) {% /collapsible-section %} {% collapsible-section #integration-dbcp2 %} #### DBCP2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DBCP2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.56.0` **Aliases**:`DD_INTEGRATION_DBCP2_ENABLED`, `DD_TRACE_INTEGRATION_DBCP2_ENABLED` Enables Apache Commons DBCP2 JDBC pool waiting instrumentation (emits `pool.waiting` spans when the pool blocks while borrowing a connection) {% /collapsible-section %} {% collapsible-section #integration-dbm %} #### DBM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DBM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DBM_ENABLED`, `DD_TRACE_INTEGRATION_DBM_ENABLED` Enables DBM (DBMCompatibleConnection) instrumentation {% /collapsible-section %} {% collapsible-section #integration-dbstatementrule %} #### DBSTATEMENTRULE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DBSTATEMENTRULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `DBStatementRule`: controls whether the tracer applies the db.statement rule (using `db.statement` to influence span naming/resource). Default: true. {% /collapsible-section %} {% collapsible-section #integration-defineclass %} #### DEFINECLASS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DEFINECLASS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DEFINECLASS_ENABLED`, `DD_TRACE_INTEGRATION_DEFINECLASS_ENABLED` Enables DefineClass instrumentation {% /collapsible-section %} {% collapsible-section #integration-directallocation %} #### DIRECTALLOCATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DIRECTALLOCATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DIRECTALLOCATION_ENABLED`, `DD_TRACE_INTEGRATION_DIRECTALLOCATION_ENABLED` Enables profiling hooks for direct memory allocation (direct ByteBuffers and memory-mapped files), used to report direct-allocation events to the Datadog profiler (Java 11+ with JFR) {% /collapsible-section %} {% collapsible-section #integration-do-not-trace-annotation %} #### DO_NOT_TRACE_ANNOTATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DO_NOT_TRACE_ANNOTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DO_NOT_TRACE_ANNOTATION_ENABLED`, `DD_TRACE_INTEGRATION_DO_NOT_TRACE_ANNOTATION_ENABLED` Enables Do-Not-Trace Annotation (DoNotTraceAnnotation) instrumentation {% /collapsible-section %} {% collapsible-section #integration-dropwizard %} #### DROPWIZARD (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DROPWIZARD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DROPWIZARD_ENABLED`, `DD_TRACE_INTEGRATION_DROPWIZARD_ENABLED` Enables Dropwizard (DropwizardView) instrumentation {% /collapsible-section %} {% collapsible-section #integration-dropwizard-view %} #### DROPWIZARD_VIEW (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DROPWIZARD_VIEW_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DROPWIZARD_VIEW_ENABLED`, `DD_TRACE_INTEGRATION_DROPWIZARD_VIEW_ENABLED` Enables Dropwizard View (DropwizardView) instrumentation {% /collapsible-section %} {% collapsible-section #integration-dynamodb %} #### DYNAMODB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DYNAMODB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DYNAMODB_ENABLED`, `DD_TRACE_INTEGRATION_DYNAMODB_ENABLED` Enables DynamoDB (DynamoDbClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch %} #### ELASTICSEARCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.0` **Aliases**:`DD_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Elasticsearch integration. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-body %} #### ELASTICSEARCH_BODY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_BODY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When set to `true`, the body is added to Elasticsearch and OpenSearch spans. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-body-and-params %} #### ELASTICSEARCH_BODY_AND_PARAMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_BODY_AND_PARAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Elasticsearch/OpenSearch REST client instrumentation: when enabled, captures both request body and query parameters as span tags (e.g., `elasticsearch.body` + `elasticsearch.params`). Default: false. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-params %} #### ELASTICSEARCH_PARAMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_PARAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` When set to `true`, the query string parameters are added to Elasticsearch and OpenSearch spans. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-rest %} #### ELASTICSEARCH_REST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_REST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_REST_ENABLED` Enables Elasticsearch REST client tracing (creates spans for RestClient requests and finishes spans via ResponseListener callbacks) {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-rest-5 %} #### ELASTICSEARCH_REST_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_REST_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_5_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_REST_5_ENABLED` Enables Elasticsearch REST 5 (Elasticsearch5RestClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-rest-6 %} #### ELASTICSEARCH_REST_6 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_REST_6_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_6_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_REST_6_ENABLED` Enables Elasticsearch REST 6 (Elasticsearch6RestClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-rest-7 %} #### ELASTICSEARCH_REST_7 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_REST_7_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_7_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_REST_7_ENABLED` Enables Elasticsearch REST 7 (Elasticsearch7RestClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-transport %} #### ELASTICSEARCH_TRANSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_TRANSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_ENABLED` Enables Elasticsearch TransportClient tracing (creates spans for transport actions and propagates context through ThreadedActionListener/ActionListener callbacks) {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-transport-2 %} #### ELASTICSEARCH_TRANSPORT_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_TRANSPORT_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_2_ENABLED`, `DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_2_ENABLED` Enables Elasticsearch Transport 2 (Elasticsearch2TransportClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-transport-5 %} #### ELASTICSEARCH_TRANSPORT_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_TRANSPORT_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_5_ENABLED`, `DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_5_ENABLED` Enables Elasticsearch 5.x TransportClient tracing (creates spans for transport actions and finishes them via ActionListener callbacks) {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-transport-6 %} #### ELASTICSEARCH_TRANSPORT_6 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_TRANSPORT_6_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_6_ENABLED`, `DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_6_ENABLED` Enables Elasticsearch Transport 6 (Elasticsearch6TransportClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-elasticsearch-transport-7 %} #### ELASTICSEARCH_TRANSPORT_7 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_TRANSPORT_7_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_7_ENABLED`, `DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_7_ENABLED` Enables Elasticsearch Transport 7 (Elasticsearch73TransportClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-emr-aws-sdk %} #### EMR_AWS_SDK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EMR_AWS_SDK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_EMR_AWS_SDK_ENABLED`, `DD_INTEGRATION_EMR_AWS_SDK_ENABLED` Enables EMR AWS SDK (EmrSdk) instrumentation {% /collapsible-section %} {% collapsible-section #integration-eventbridge %} #### EVENTBRIDGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EVENTBRIDGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_EVENTBRIDGE_ENABLED`, `DD_INTEGRATION_EVENTBRIDGE_ENABLED` Enables EventBridge (EventBridgeClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-eventbridge-inject-datadog-attribute %} #### EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE_ENABLED` Controls whether or not the "_datadog" attribute, which holds trace context, is injected into eventbridge requests {% /collapsible-section %} {% collapsible-section #integration-ffm-native-tracing %} #### FFM_NATIVE_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FFM_NATIVE_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_FFM_NATIVE_TRACING_ENABLED`, `DD_INTEGRATION_FFM_NATIVE_TRACING_ENABLED` Enables ffm-native-tracing integration {% /collapsible-section %} {% collapsible-section #integration-finatra %} #### FINATRA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_FINATRA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_FINATRA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Finatra integration`DD_TRACE_FINATRA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_FINATRA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Finatra integration`DD_TRACE_FINATRA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_FINATRA_ENABLED`, `DD_INTEGRATION_FINATRA_ENABLED` Enables Finatra instrumentation {% /collapsible-section %} {% collapsible-section #integration-fjp %} #### FJP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FJP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_FJP_ENABLED`, `DD_TRACE_INTEGRATION_FJP_ENABLED` ForkJoinPool instrumentation (`fjp`): enables context propagation for `ForkJoinTask` execution so tracing context flows across ForkJoinPool async tasks. Default: true. {% /collapsible-section %} {% collapsible-section #integration-fjp-workqueue %} #### FJP_WORKQUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FJP_WORKQUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_FJP_WORKQUEUE_ENABLED`, `DD_INTEGRATION_FJP_WORKQUEUE_ENABLED` ForkJoinPool work-queue instrumentation (`fjp-workqueue`): when enabled (and queueing-time profiling is enabled), instruments `ForkJoinPool$WorkQueue` to measure task queueing time. Default: true. {% /collapsible-section %} {% collapsible-section #integration-forcemanualdroptaginterceptor %} #### FORCEMANUALDROPTAGINTERCEPTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FORCEMANUALDROPTAGINTERCEPTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `ForceManualDropTagInterceptor`: when enabled, honors the `manual.drop=true` tag by forcing the trace sampling decision to drop (user drop). Default: true. {% /collapsible-section %} {% collapsible-section #integration-forcesamplingprioritytaginterceptor %} #### FORCESAMPLINGPRIORITYTAGINTERCEPTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FORCESAMPLINGPRIORITYTAGINTERCEPTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `ForceSamplingPriorityTagInterceptor`: when enabled, honors the `sampling.priority` tag and forces the trace sampling decision (keep if >0, drop otherwise). Default: true. {% /collapsible-section %} {% collapsible-section #integration-freemarker %} #### FREEMARKER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FREEMARKER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_FREEMARKER_ENABLED`, `DD_TRACE_INTEGRATION_FREEMARKER_ENABLED` Enables FreeMarker IAST instrumentation (propagates taint through template models and reports XSS sinks when template variables are rendered) {% /collapsible-section %} {% collapsible-section #integration-git-metadata %} #### GIT_METADATA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GIT_METADATA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` When enabled, the tracer attaches Git repository URL and commit SHA tags to root spans, allowing traces to be linked back to the corresponding source code in the Datadog UI. {% /collapsible-section %} {% collapsible-section #integration-glassfish %} #### GLASSFISH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GLASSFISH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GLASSFISH_ENABLED`, `DD_TRACE_INTEGRATION_GLASSFISH_ENABLED` Enables Glassfish instrumentation {% /collapsible-section %} {% collapsible-section #integration-google-http-client %} #### GOOGLE_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GOOGLE_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the GoogleHttpClient integration`DD_TRACE_GOOGLE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GOOGLE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the GoogleHttpClient integration`DD_TRACE_GOOGLE_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GOOGLE_HTTP_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_GOOGLE_HTTP_CLIENT_ENABLED` Enables Google HTTP Client (GoogleHttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-google-pubsub %} #### GOOGLE_PUBSUB (4) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_PUBSUB_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GOOGLE_PUBSUB_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the GooglePubSub integration`DD_TRACE_GOOGLE_PUBSUB_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GOOGLE_PUBSUB_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the GooglePubSub integration`DD_TRACE_GOOGLE_PUBSUB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GOOGLE_PUBSUB_ENABLED`, `DD_TRACE_INTEGRATION_GOOGLE_PUBSUB_ENABLED` Enables Google Pub/Sub (GooglePubSub) instrumentation`DD_TRACE_GOOGLE_PUBSUB_IGNORED_GRPC_METHODS` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `["google.pubsub.v1.Subscriber/ModifyAckDeadline", "google.pubsub.v1.Subscriber/Acknowledge", "google.pubsub.v1.Subscriber/Pull", "google.pubsub.v1.Subscriber/StreamingPull", "google.pubsub.v1.Publisher/Publish"]` Google Pub/Sub: list of gRPC methods to ignore for outbound gRPC instrumentation, to silence Pub/Sub client gRPC calls (defaults include `Subscriber/*` and `Publisher/Publish`). {% /collapsible-section %} {% collapsible-section #integration-google-pubsub-e2e-duration %} #### GOOGLE_PUBSUB_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_PUBSUB_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GOOGLE_PUBSUB_E2E_DURATION_ENABLED` Google Pub/Sub messaging spans: when enabled, begins end-to-end duration tracking on Pub/Sub producer/consumer spans (calls `beginEndToEnd()`), allowing `record.e2e_duration_ms` to be recorded when spans are finished with end-to-end semantics. Default: false. {% /collapsible-section %} {% collapsible-section #integration-google-pubsub-legacy-tracing %} #### GOOGLE_PUBSUB_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_PUBSUB_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_GOOGLE_PUBSUB_LEGACY_TRACING_ENABLED` Google Pub/Sub instrumentation: enables legacy tracing behavior for service naming. When enabled (and inferred services are allowed), uses `google-pubsub` for producer/consumer span service naming; otherwise uses application/service naming. Default: true. {% /collapsible-section %} {% collapsible-section #integration-gradle %} #### GRADLE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRADLE_ENABLED`, `DD_INTEGRATION_GRADLE_ENABLED` Enables Gradle CI Visibility build instrumentation (injects the tracer into the Gradle Daemon, injects the CI Visibility plugin/listener, and wires build/test events for reporting) {% /collapsible-section %} {% collapsible-section #integration-gradle-build-listener %} #### GRADLE_BUILD_LISTENER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_BUILD_LISTENER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRADLE_BUILD_LISTENER_ENABLED`, `DD_INTEGRATION_GRADLE_BUILD_LISTENER_ENABLED` Enables Gradle Build Listener (GradleBuildListener) instrumentation {% /collapsible-section %} {% collapsible-section #integration-gradle-build-scope-services %} #### GRADLE_BUILD_SCOPE_SERVICES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_BUILD_SCOPE_SERVICES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRADLE_BUILD_SCOPE_SERVICES_ENABLED`, `DD_INTEGRATION_GRADLE_BUILD_SCOPE_SERVICES_ENABLED` Enables Gradle BuildScopeServices CI Visibility instrumentation (injects the `CiVisibilityGradleListener` into build-scoped services and suppresses service-scope validation for it on Gradle 8.3+) {% /collapsible-section %} {% collapsible-section #integration-gradle-daemon-jvm-options %} #### GRADLE_DAEMON_JVM_OPTIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_DAEMON_JVM_OPTIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRADLE_DAEMON_JVM_OPTIONS_ENABLED`, `DD_TRACE_INTEGRATION_GRADLE_DAEMON_JVM_OPTIONS_ENABLED` Enables Gradle Daemon JVM Options (GradleLauncher) instrumentation {% /collapsible-section %} {% collapsible-section #integration-gradle-daemon-logging %} #### GRADLE_DAEMON_LOGGING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_DAEMON_LOGGING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRADLE_DAEMON_LOGGING_ENABLED`, `DD_TRACE_INTEGRATION_GRADLE_DAEMON_LOGGING_ENABLED` Enables Gradle Daemon Logging (GradleDaemonLogging) instrumentation {% /collapsible-section %} {% collapsible-section #integration-gradle-plugin-injector %} #### GRADLE_PLUGIN_INJECTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRADLE_PLUGIN_INJECTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRADLE_PLUGIN_INJECTOR_ENABLED`, `DD_TRACE_INTEGRATION_GRADLE_PLUGIN_INJECTOR_ENABLED` Enables Gradle Plugin Injector (GradlePluginInjector) instrumentation {% /collapsible-section %} {% collapsible-section #integration-graphql-java %} #### GRAPHQL_JAVA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_JAVA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GRAPHQL_JAVA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by graphql-java tracing`DD_TRACE_GRAPHQL_JAVA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GRAPHQL_JAVA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by graphql-java spans`DD_TRACE_GRAPHQL_JAVA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRAPHQL_JAVA_ENABLED`, `DD_TRACE_INTEGRATION_GRAPHQL_JAVA_ENABLED` Enables graphql-java tracing (installs Datadog Instrumentation to trace query parsing/validation/execution and wraps data fetchers; unwraps async exceptions for error reporting) {% /collapsible-section %} {% collapsible-section #integration-grizzly %} #### GRIZZLY (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GRIZZLY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GRIZZLY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Grizzly HTTP server request tracing`DD_TRACE_GRIZZLY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GRIZZLY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Grizzly HTTP server spans`DD_TRACE_GRIZZLY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_GRIZZLY_ENABLED`, `DD_INTEGRATION_GRIZZLY_ENABLED` Enables Grizzly HTTP server instrumentation (creates request spans for Grizzly handlers and, when AppSec is enabled, captures request bodies/parameters for security monitoring and blocking) {% /collapsible-section %} {% collapsible-section #integration-grizzly-client %} #### GRIZZLY_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GRIZZLY_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GRIZZLY_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the GrizzlyClient integration`DD_TRACE_GRIZZLY_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GRIZZLY_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the GrizzlyClient integration`DD_TRACE_GRIZZLY_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_GRIZZLY_CLIENT_ENABLED`, `DD_INTEGRATION_GRIZZLY_CLIENT_ENABLED` Enables Grizzly Client (GrizzlyClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-grizzly-filterchain %} #### GRIZZLY_FILTERCHAIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRIZZLY_FILTERCHAIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_GRIZZLY_FILTERCHAIN_ENABLED`, `DD_TRACE_INTEGRATION_GRIZZLY_FILTERCHAIN_ENABLED` Enables Grizzly FilterChain (GrizzlyFilterChain) instrumentation {% /collapsible-section %} {% collapsible-section #integration-grpc %} #### GRPC (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.0` **Aliases**:`DD_GRPC_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the gRPC integration.`DD_TRACE_GRPC_IGNORED_INBOUND_METHODS` {% icon name="icon-link-wui" /%} **Type**: `string` GRPC server: list of gRPC full method names (as returned by `ServerCall.getMethodDescriptor().getFullMethodName()`, e.g. `example.Greeter/IgnoreInbound`) to ignore for inbound/server tracing. Matching RPCs are not traced (the interceptor bypasses span creation for those calls).`DD_TRACE_GRPC_IGNORED_OUTBOUND_METHODS` {% icon name="icon-link-wui" /%} **Type**: `string` GRPC client: list of gRPC full method names (as returned by `MethodDescriptor.getFullMethodName()`) to ignore for outbound/client tracing. Matching RPCs do not create gRPC client spans; when the `google-pubsub` integration is enabled, Pub/Sub gRPC methods are also added to the ignore set. {% /collapsible-section %} {% collapsible-section #integration-grpc-client %} #### GRPC_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GRPC_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by gRPC client tracing`DD_TRACE_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by gRPC client spans`DD_TRACE_GRPC_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRPC_CLIENT_ENABLED`, `DD_INTEGRATION_GRPC_CLIENT_ENABLED` Enables gRPC client tracing (creates spans for outgoing RPCs, injects propagation metadata, and traces client call/stream/message callbacks) {% /collapsible-section %} {% collapsible-section #integration-grpc-message %} #### GRPC_MESSAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_MESSAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRPC_MESSAGE_ENABLED`, `DD_TRACE_INTEGRATION_GRPC_MESSAGE_ENABLED` Enables gRPC Message (GrpcClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-grpc-netty %} #### GRPC_NETTY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_NETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRPC_NETTY_ENABLED`, `DD_INTEGRATION_GRPC_NETTY_ENABLED` Enables gRPC Netty (QueuedCommand) instrumentation {% /collapsible-section %} {% collapsible-section #integration-grpc-server %} #### GRPC_SERVER (4) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_GRPC_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by gRPC server tracing`DD_TRACE_GRPC_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_GRPC_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by gRPC server spans`DD_TRACE_GRPC_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRPC_SERVER_ENABLED`, `DD_INTEGRATION_GRPC_SERVER_ENABLED` Enables gRPC server tracing (installs a tracing ServerInterceptor to create spans for inbound RPCs and optionally records handler code origin)`DD_TRACE_GRPC_SERVER_TRIM_PACKAGE_RESOURCE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` GRPC server resource names: when enabled, the tracer strips the Java package prefix from the gRPC service name when setting span resource names (e.g. `example.Greeter/SayHello` -> `Greeter/SayHello`). When disabled (default), uses the full gRPC method name. {% /collapsible-section %} {% collapsible-section #integration-grpc-server-code-origin %} #### GRPC_SERVER_CODE_ORIGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_SERVER_CODE_ORIGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GRPC_SERVER_CODE_ORIGIN_ENABLED`, `DD_INTEGRATION_GRPC_SERVER_CODE_ORIGIN_ENABLED` GRPC server code origin: when enabled (default true) and not running on GraalVM, adds extra instrumentation (`grpc-server-code-origin`) that captures code-origin metadata for gRPC service implementation methods by calling `DebuggerContext.captureCodeOrigin(...)` during `$MethodHandlers` construction. {% /collapsible-section %} {% collapsible-section #integration-gson %} #### GSON (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GSON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GSON_ENABLED`, `DD_INTEGRATION_GSON_ENABLED` Enables GSON (JsonReader) instrumentation {% /collapsible-section %} {% collapsible-section #integration-guava %} #### GUAVA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GUAVA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_GUAVA_ENABLED`, `DD_INTEGRATION_GUAVA_ENABLED` Enables Guava (ListenableFuture) instrumentation {% /collapsible-section %} {% collapsible-section #integration-hazelcast %} #### HAZELCAST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HAZELCAST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_HAZELCAST_ENABLED`, `DD_INTEGRATION_HAZELCAST_ENABLED` Enables Hazelcast instrumentation {% /collapsible-section %} {% collapsible-section #integration-hazelcast-legacy %} #### HAZELCAST_LEGACY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HAZELCAST_LEGACY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_HAZELCAST_LEGACY_ENABLED`, `DD_INTEGRATION_HAZELCAST_LEGACY_ENABLED` Enables Hazelcast Legacy (HazelcastLegacy) instrumentation {% /collapsible-section %} {% collapsible-section #integration-hazelcast-sdk %} #### HAZELCAST_SDK (2) {% icon name="icon-link-wui" /%} `DD_TRACE_HAZELCAST_SDK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HAZELCAST_SDK_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Hazelcast SDK instrumentation (`hazelcast-sdk` component)`DD_TRACE_HAZELCAST_SDK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_HAZELCAST_SDK_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Hazelcast SDK spans {% /collapsible-section %} {% collapsible-section #integration-header-tags-legacy-parsing %} #### HEADER_TAGS_LEGACY_PARSING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HEADER_TAGS_LEGACY_PARSING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_HEADER_TAGS_LEGACY_PARSING_ENABLED` HTTP header tags: enables legacy `DD_TRACE_HEADER_TAGS` parsing. When true, applies `DD_TRACE_HEADER_TAGS` only to request headers and disables response header tagging; `DD_TRACE_REQUEST_HEADER_TAGS` and `DD_TRACE_RESPONSE_HEADER_TAGS` are ignored (with a warning). Default: false. {% /collapsible-section %} {% collapsible-section #integration-hibernate %} #### HIBERNATE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HIBERNATE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HIBERNATE_ENABLED`, `DD_TRACE_INTEGRATION_HIBERNATE_ENABLED` Enables Hibernate ORM instrumentation (traces session/query/transaction activity and, when IAST is enabled, inspects query strings for SQL injection detection) {% /collapsible-section %} {% collapsible-section #integration-hibernate-core %} #### HIBERNATE_CORE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HIBERNATE_CORE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HIBERNATE_CORE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Hibernate ORM instrumentation`DD_TRACE_HIBERNATE_CORE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_HIBERNATE_CORE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Hibernate ORM spans`DD_TRACE_HIBERNATE_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_HIBERNATE_CORE_ENABLED`, `DD_INTEGRATION_HIBERNATE_CORE_ENABLED` Enables Hibernate ORM core instrumentation (traces session/query/transaction activity and, when IAST is enabled, inspects query strings for SQL injection detection) {% /collapsible-section %} {% collapsible-section #integration-hikari %} #### HIKARI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HIKARI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.56.0` **Aliases**:`DD_INTEGRATION_HIKARI_ENABLED`, `DD_TRACE_INTEGRATION_HIKARI_ENABLED` Enables HikariCP JDBC pool waiting instrumentation (emits `pool.waiting` spans when threads block waiting for a connection, tagged with the pool name) {% /collapsible-section %} {% collapsible-section #integration-httpasyncclient %} #### HTTPASYNCCLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPASYNCCLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HTTPASYNCCLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the ApacheHttpAsyncClient integration`DD_TRACE_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the ApacheHttpAsyncClient integration`DD_TRACE_HTTPASYNCCLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HTTPASYNCCLIENT_ENABLED`, `DD_TRACE_INTEGRATION_HTTPASYNCCLIENT_ENABLED` Enables HttpAsyncClient (ApacheHttpAsyncClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-httpasyncclient4-legacy-tracing %} #### HTTPASYNCCLIENT4_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPASYNCCLIENT4_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HTTPASYNCCLIENT4_LEGACY_TRACING_ENABLED` Apache HttpAsyncClient 4: enables legacy URI handling. When true, builds the request URI by parsing `requestLine.getUri()` directly; when false (default), concatenates `HttpHost.toURI()` with the request line URI. {% /collapsible-section %} {% collapsible-section #integration-httpasyncclient5 %} #### HTTPASYNCCLIENT5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPASYNCCLIENT5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_HTTPASYNCCLIENT5_ENABLED`, `DD_INTEGRATION_HTTPASYNCCLIENT5_ENABLED` Enables HttpAsyncClient5 (ApacheHttpAsyncClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-httpclient %} #### HTTPCLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPCLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` **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` **Since**: `v1.55.0` **Aliases**:`DD_HTTPCLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the httpclient integration.`DD_TRACE_HTTPCLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.55.0` **Aliases**:`DD_INTEGRATION_HTTPCLIENT_ENABLED`, `DD_TRACE_INTEGRATION_HTTPCLIENT_ENABLED` Enables tracing for the httpclient integration. {% /collapsible-section %} {% collapsible-section #integration-httpclient5 %} #### HTTPCLIENT5 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPCLIENT5_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HTTPCLIENT5_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Apache HttpClient 5 request tracing`DD_TRACE_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Apache HttpClient 5 request spans`DD_TRACE_HTTPCLIENT5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_HTTPCLIENT5_ENABLED`, `DD_INTEGRATION_HTTPCLIENT5_ENABLED` Enables Apache HttpClient 5 tracing (creates spans for outbound requests, injects propagation headers, and adds IAST URI taint tracking when IAST is enabled) {% /collapsible-section %} {% collapsible-section #integration-httpcore %} #### HTTPCORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPCORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_HTTPCORE_ENABLED`, `DD_INTEGRATION_HTTPCORE_ENABLED` Enables HttpCore (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-httpcore-5 %} #### HTTPCORE_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPCORE_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HTTPCORE_5_ENABLED`, `DD_TRACE_INTEGRATION_HTTPCORE_5_ENABLED` Enables HttpCore 5 (IastHttpHost) instrumentation {% /collapsible-section %} {% collapsible-section #integration-httpurlconnection %} #### HTTPURLCONNECTION (3) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPURLCONNECTION_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_HTTPURLCONNECTION_ANALYTICS_ENABLED` Enables trace analytics for spans produced by HttpURLConnection request tracing`DD_TRACE_HTTPURLCONNECTION_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_HTTPURLCONNECTION_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by HttpURLConnection request spans`DD_TRACE_HTTPURLCONNECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HTTPURLCONNECTION_ENABLED`, `DD_TRACE_INTEGRATION_HTTPURLCONNECTION_ENABLED` Enables java.net HttpURLConnection tracing (creates spans for outbound requests, injects propagation headers, and records URL.openConnection errors when enabled) {% /collapsible-section %} {% collapsible-section #integration-hystrix %} #### HYSTRIX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HYSTRIX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HYSTRIX_ENABLED`, `DD_TRACE_INTEGRATION_HYSTRIX_ENABLED` Enables Hystrix instrumentation {% /collapsible-section %} {% collapsible-section #integration-iast-resultset %} #### IAST_RESULTSET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_IAST_RESULTSET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_IAST_RESULTSET_ENABLED`, `DD_TRACE_INTEGRATION_IAST_RESULTSET_ENABLED` Enables IAST ResultSet (IastResultSet) instrumentation {% /collapsible-section %} {% collapsible-section #integration-iastinstrumentation %} #### IASTINSTRUMENTATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_IASTINSTRUMENTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_IASTINSTRUMENTATION_ENABLED`, `DD_INTEGRATION_IASTINSTRUMENTATION_ENABLED` Enables IAST Instrumentation (Iast) instrumentation {% /collapsible-section %} {% collapsible-section #integration-ignite %} #### IGNITE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_IGNITE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_IGNITE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Ignite integration`DD_TRACE_IGNITE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_IGNITE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Ignite integration`DD_TRACE_IGNITE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_IGNITE_ENABLED`, `DD_TRACE_INTEGRATION_IGNITE_ENABLED` Enables Ignite instrumentation {% /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**: `v1.55.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-inputstream %} #### INPUTSTREAM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INPUTSTREAM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_INPUTSTREAM_ENABLED`, `DD_TRACE_INTEGRATION_INPUTSTREAM_ENABLED` Enables InputStream instrumentation {% /collapsible-section %} {% collapsible-section #integration-integration-apache-httpasyncclient-matching-shortcut %} #### INTEGRATION_APACHE_HTTPASYNCCLIENT_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_APACHE_HTTPASYNCCLIENT_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_INTEGRATION_APACHE_HTTPASYNCCLIENT_MATCHING_SHORTCUT_ENABLED` Apache HttpAsyncClient integration shortcut matching: when enabled, restricts type matching to known Apache HttpAsyncClient implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-datanucleus-matching-shortcut %} #### INTEGRATION_DATANUCLEUS_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_DATANUCLEUS_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_DATANUCLEUS_MATCHING_SHORTCUT_ENABLED` Datanucleus integration shortcut matching: when enabled, restricts type matching to a known list of `ExecutionContext` implementations; when disabled (default), uses hierarchy matching to instrument any class implementing `org.datanucleus.ExecutionContext`. {% /collapsible-section %} {% collapsible-section #integration-integration-dropwizard-matching-shortcut %} #### INTEGRATION_DROPWIZARD_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_DROPWIZARD_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_DROPWIZARD_MATCHING_SHORTCUT_ENABLED` Dropwizard integration shortcut matching: when enabled (default), restricts type matching to known Dropwizard view renderer implementations; when disabled, uses hierarchy matching to instrument any `io.dropwizard.views.ViewRenderer` implementation. {% /collapsible-section %} {% collapsible-section #integration-integration-grpc-matching-shortcut %} #### INTEGRATION_GRPC_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_GRPC_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_GRPC_MATCHING_SHORTCUT_ENABLED` GRPC integration shortcut matching: when enabled (default), restricts type matching to known `ServerBuilder` implementations; when disabled, uses hierarchy matching to consider other `io.grpc.ServerBuilder` subclasses. {% /collapsible-section %} {% collapsible-section #integration-integration-grpc-server-matching-shortcut %} #### INTEGRATION_GRPC_SERVER_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_GRPC_SERVER_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_INTEGRATION_GRPC_SERVER_MATCHING_SHORTCUT_ENABLED` gRPC Server integration shortcut matching: when enabled, restricts type matching to known gRPC Server implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-hibernate-core-matching-shortcut %} #### INTEGRATION_HIBERNATE_CORE_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HIBERNATE_CORE_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_INTEGRATION_HIBERNATE_CORE_MATCHING_SHORTCUT_ENABLED` Hibernate Core integration shortcut matching: when enabled, restricts type matching to known Hibernate Core implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-hibernate-matching-shortcut %} #### INTEGRATION_HIBERNATE_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HIBERNATE_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_HIBERNATE_MATCHING_SHORTCUT_ENABLED` Hibernate integration shortcut matching: when enabled (default), restricts type matching to a known set of Hibernate types; when disabled, uses hierarchy matching to consider additional Hibernate implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-httpasyncclient-matching-shortcut %} #### INTEGRATION_HTTPASYNCCLIENT_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HTTPASYNCCLIENT_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_HTTPASYNCCLIENT_MATCHING_SHORTCUT_ENABLED` Apache HttpAsyncClient integration shortcut matching: when enabled, restricts type matching to known `HttpAsyncClient` implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-httpasyncclient5-matching-shortcut %} #### INTEGRATION_HTTPASYNCCLIENT5_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HTTPASYNCCLIENT5_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_HTTPASYNCCLIENT5_MATCHING_SHORTCUT_ENABLED` Apache HttpAsyncClient 5 integration shortcut matching: when enabled, restricts type matching to known `HttpAsyncClient` implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-httpclient-matching-shortcut %} #### INTEGRATION_HTTPCLIENT_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HTTPCLIENT_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_HTTPCLIENT_MATCHING_SHORTCUT_ENABLED` Apache HttpClient integration shortcut matching: when enabled, restricts type matching to known HttpClient implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-httpclient5-matching-shortcut %} #### INTEGRATION_HTTPCLIENT5_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_HTTPCLIENT5_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_HTTPCLIENT5_MATCHING_SHORTCUT_ENABLED` Apache HttpClient 5 integration shortcut matching: when enabled, restricts type matching to known HttpClient implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-java-concurrent-matching-shortcut %} #### INTEGRATION_JAVA_CONCURRENT_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_JAVA_CONCURRENT_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_JAVA_CONCURRENT_MATCHING_SHORTCUT_ENABLED` Java_concurrent integration shortcut matching: when enabled, restricts matching of java concurrent instrumentations to known types (for example known `RejectedExecutionHandler` implementations) instead of scanning all implementations; when disabled (default), uses hierarchy matching for broader coverage. {% /collapsible-section %} {% collapsible-section #integration-integration-opentelemetry-experimental-matching-shortcut %} #### INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_MATCHING_SHORTCUT_ENABLED` OpenTelemetry experimental integration shortcut matching: when enabled, restricts type matching to known `OpenTelemetry` implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-opentelemetry-metrics-matching-shortcut %} #### INTEGRATION_OPENTELEMETRY_METRICS_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_OPENTELEMETRY_METRICS_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_INTEGRATION_OPENTELEMETRY_METRICS_MATCHING_SHORTCUT_ENABLED` OpenTelemetry Metrics integration shortcut matching: when enabled, restricts type matching to known OpenTelemetry Metrics implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-integration-rejected-execution-handler-matching-shortcut %} #### INTEGRATION_REJECTED_EXECUTION_HANDLER_MATCHING_SHORTCUT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_INTEGRATION_REJECTED_EXECUTION_HANDLER_MATCHING_SHORTCUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_INTEGRATION_REJECTED_EXECUTION_HANDLER_MATCHING_SHORTCUT_ENABLED` Rejected Execution Handler integration shortcut matching: when enabled, restricts type matching to known Rejected Execution Handler implementations; when disabled (default), uses hierarchy matching to consider other implementations. {% /collapsible-section %} {% collapsible-section #integration-jackson %} #### JACKSON (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_ENABLED`, `DD_INTEGRATION_JACKSON_ENABLED` Enables Jackson JSON parser IAST instrumentation (taints JSON field names and string values returned by Jackson parsers to propagate untrusted input) {% /collapsible-section %} {% collapsible-section #integration-jackson-1 %} #### JACKSON_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JACKSON_1_ENABLED`, `DD_TRACE_INTEGRATION_JACKSON_1_ENABLED` Enables Jackson 1 (org.codehaus.jackson) IAST instrumentation (taints JSON field names and string values returned by `JsonParser`) {% /collapsible-section %} {% collapsible-section #integration-jackson-2 %} #### JACKSON_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_2_ENABLED`, `DD_INTEGRATION_JACKSON_2_ENABLED` Enables Jackson 2 (com.fasterxml.jackson) IAST instrumentation (taints JSON field names and string values returned by `JsonParser`) {% /collapsible-section %} {% collapsible-section #integration-jackson-2-12 %} #### JACKSON_2_12 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_2_12_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JACKSON_2_12_ENABLED`, `DD_TRACE_INTEGRATION_JACKSON_2_12_ENABLED` Enables Jackson 2.12 (JsonParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jackson-2-16 %} #### JACKSON_2_16 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_2_16_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_2_16_ENABLED`, `DD_INTEGRATION_JACKSON_2_16_ENABLED` Enables Jackson 2.16 (JsonParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jackson-2-6 %} #### JACKSON_2_6 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_2_6_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_2_6_ENABLED`, `DD_INTEGRATION_JACKSON_2_6_ENABLED` Enables Jackson 2.6 (JsonParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jackson-2-8 %} #### JACKSON_2_8 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_2_8_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_2_8_ENABLED`, `DD_INTEGRATION_JACKSON_2_8_ENABLED` Enables Jackson 2.8 (JsonParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jackson-core %} #### JACKSON_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACKSON_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JACKSON_CORE_ENABLED`, `DD_INTEGRATION_JACKSON_CORE_ENABLED` Enables Jackson Core (TokenBuffer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jacoco %} #### JACOCO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JACOCO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JACOCO_ENABLED`, `DD_TRACE_INTEGRATION_JACOCO_ENABLED` Enables JaCoCo CI Visibility coverage instrumentation (hooks JaCoCo agent class instrumentation to record per-test line coverage for Datadog CI Visibility) {% /collapsible-section %} {% collapsible-section #integration-jakarta-jms %} #### JAKARTA_JMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_JMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAKARTA_JMS_ENABLED`, `DD_TRACE_INTEGRATION_JAKARTA_JMS_ENABLED` Enables Jakarta JMS (JakartaJms) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jakarta-mail %} #### JAKARTA_MAIL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_MAIL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAKARTA_MAIL_ENABLED`, `DD_INTEGRATION_JAKARTA_MAIL_ENABLED` Enables Jakarta Mail IAST instrumentation (propagates taint into mail parts and reports HTML email-injection sinks when sending messages) {% /collapsible-section %} {% collapsible-section #integration-jakarta-mail-body %} #### JAKARTA_MAIL_BODY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_MAIL_BODY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAKARTA_MAIL_BODY_ENABLED`, `DD_INTEGRATION_JAKARTA_MAIL_BODY_ENABLED` Enables Jakarta Mail Body (JakartaMailPart) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jakarta-mail-transport %} #### JAKARTA_MAIL_TRANSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_MAIL_TRANSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAKARTA_MAIL_TRANSPORT_ENABLED`, `DD_TRACE_INTEGRATION_JAKARTA_MAIL_TRANSPORT_ENABLED` Enables Jakarta Mail Transport (JakartaMail) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jakarta-rs %} #### JAKARTA_RS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_RS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAKARTA_RS_ENABLED`, `DD_INTEGRATION_JAKARTA_RS_ENABLED` Enables Jakarta REST (JAX-RS) instrumentation (traces annotated resource methods and request aborts, finishes spans via `AsyncResponse`, and when AppSec is enabled inspects JSON responses written by `MessageBodyWriter`) {% /collapsible-section %} {% collapsible-section #integration-jakarta-rs-annotations %} #### JAKARTA_RS_ANNOTATIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_RS_ANNOTATIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAKARTA_RS_ANNOTATIONS_ENABLED`, `DD_TRACE_INTEGRATION_JAKARTA_RS_ANNOTATIONS_ENABLED` Enables Jakarta REST annotations tracing (creates `jakarta-rs.request` spans for `@Path`/HTTP-method annotated resource methods and finishes spans via `AsyncResponse.resume/cancel`) {% /collapsible-section %} {% collapsible-section #integration-jakarta-rs-filter %} #### JAKARTA_RS_FILTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_RS_FILTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAKARTA_RS_FILTER_ENABLED`, `DD_INTEGRATION_JAKARTA_RS_FILTER_ENABLED` Enables Jakarta REST request-filter/abort instrumentation (captures aborting `ContainerRequestFilter` classes and creates spans when requests are aborted via `ContainerRequestContext.abortWith`) {% /collapsible-section %} {% collapsible-section #integration-jakarta-websocket %} #### JAKARTA_WEBSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_JAKARTA_WEBSOCKET_ENABLED`, `DD_INTEGRATION_JAKARTA_WEBSOCKET_ENABLED` Enables Jakarta WebSocket (JakartaWebsocket) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jakarta-ws %} #### JAKARTA_WS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTA_WS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAKARTA_WS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the WebService integration`DD_TRACE_JAKARTA_WS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAKARTA_WS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the WebService integration`DD_TRACE_JAKARTA_WS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAKARTA_WS_ENABLED`, `DD_TRACE_INTEGRATION_JAKARTA_WS_ENABLED` Enables Jakarta WS (WebService) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jakartars %} #### JAKARTARS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAKARTARS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAKARTARS_ENABLED`, `DD_TRACE_INTEGRATION_JAKARTARS_ENABLED` Enables Jakarta REST (JAX-RS) tracing (creates `jakarta-rs.request` spans for annotated resource methods, creates abort spans for `ContainerRequestContext.abortWith`, and finishes spans via `AsyncResponse` callbacks) {% /collapsible-section %} {% collapsible-section #integration-java-completablefuture %} #### JAVA_COMPLETABLEFUTURE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_COMPLETABLEFUTURE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_COMPLETABLEFUTURE_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_COMPLETABLEFUTURE_ENABLED` Enables Java CompletableFuture (CompletableFuture) instrumentation {% /collapsible-section %} {% collapsible-section #integration-java-concurrent %} #### JAVA_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_CONCURRENT_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_CONCURRENT_ENABLED` Enables async context propagation and queueing-time profiling helpers across common concurrency/task frameworks (executors, fork/join, CompletableFuture, Akka/Pekko, Scala, and virtual/structured concurrency) {% /collapsible-section %} {% collapsible-section #integration-java-concurrent-other %} #### JAVA_CONCURRENT_OTHER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_CONCURRENT_OTHER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_CONCURRENT_OTHER_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_CONCURRENT_OTHER_ENABLED` Java_concurrent additional executors (`java_concurrent.other`): when enabled, instruments non-standard executor implementations (for example Kotlin CoroutineScheduler and Jetty QueuedThreadPool `dispatch(...)`) for context propagation. Default: true. {% /collapsible-section %} {% collapsible-section #integration-java-http-client %} #### JAVA_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAVA_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Java 11+ `java.net.http.HttpClient` request tracing`DD_TRACE_JAVA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAVA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Java 11+ `java.net.http.HttpClient` request spans`DD_TRACE_JAVA_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_HTTP_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_HTTP_CLIENT_ENABLED` Enables Java 11+ `java.net.http.HttpClient` tracing (creates spans for outbound `send`/`sendAsync` requests and injects propagation headers) {% /collapsible-section %} {% collapsible-section #integration-java-lang %} #### JAVA_LANG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_LANG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_LANG_ENABLED`, `DD_INTEGRATION_JAVA_LANG_ENABLED` Enables java-lang integration {% /collapsible-section %} {% collapsible-section #integration-java-lang-21 %} #### JAVA_LANG_21 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_LANG_21_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_LANG_21_ENABLED`, `DD_INTEGRATION_JAVA_LANG_21_ENABLED` Enables java-lang-21 integration {% /collapsible-section %} {% collapsible-section #integration-java-lang-22 %} #### JAVA_LANG_22 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_LANG_22_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_LANG_22_ENABLED`, `DD_INTEGRATION_JAVA_LANG_22_ENABLED` Enables java-lang-22 integration {% /collapsible-section %} {% collapsible-section #integration-java-lang-appsec %} #### JAVA_LANG_APPSEC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_LANG_APPSEC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_LANG_APPSEC_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_LANG_APPSEC_ENABLED` Enables AppSec command-execution instrumentation for `ProcessImpl.start` and `Runtime.exec` (runs command/shell-injection RASP checks and records subprocess executions as `command_execution` spans) {% /collapsible-section %} {% collapsible-section #integration-java-lang-management %} #### JAVA_LANG_MANAGEMENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_LANG_MANAGEMENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVA_LANG_MANAGEMENT_ENABLED`, `DD_TRACE_INTEGRATION_JAVA_LANG_MANAGEMENT_ENABLED` Enables Java Lang Management (CustomMBeanBuilder) instrumentation {% /collapsible-section %} {% collapsible-section #integration-java-module %} #### JAVA_MODULE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_MODULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_MODULE_ENABLED`, `DD_INTEGRATION_JAVA_MODULE_ENABLED` Enables the java-module instrumentation that centralises JPMS module opening to permit reflective operations needed by some tracer components. {% /collapsible-section %} {% collapsible-section #integration-java-net %} #### JAVA_NET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_NET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_NET_ENABLED`, `DD_INTEGRATION_JAVA_NET_ENABLED` Enables the java-net integration {% /collapsible-section %} {% collapsible-section #integration-java-timer %} #### JAVA_TIMER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVA_TIMER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAVA_TIMER_ENABLED`, `DD_INTEGRATION_JAVA_TIMER_ENABLED` Enables Java Timer (JavaTimer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-javax-mail %} #### JAVAX_MAIL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVAX_MAIL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVAX_MAIL_ENABLED`, `DD_TRACE_INTEGRATION_JAVAX_MAIL_ENABLED` Enables JavaMail (javax.mail) IAST instrumentation (propagates taint into mail parts and reports HTML email-injection sinks when sending messages) {% /collapsible-section %} {% collapsible-section #integration-javax-mail-body %} #### JAVAX_MAIL_BODY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVAX_MAIL_BODY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAVAX_MAIL_BODY_ENABLED`, `DD_TRACE_INTEGRATION_JAVAX_MAIL_BODY_ENABLED` Enables Javax Mail Body (JavaxMailPart) instrumentation {% /collapsible-section %} {% collapsible-section #integration-javax-mail-transport %} #### JAVAX_MAIL_TRANSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVAX_MAIL_TRANSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAVAX_MAIL_TRANSPORT_ENABLED`, `DD_INTEGRATION_JAVAX_MAIL_TRANSPORT_ENABLED` Enables Javax Mail Transport (JavaxMail) instrumentation {% /collapsible-section %} {% collapsible-section #integration-javax-websocket %} #### JAVAX_WEBSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAVAX_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_JAVAX_WEBSOCKET_ENABLED`, `DD_TRACE_INTEGRATION_JAVAX_WEBSOCKET_ENABLED` Javax WebSocket (JSR 356) integration: enables the `javax-websocket` instrumentation, which traces WebSocket events/messages (creates `websocket.*` spans, such as send/receive/close) when active. Default: false. {% /collapsible-section %} {% collapsible-section #integration-jax-rs %} #### JAX_RS (4) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_RS_ADDITIONAL_ANNOTATIONS` {% icon name="icon-link-wui" /%} **Type**: `string` JAX-RS annotations: additional fully-qualified annotation class names to treat as JAX-RS endpoint annotations for the JAX-RS annotation-based instrumentation (added to the default set like `javax.ws.rs.GET`, `javax.ws.rs.POST`, etc.). Default: empty.`DD_TRACE_JAX_RS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAX_RS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JAX-RS instrumentation`DD_TRACE_JAX_RS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAX_RS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JAX-RS spans`DD_TRACE_JAX_RS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAX_RS_ENABLED`, `DD_TRACE_INTEGRATION_JAX_RS_ENABLED` Enables JAX-RS instrumentation (server: creates `jax-rs.request` spans for resource methods and finishes spans via `AsyncResponse`; client: registers tracing filters/features and records connection errors; filter: creates abort spans for `abortWith`; AppSec: inspects JSON responses when enabled) {% /collapsible-section %} {% collapsible-section #integration-jax-rs-annotations %} #### JAX_RS_ANNOTATIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_RS_ANNOTATIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAX_RS_ANNOTATIONS_ENABLED`, `DD_INTEGRATION_JAX_RS_ANNOTATIONS_ENABLED` Enables JAX-RS annotations tracing (creates `jax-rs.request` spans for `@Path`/HTTP-method annotated resource methods and finishes spans via `AsyncResponse.resume/cancel`) {% /collapsible-section %} {% collapsible-section #integration-jax-rs-client %} #### JAX_RS_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_RS_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAX_RS_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JAX-RS client request tracing`DD_TRACE_JAX_RS_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAX_RS_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JAX-RS client spans`DD_TRACE_JAX_RS_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAX_RS_CLIENT_ENABLED`, `DD_INTEGRATION_JAX_RS_CLIENT_ENABLED` Enables JAX-RS client tracing (registers `ClientTracingFeature`/filters on created clients and records connection errors for Jersey/Resteasy clients) {% /collapsible-section %} {% collapsible-section #integration-jax-rs-exception-as-error %} #### JAX_RS_EXCEPTION_AS_ERROR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_RS_EXCEPTION_AS_ERROR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` JAX-RS client exceptions: when enabled, client-side JAX-RS connection/processing exceptions are marked as span errors (`span.error=true`); when disabled, the exception is recorded but the span is not flagged as an error. Default: true. {% /collapsible-section %} {% collapsible-section #integration-jax-rs-filter %} #### JAX_RS_FILTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_RS_FILTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAX_RS_FILTER_ENABLED`, `DD_INTEGRATION_JAX_RS_FILTER_ENABLED` Enables JAX-RS request-filter/abort instrumentation (captures aborting `ContainerRequestFilter` classes and creates spans when requests are aborted via `ContainerRequestContext.abortWith`) {% /collapsible-section %} {% collapsible-section #integration-jax-ws %} #### JAX_WS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JAX_WS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAX_WS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JAX-WS request tracing`DD_TRACE_JAX_WS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAX_WS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JAX-WS request spans`DD_TRACE_JAX_WS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JAX_WS_ENABLED`, `DD_INTEGRATION_JAX_WS_ENABLED` Enables JAX-WS server tracing (creates spans for `@WebService` method invocations and `@WebServiceProvider` provider invocations) {% /collapsible-section %} {% collapsible-section #integration-jaxrs %} #### JAXRS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JAXRS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JAXRS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JAX-RS instrumentation`DD_TRACE_JAXRS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JAXRS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JAX-RS spans`DD_TRACE_JAXRS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JAXRS_ENABLED`, `DD_TRACE_INTEGRATION_JAXRS_ENABLED` Enables JAX-RS instrumentation (server: creates `jax-rs.request` spans for resource methods and finishes spans via `AsyncResponse`; client: registers tracing filters/features and records connection errors; filter: creates abort spans for `abortWith`) {% /collapsible-section %} {% collapsible-section #integration-jboss-logmanager %} #### JBOSS_LOGMANAGER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JBOSS_LOGMANAGER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JBOSS_LOGMANAGER_ENABLED`, `DD_TRACE_INTEGRATION_JBOSS_LOGMANAGER_ENABLED` Enables JBoss LogManager logs injection (attaches active span context to `ExtLogRecord` and populates MDC with `dd.trace_id`/`dd.span_id` when logs injection is enabled) {% /collapsible-section %} {% collapsible-section #integration-jboss-modules %} #### JBOSS_MODULES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JBOSS_MODULES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JBOSS_MODULES_ENABLED`, `DD_TRACE_INTEGRATION_JBOSS_MODULES_ENABLED` Enables JBoss Modules (Module) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jdbc %} #### JDBC (5) {% icon name="icon-link-wui" /%} `DD_TRACE_JDBC_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JDBC_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JDBC database query tracing`DD_TRACE_JDBC_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JDBC_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JDBC database query spans`DD_TRACE_JDBC_CONNECTION_CLASS_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` JDBC tracing: additional fully-qualified `java.sql.Connection` implementation class name to instrument. When set, the tracer instruments that connection type in addition to the built-in known JDBC connection classes; when empty, only the known types are matched. Default: empty.`DD_TRACE_JDBC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JDBC_ENABLED`, `DD_TRACE_INTEGRATION_JDBC_ENABLED` Enables JDBC database client tracing (creates spans for SQL statement executions, captures connection metadata, and can inject trace context into SQL for DB Monitoring)`DD_TRACE_JDBC_PREPARED_STATEMENT_CLASS_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` JDBC tracing: additional fully-qualified `PreparedStatement`/`CallableStatement` implementation class name to instrument. When set, the tracer instruments that statement type in addition to the built-in known JDBC statement classes; when empty, only the known types are matched. Default: empty. {% /collapsible-section %} {% collapsible-section #integration-jdbc-datasource %} #### JDBC_DATASOURCE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JDBC_DATASOURCE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JDBC_DATASOURCE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JDBC `DataSource#getConnection` tracing`DD_TRACE_JDBC_DATASOURCE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JDBC_DATASOURCE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JDBC DataSource connection spans`DD_TRACE_JDBC_DATASOURCE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_JDBC_DATASOURCE_ENABLED`, `DD_INTEGRATION_JDBC_DATASOURCE_ENABLED` Enables JDBC `DataSource#getConnection` tracing (creates `database.connection` spans when a parent span exists and tags connections with pool metadata such as the HikariCP pool name) {% /collapsible-section %} {% collapsible-section #integration-jdbc-resultset %} #### JDBC_RESULTSET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JDBC_RESULTSET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JDBC_RESULTSET_ENABLED`, `DD_TRACE_INTEGRATION_JDBC_RESULTSET_ENABLED` Enables JDBC ResultSet (IastResultSet) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jedis %} #### JEDIS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JEDIS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JEDIS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Jedis integration`DD_TRACE_JEDIS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JEDIS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Jedis integration`DD_TRACE_JEDIS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JEDIS_ENABLED`, `DD_TRACE_INTEGRATION_JEDIS_ENABLED` Enables Jedis instrumentation {% /collapsible-section %} {% collapsible-section #integration-jee-env-entry %} #### JEE_ENV_ENTRY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEE_ENV_ENTRY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JEE_ENV_ENTRY_ENABLED`, `DD_INTEGRATION_JEE_ENV_ENTRY_ENABLED` Enables WildFly JEE env-entry instrumentation used to extract Datadog tags from JNDI env entries under `java:comp/env/datadog/tags/` and attach them to deployment classloaders for span enrichment {% /collapsible-section %} {% collapsible-section #integration-jersey %} #### JERSEY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JERSEY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JERSEY_ENABLED`, `DD_INTEGRATION_JERSEY_ENABLED` Enables Jersey (JAX-RS/Jersey) AppSec/IAST instrumentation (taints request/query/path parameters and decoded forms for IAST, and allows AppSec to inspect request bodies/multipart uploads and block requests) {% /collapsible-section %} {% collapsible-section #integration-jetty %} #### JETTY (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JETTY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JETTY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Jetty server request tracing`DD_TRACE_JETTY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JETTY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Jetty server request spans`DD_TRACE_JETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JETTY_ENABLED`, `DD_INTEGRATION_JETTY_ENABLED` Enables Jetty server tracing (creates request spans for incoming Jetty HTTP traffic and supports AppSec blocking/instrumentation across Jetty server versions) {% /collapsible-section %} {% collapsible-section #integration-jetty-client %} #### JETTY_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JETTY_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JETTY_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Jetty HTTP client request tracing`DD_TRACE_JETTY_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JETTY_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Jetty HTTP client request spans`DD_TRACE_JETTY_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JETTY_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_JETTY_CLIENT_ENABLED` Enables Jetty HTTP client tracing (creates spans for outbound Jetty client requests and injects propagation headers) {% /collapsible-section %} {% collapsible-section #integration-jetty-concurrent %} #### JETTY_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JETTY_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JETTY_CONCURRENT_ENABLED`, `DD_TRACE_INTEGRATION_JETTY_CONCURRENT_ENABLED` Enables Jetty Concurrent (QueuedThreadPool) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jetty-websocket %} #### JETTY_WEBSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JETTY_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_JETTY_WEBSOCKET_ENABLED`, `DD_INTEGRATION_JETTY_WEBSOCKET_ENABLED` Enables Jetty WebSocket tracing (creates spans around Jetty WebSocket frame handling and tracks sender context for websocket sessions when websocket tracing is enabled) {% /collapsible-section %} {% collapsible-section #integration-jms %} #### JMS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JMS messaging tracing`DD_TRACE_JMS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JMS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JMS spans`DD_TRACE_JMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JMS_ENABLED`, `DD_INTEGRATION_JMS_ENABLED` Enables JMS messaging tracing (creates spans for message production/consumption, propagates trace context via message headers/properties, and instruments common JMS frameworks such as Spring JMS and Jakarta JMS) {% /collapsible-section %} {% collapsible-section #integration-jms-1 %} #### JMS_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JMS_1_ENABLED`, `DD_TRACE_INTEGRATION_JMS_1_ENABLED` JMS integration enablement (alias `jms-1`): enables/disables the `jms` instrumentation module (javax.jms producers/consumers, context propagation, etc.). This module is registered with names `jms`, `jms-1`, and `jms-2`, so this key is one of the toggles that can disable it. Default: true. {% /collapsible-section %} {% collapsible-section #integration-jms-2 %} #### JMS_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JMS_2_ENABLED`, `DD_INTEGRATION_JMS_2_ENABLED` JMS integration enablement (alias `jms-2`): enables/disables the `jms` instrumentation module (javax.jms producers/consumers, context propagation, etc.). This module is registered with names `jms`, `jms-1`, and `jms-2`, so this key is one of the toggles that can disable it. Default: true. {% /collapsible-section %} {% collapsible-section #integration-jms-e2e-duration %} #### JMS_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMS_E2E_DURATION_ENABLED` JMS end-to-end duration: when enabled, the tracer begins end-to-end duration tracking on JMS messaging spans (calls `beginEndToEnd()`), allowing `record.e2e_duration_ms` to be computed. Default: false. {% /collapsible-section %} {% collapsible-section #integration-jms-legacy-tracing %} #### JMS_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_JMS_LEGACY_TRACING_ENABLED` JMS legacy tracing: when enabled (and inferred services are allowed), uses legacy service naming behavior for JMS spans (affects the service name chosen for `jms` producer/consumer spans). Default: true. {% /collapsible-section %} {% collapsible-section #integration-jms-propagation %} #### JMS_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_JMS_PROPAGATION_ENABLED` JMS context propagation: when enabled, injects trace context into outgoing JMS messages (and extracts it from incoming messages) so traces can continue across producers/consumers. Default: true. {% /collapsible-section %} {% collapsible-section #integration-jms-time-in-queue %} #### JMS_TIME_IN_QUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMS_TIME_IN_QUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_JMS_TIME_IN_QUEUE_ENABLED` JMS time-in-queue: when enabled (and inferred services are allowed), records time spent in the broker by injecting a production timestamp into messages and creating a `jms.deliver` time-in-queue span that the consumer span can be parented to. Default: true. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-activemq %} #### JMXFETCH_ACTIVEMQ (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_ACTIVEMQ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_ACTIVEMQ_ENABLED` JMXFetch ActiveMQ check: when enabled, allows loading/running the built-in JMXFetch metrics config for `activemq` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-cassandra %} #### JMXFETCH_CASSANDRA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_CASSANDRA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_CASSANDRA_ENABLED` JMXFetch CassandraClient check: when enabled, allows loading/running the built-in JMXFetch metrics config for `CassandraClient` (otherwise it is skipped) {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-confluent-platform %} #### JMXFETCH_CONFLUENT_PLATFORM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_CONFLUENT_PLATFORM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_CONFLUENT_PLATFORM_ENABLED` JMXFetch Confluent Platform check: when enabled, allows loading/running the built-in JMXFetch metrics config for `confluent_platform` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-hazelcast %} #### JMXFETCH_HAZELCAST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_HAZELCAST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_HAZELCAST_ENABLED` JMXFetch Hazelcast check: when enabled, allows loading/running the built-in JMXFetch metrics config for `Hazelcast` (otherwise it is skipped) {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-hive %} #### JMXFETCH_HIVE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_HIVE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_HIVE_ENABLED` JMXFetch Hive check: when enabled, allows loading/running the built-in JMXFetch metrics config for `hive` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-hivemq %} #### JMXFETCH_HIVEMQ (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_HIVEMQ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_HIVEMQ_ENABLED` JMXFetch HiveMQ check: when enabled, allows loading/running the built-in JMXFetch metrics config for `hivemq` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-hudi %} #### JMXFETCH_HUDI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_HUDI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_HUDI_ENABLED` JMXFetch Hudi check: when enabled, allows loading/running the built-in JMXFetch metrics config for `hudi` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-ignite %} #### JMXFETCH_IGNITE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_IGNITE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_IGNITE_ENABLED` JMXFetch Ignite check: when enabled, allows loading/running the built-in JMXFetch metrics config for `Ignite` (otherwise it is skipped) {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-jboss-wildfly %} #### JMXFETCH_JBOSS_WILDFLY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_JBOSS_WILDFLY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_JBOSS_WILDFLY_ENABLED` JMXFetch JBoss/WildFly check: when enabled, allows loading/running the built-in JMXFetch metrics config for `jboss_wildfly` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-kafka %} #### JMXFETCH_KAFKA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_KAFKA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_KAFKA_ENABLED` JMXFetch ConfluentSchemaRegistry check: when enabled, allows loading/running the built-in JMXFetch metrics config for `ConfluentSchemaRegistry` (otherwise it is skipped) {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-kube-apiserver-metrics %} #### JMXFETCH_KUBE_APISERVER_METRICS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_KUBE_APISERVER_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_KUBE_APISERVER_METRICS_ENABLED` JMXFetch Kubernetes API server metrics check: when enabled, allows loading/running the built-in JMXFetch metrics config for `kube_apiserver_metrics` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-presto %} #### JMXFETCH_PRESTO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_PRESTO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_PRESTO_ENABLED` JMXFetch Presto check: when enabled, allows loading/running the built-in JMXFetch metrics config for `presto` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-solr %} #### JMXFETCH_SOLR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_SOLR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_SOLR_ENABLED` JMXFetch Solr check: when enabled, allows loading/running the built-in JMXFetch metrics config for `solr` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-sonarqube %} #### JMXFETCH_SONARQUBE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_SONARQUBE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_SONARQUBE_ENABLED` JMXFetch SonarQube check: when enabled, allows loading/running the built-in JMXFetch metrics config for `sonarqube` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-tomcat %} #### JMXFETCH_TOMCAT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_TOMCAT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_TOMCAT_ENABLED` JMXFetch CommitAction check: when enabled, allows loading/running the built-in JMXFetch metrics config for `CommitAction` (otherwise it is skipped) {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-weblogic %} #### JMXFETCH_WEBLOGIC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_WEBLOGIC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_WEBLOGIC_ENABLED` JMXFetch WebLogic check: when enabled, allows loading/running the built-in JMXFetch metrics config for `weblogic` (otherwise it is skipped). Default: false. {% /collapsible-section %} {% collapsible-section #integration-jmxfetch-websphere %} #### JMXFETCH_WEBSPHERE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JMXFETCH_WEBSPHERE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JMXFETCH_WEBSPHERE_ENABLED` JMXFetch WebSphere check: when enabled, includes the WebSphere JMXFetch config (`jmxfetch-websphere-config.yaml`) when starting JMXFetch. Default: false. {% /collapsible-section %} {% collapsible-section #integration-jni %} #### JNI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JNI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JNI_ENABLED`, `DD_INTEGRATION_JNI_ENABLED` Enables JNI (DirectByteBuffer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jose-jwt %} #### JOSE_JWT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JOSE_JWT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JOSE_JWT_ENABLED`, `DD_TRACE_INTEGRATION_JOSE_JWT_ENABLED` Enables JOSE JWT (JSONObjectUtils) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jsp %} #### JSP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_JSP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_JSP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by JSP rendering spans`DD_TRACE_JSP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_JSP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by JSP render spans`DD_TRACE_JSP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JSP_ENABLED`, `DD_INTEGRATION_JSP_ENABLED` Enables JSP rendering tracing (creates `jsp.render` spans for `_jspService` execution and tags spans with servlet context/path information) {% /collapsible-section %} {% collapsible-section #integration-jsp-compile %} #### JSP_COMPILE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JSP_COMPILE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JSP_COMPILE_ENABLED`, `DD_TRACE_INTEGRATION_JSP_COMPILE_ENABLED` Enables JSP Compile (JasperJSPCompilationContext) instrumentation {% /collapsible-section %} {% collapsible-section #integration-jsp-render %} #### JSP_RENDER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JSP_RENDER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JSP_RENDER_ENABLED`, `DD_TRACE_INTEGRATION_JSP_RENDER_ENABLED` Enables JSP Render (JSP) instrumentation {% /collapsible-section %} {% collapsible-section #integration-junit-38 %} #### JUNIT_38 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_38_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JUNIT_38_ENABLED`, `DD_TRACE_INTEGRATION_JUNIT_38_ENABLED` Enables Junit 38 (JUnitLegacySuiteEvents) instrumentation {% /collapsible-section %} {% collapsible-section #integration-junit-4 %} #### JUNIT_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JUNIT_4_ENABLED`, `DD_INTEGRATION_JUNIT_4_ENABLED` Enables Datadog CI Visibility instrumentation for JUnit 4 (captures test/suite events and spans, supports skipping and test ordering, and integrates with JUnit4 runners such as Cucumber and MUnit) {% /collapsible-section %} {% collapsible-section #integration-junit-4-cucumber %} #### JUNIT_4_CUCUMBER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_4_CUCUMBER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JUNIT_4_CUCUMBER_ENABLED`, `DD_INTEGRATION_JUNIT_4_CUCUMBER_ENABLED` Enables CI Visibility instrumentation for Cucumber executed via the JUnit 4 runner (captures feature/scenario execution and supports skipping when configured) {% /collapsible-section %} {% collapsible-section #integration-junit-4-munit %} #### JUNIT_4_MUNIT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_4_MUNIT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JUNIT_4_MUNIT_ENABLED`, `DD_INTEGRATION_JUNIT_4_MUNIT_ENABLED` Enables CI Visibility instrumentation for MUnit tests executed via the JUnit 4 runner (captures test events and execution spans) {% /collapsible-section %} {% collapsible-section #integration-junit-5 %} #### JUNIT_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JUNIT_5_ENABLED`, `DD_TRACE_INTEGRATION_JUNIT_5_ENABLED` Enables Datadog CI Visibility instrumentation for JUnit 5 (captures test/suite events and spans, supports skipping and test ordering, and integrates with JUnit5 runners such as Cucumber and Spock) {% /collapsible-section %} {% collapsible-section #integration-junit-5-cucumber %} #### JUNIT_5_CUCUMBER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_5_CUCUMBER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JUNIT_5_CUCUMBER_ENABLED`, `DD_TRACE_INTEGRATION_JUNIT_5_CUCUMBER_ENABLED` Enables CI Visibility instrumentation for Cucumber executed via JUnit 5 (captures feature/scenario execution and supports skipping when configured) {% /collapsible-section %} {% collapsible-section #integration-junit-5-spock %} #### JUNIT_5_SPOCK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT_5_SPOCK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_JUNIT_5_SPOCK_ENABLED`, `DD_TRACE_INTEGRATION_JUNIT_5_SPOCK_ENABLED` Enables CI Visibility instrumentation for Spock executed on the JUnit 5 platform (captures spec/feature execution and parameterized runs) {% /collapsible-section %} {% collapsible-section #integration-junit4 %} #### JUNIT4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JUNIT4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JUNIT4_ENABLED`, `DD_INTEGRATION_JUNIT4_ENABLED` Enables CI Visibility instrumentation for JUnit 4 executed via build tools (Gradle test processors and Maven Surefire), including test ordering/fail-fast support {% /collapsible-section %} {% collapsible-section #integration-jwt %} #### JWT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JWT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_JWT_ENABLED`, `DD_INTEGRATION_JWT_ENABLED` Enables JWT IAST instrumentation (taints JWT payload/claims parsed from request header values when using Auth0 JWT or Nimbus JOSE/JWT helpers) {% /collapsible-section %} {% collapsible-section #integration-kafka %} #### KAFKA (2) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.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` **Since**: `v1.55.0` **Aliases**:`DD_INTEGRATION_KAFKA_ENABLED`, `DD_TRACE_INTEGRATION_KAFKA_ENABLED` Enables tracing for the Kafka integration. {% /collapsible-section %} {% collapsible-section #integration-kafka-0-11 %} #### KAFKA_0_11 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_0_11_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_KAFKA_0_11_ENABLED`, `DD_TRACE_INTEGRATION_KAFKA_0_11_ENABLED` Enables Kafka client tracing for Kafka 0.11+ clients (producer/consumer spans with header-based propagation; applies to pre-3.8 clients) {% /collapsible-section %} {% collapsible-section #integration-kafka-3-8 %} #### KAFKA_3_8 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_3_8_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_KAFKA_3_8_ENABLED`, `DD_TRACE_INTEGRATION_KAFKA_3_8_ENABLED` Enables Kafka client tracing for Kafka 3.8+ clients (producer/consumer spans with header-based propagation and updated client internals) {% /collapsible-section %} {% collapsible-section #integration-kafka-client-propagation %} #### KAFKA_CLIENT_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_CLIENT_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_KAFKA_CLIENT_PROPAGATION_ENABLED` Kafka client context propagation: when enabled, injects trace context into Kafka record headers so traces can continue across producers and consumers. This setting is checked together with `DD_TRACE_KAFKA_PROPAGATION_ENABLED` (the tracer evaluates both `kafka` and `kafka.client` propagation toggles). Default: true. {% /collapsible-section %} {% collapsible-section #integration-kafka-connect %} #### KAFKA_CONNECT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_CONNECT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_KAFKA_CONNECT_ENABLED`, `DD_INTEGRATION_KAFKA_CONNECT_ENABLED` Enables Kafka Connect (ConnectWorker) instrumentation {% /collapsible-section %} {% collapsible-section #integration-kafka-e2e-duration %} #### KAFKA_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_KAFKA_E2E_DURATION_ENABLED` Kafka end-to-end duration: when enabled, begins end-to-end duration tracking on Kafka messaging spans (calls `beginEndToEnd()`), allowing `record.e2e_duration_ms` to be recorded when spans are finished with end-to-end semantics. Default: false. {% /collapsible-section %} {% collapsible-section #integration-kafka-legacy-tracing %} #### KAFKA_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_KAFKA_LEGACY_TRACING_ENABLED` Kafka legacy tracing: when enabled (and inferred services are allowed), uses legacy tracing behavior for service naming for Kafka spans; otherwise uses non-legacy naming behavior. Default: true. {% /collapsible-section %} {% collapsible-section #integration-kafka-propagation %} #### KAFKA_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_KAFKA_PROPAGATION_ENABLED` Kafka context propagation: when enabled, injects/extracts trace context in Kafka headers so traces can continue across producers and consumers. This setting is checked together with `DD_TRACE_KAFKA_CLIENT_PROPAGATION_ENABLED` (the tracer evaluates both `kafka` and `kafka.client` propagation toggles). Default: true. {% /collapsible-section %} {% collapsible-section #integration-kafka-streams %} #### KAFKA_STREAMS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_STREAMS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_KAFKA_STREAMS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Kafka Streams tracing`DD_TRACE_KAFKA_STREAMS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_KAFKA_STREAMS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Kafka Streams spans`DD_TRACE_KAFKA_STREAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_KAFKA_STREAMS_ENABLED`, `DD_INTEGRATION_KAFKA_STREAMS_ENABLED` Enables Kafka Streams tracing (creates spans for StreamTask record processing, preserves propagation headers through SourceNodeRecordDeserializer, and updates streaming context from built topologies) {% /collapsible-section %} {% collapsible-section #integration-kafka-streams-e2e-duration %} #### KAFKA_STREAMS_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_STREAMS_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_KAFKA_STREAMS_E2E_DURATION_ENABLED` Kafka Streams end-to-end duration: when enabled, begins end-to-end duration tracking on Kafka Streams spans (uses instrumentation names `kafka` and `kafka-streams`), allowing `record.e2e_duration_ms` to be recorded when spans are finished with end-to-end semantics. Default: false. {% /collapsible-section %} {% collapsible-section #integration-kafka-time-in-queue %} #### KAFKA_TIME_IN_QUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKA_TIME_IN_QUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_KAFKA_TIME_IN_QUEUE_ENABLED` Kafka time-in-queue: when enabled (and inferred services are allowed), records broker time-in-queue by injecting a produce timestamp into record headers and creating a `kafka.deliver` span that consume spans can be parented to. Default: true. {% /collapsible-section %} {% collapsible-section #integration-karate %} #### KARATE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KARATE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_KARATE_ENABLED`, `DD_INTEGRATION_KARATE_ENABLED` Enables Datadog CI Visibility instrumentation for Karate tests (reports suite/feature/scenario results and supports execution policies like test retries and failure suppression) {% /collapsible-section %} {% collapsible-section #integration-kotlin-coroutine %} #### KOTLIN_COROUTINE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KOTLIN_COROUTINE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_KOTLIN_COROUTINE_ENABLED`, `DD_INTEGRATION_KOTLIN_COROUTINE_ENABLED` Enables Kotlin Coroutine (KotlinCoroutines) instrumentation {% /collapsible-section %} {% collapsible-section #integration-legacy-e2e-duration %} #### LEGACY_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LEGACY_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_LEGACY_E2E_DURATION_ENABLED` Legacy end-to-end duration mode: when enabled, the tracer uses the `legacy` E2E mechanism that stores the E2E start time in baggage key `t0`; when disabled, uses the span context end-to-end start time. Default: false. {% /collapsible-section %} {% collapsible-section #integration-lettuce %} #### LETTUCE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_LETTUCE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Lettuce (Redis) client tracing`DD_TRACE_LETTUCE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_LETTUCE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Lettuce (Redis) client spans`DD_TRACE_LETTUCE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LETTUCE_ENABLED`, `DD_TRACE_INTEGRATION_LETTUCE_ENABLED` Enables Lettuce (Redis) client tracing (creates spans for Redis commands and propagates span context through async and reactive command execution) {% /collapsible-section %} {% collapsible-section #integration-lettuce-4 %} #### LETTUCE_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LETTUCE_4_ENABLED`, `DD_INTEGRATION_LETTUCE_4_ENABLED` Enables Lettuce 4 Redis client tracing (traces `RedisClient` connections and async command dispatch in `AbstractRedisAsyncCommands`) {% /collapsible-section %} {% collapsible-section #integration-lettuce-4-async %} #### LETTUCE_4_ASYNC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_4_ASYNC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LETTUCE_4_ASYNC_ENABLED`, `DD_INTEGRATION_LETTUCE_4_ASYNC_ENABLED` Enables Lettuce 4 Async (LettuceAsyncCommands) instrumentation {% /collapsible-section %} {% collapsible-section #integration-lettuce-5 %} #### LETTUCE_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LETTUCE_5_ENABLED`, `DD_INTEGRATION_LETTUCE_5_ENABLED` Enables Lettuce 5 Redis client tracing (traces `RedisClient` connections plus sync/async/reactive command execution) {% /collapsible-section %} {% collapsible-section #integration-lettuce-5-async %} #### LETTUCE_5_ASYNC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_5_ASYNC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LETTUCE_5_ASYNC_ENABLED`, `DD_INTEGRATION_LETTUCE_5_ASYNC_ENABLED` Enables Lettuce 5 async Redis command tracing and context propagation (creates spans on async command dispatch and reactivates them across Netty decode/completion callbacks) {% /collapsible-section %} {% collapsible-section #integration-lettuce-5-rx %} #### LETTUCE_5_RX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LETTUCE_5_RX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LETTUCE_5_RX_ENABLED`, `DD_INTEGRATION_LETTUCE_5_RX_ENABLED` Enables Lettuce 5 Rx (LettuceReactiveClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-liberty %} #### LIBERTY (3) {% icon name="icon-link-wui" /%} `DD_TRACE_LIBERTY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_LIBERTY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Liberty HTTP server tracing`DD_TRACE_LIBERTY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_LIBERTY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Liberty HTTP server spans`DD_TRACE_LIBERTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LIBERTY_ENABLED`, `DD_INTEGRATION_LIBERTY_ENABLED` Enables Open Liberty / WebSphere Liberty HTTP server tracing (creates inbound request spans and finishes them on request completion; when AppSec is enabled, supports request-body processing and blocking) {% /collapsible-section %} {% collapsible-section #integration-liberty-classloading %} #### LIBERTY_CLASSLOADING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LIBERTY_CLASSLOADING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LIBERTY_CLASSLOADING_ENABLED`, `DD_TRACE_INTEGRATION_LIBERTY_CLASSLOADING_ENABLED` Enables Liberty Classloading (ThreadContextClassloader) instrumentation {% /collapsible-section %} {% collapsible-section #integration-log4j %} #### LOG4J (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOG4J_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LOG4J_ENABLED`, `DD_TRACE_INTEGRATION_LOG4J_ENABLED` Enables Log4j logs injection (adds `dd.trace_id`/`dd.span_id` and service/env/version to MDC/ThreadContext for log correlation when enabled) {% /collapsible-section %} {% collapsible-section #integration-log4j-1 %} #### LOG4J_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOG4J_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LOG4J_1_ENABLED`, `DD_TRACE_INTEGRATION_LOG4J_1_ENABLED` Enables Log4j 1.x logs injection (attaches active span context to `LoggingEvent` and populates MDC with `dd.trace_id`/`dd.span_id` and service/env/version when enabled) {% /collapsible-section %} {% collapsible-section #integration-log4j-2 %} #### LOG4J_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOG4J_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LOG4J_2_ENABLED`, `DD_INTEGRATION_LOG4J_2_ENABLED` Enables Log4j 2.x logs injection (updates ThreadContext/ContextDataInjector to add `dd.trace_id`/`dd.span_id` and service/env/version for log correlation when enabled) {% /collapsible-section %} {% collapsible-section #integration-logback %} #### LOGBACK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOGBACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LOGBACK_ENABLED`, `DD_TRACE_INTEGRATION_LOGBACK_ENABLED` Enables Logback logs injection (adds `dd.trace_id`/`dd.span_id` and service/env/version to log event MDC property maps for log correlation when enabled) {% /collapsible-section %} {% collapsible-section #integration-logs-intake %} #### LOGS_INTAKE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOGS_INTAKE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_LOGS_INTAKE_ENABLED`, `DD_TRACE_INTEGRATION_LOGS_INTAKE_ENABLED` Enables logs intake for Logback and Log4j 2 (captures log events and forwards them to `LogsIntake`, including trace/span correlation IDs when available) {% /collapsible-section %} {% collapsible-section #integration-logs-intake-log4j-2 %} #### LOGS_INTAKE_LOG4J_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOGS_INTAKE_LOG4J_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_LOGS_INTAKE_LOG4J_2_ENABLED`, `DD_INTEGRATION_LOGS_INTAKE_LOG4J_2_ENABLED` Enables Logs Intake Log4j 2 (LoggerConfig) instrumentation {% /collapsible-section %} {% collapsible-section #integration-logs-intake-logback %} #### LOGS_INTAKE_LOGBACK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOGS_INTAKE_LOGBACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_TRACE_INTEGRATION_LOGS_INTAKE_LOGBACK_ENABLED`, `DD_INTEGRATION_LOGS_INTAKE_LOGBACK_ENABLED` Setting this config to false disables the logback instrumentation. {% /collapsible-section %} {% collapsible-section #integration-maven %} #### MAVEN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MAVEN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_MAVEN_ENABLED`, `DD_INTEGRATION_MAVEN_ENABLED` Enables Datadog CI Visibility for Maven builds (adds a lifecycle participant/execution listener for build/test reporting and can reorder Surefire JUnit4 tests for fail-fast execution) {% /collapsible-section %} {% collapsible-section #integration-micronaut %} #### MICRONAUT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_MICRONAUT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Micronaut HTTP server tracing`DD_TRACE_MICRONAUT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_MICRONAUT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Micronaut HTTP server spans`DD_TRACE_MICRONAUT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MICRONAUT_ENABLED`, `DD_TRACE_INTEGRATION_MICRONAUT_ENABLED` Enables Micronaut HTTP server (Netty) tracing (creates request spans around routing and response encoding and can capture code origin for annotated handlers) {% /collapsible-section %} {% collapsible-section #integration-micronaut-http-server-netty %} #### MICRONAUT_HTTP_SERVER_NETTY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_HTTP_SERVER_NETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_ENABLED`, `DD_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_ENABLED` Enables Micronaut HTTP Server Netty (Micronaut) instrumentation {% /collapsible-section %} {% collapsible-section #integration-micronaut-http-server-netty-2 %} #### MICRONAUT_HTTP_SERVER_NETTY_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_HTTP_SERVER_NETTY_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_2_ENABLED`, `DD_TRACE_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_2_ENABLED` Enables Micronaut HTTP Server Netty 2 (Micronaut) instrumentation {% /collapsible-section %} {% collapsible-section #integration-micronaut-http-server-netty-3 %} #### MICRONAUT_HTTP_SERVER_NETTY_3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_HTTP_SERVER_NETTY_3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_3_ENABLED`, `DD_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_3_ENABLED` Enables Micronaut HTTP Server Netty 3 (Micronaut) instrumentation {% /collapsible-section %} {% collapsible-section #integration-micronaut-http-server-netty-4 %} #### MICRONAUT_HTTP_SERVER_NETTY_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_HTTP_SERVER_NETTY_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_4_ENABLED`, `DD_INTEGRATION_MICRONAUT_HTTP_SERVER_NETTY_4_ENABLED` Enables Micronaut HTTP Server Netty 4 (Micronaut) instrumentation {% /collapsible-section %} {% collapsible-section #integration-micronaut-span-origin %} #### MICRONAUT_SPAN_ORIGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICRONAUT_SPAN_ORIGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MICRONAUT_SPAN_ORIGIN_ENABLED`, `DD_TRACE_INTEGRATION_MICRONAUT_SPAN_ORIGIN_ENABLED` Enables Micronaut Span Origin (MicronautCodeOrigin) instrumentation {% /collapsible-section %} {% collapsible-section #integration-mmap %} #### MMAP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MMAP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MMAP_ENABLED`, `DD_TRACE_INTEGRATION_MMAP_ENABLED` Enables MMAP (FileChannelImpl) instrumentation {% /collapsible-section %} {% collapsible-section #integration-mongo %} #### MONGO (2) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.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` **Since**: `v1.55.0` **Aliases**:`DD_INTEGRATION_MONGO_ENABLED`, `DD_TRACE_INTEGRATION_MONGO_ENABLED` Enables tracing for the MongoDB integration. {% /collapsible-section %} {% collapsible-section #integration-mongo-3-1 %} #### MONGO_3_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_3_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MONGO_3_1_ENABLED`, `DD_TRACE_INTEGRATION_MONGO_3_1_ENABLED` Enables Mongo 3.1 (MongoClient31) instrumentation {% /collapsible-section %} {% collapsible-section #integration-mongo-3-4 %} #### MONGO_3_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_3_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MONGO_3_4_ENABLED`, `DD_TRACE_INTEGRATION_MONGO_3_4_ENABLED` Enables Mongo 3.4 (MongoClient34) instrumentation {% /collapsible-section %} {% collapsible-section #integration-mongo-3-6 %} #### MONGO_3_6 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_3_6_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_MONGO_3_6_ENABLED`, `DD_INTEGRATION_MONGO_3_6_ENABLED` Enables mongo-3.6 integration {% /collapsible-section %} {% collapsible-section #integration-mongo-3-8 %} #### MONGO_3_8 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_3_8_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_MONGO_3_8_ENABLED`, `DD_INTEGRATION_MONGO_3_8_ENABLED` Enables mongo-3.8 integration {% /collapsible-section %} {% collapsible-section #integration-mongo-reactivestreams %} #### MONGO_REACTIVESTREAMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGO_REACTIVESTREAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MONGO_REACTIVESTREAMS_ENABLED`, `DD_TRACE_INTEGRATION_MONGO_REACTIVESTREAMS_ENABLED` Enables MongoDB reactive-streams context propagation helpers (wraps internal async callbacks so spans stay linked across reactive execution) {% /collapsible-section %} {% collapsible-section #integration-mule %} #### MULE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_MULE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_MULE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Mule tracing`DD_TRACE_MULE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_MULE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Mule spans`DD_TRACE_MULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_MULE_ENABLED`, `DD_TRACE_INTEGRATION_MULE_ENABLED` Enables Mule 4 tracing (wraps Mule's `EventTracer` to create/propagate spans for event processing and activates the event-context span when executing components/operations) {% /collapsible-section %} {% collapsible-section #integration-mule-jpms %} #### MULE_JPMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MULE_JPMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_MULE_JPMS_ENABLED`, `DD_INTEGRATION_MULE_JPMS_ENABLED` Enables MULE JPMS (JpmsMule) instrumentation {% /collapsible-section %} {% collapsible-section #integration-multipart %} #### MULTIPART (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MULTIPART_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_MULTIPART_ENABLED`, `DD_TRACE_INTEGRATION_MULTIPART_ENABLED` Enables servlet multipart IAST instrumentation (taints multipart part names/headers and uploaded content streams to track untrusted input through the application) {% /collapsible-section %} {% collapsible-section #integration-native-image %} #### NATIVE_IMAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NATIVE_IMAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_NATIVE_IMAGE_ENABLED`, `DD_TRACE_INTEGRATION_NATIVE_IMAGE_ENABLED` Native Image (GraalVM) integration: enables the `native-image` module which applies instrumentation and substitutions during native-image builds; it is only active when running in the native-image builder (`Platform.isNativeImageBuilder()`). Default: true. {% /collapsible-section %} {% collapsible-section #integration-netty %} #### NETTY (3) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_NETTY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Netty HTTP client/server tracing`DD_TRACE_NETTY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_NETTY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Netty HTTP client/server spans`DD_TRACE_NETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_NETTY_ENABLED`, `DD_TRACE_INTEGRATION_NETTY_ENABLED` Enables Netty instrumentation for tracing and security (adds HTTP client/server tracing handlers to channel pipelines, propagates context across Netty callbacks/futures—including HTTP/2 streams—and supports AppSec/IAST request-body and ByteBuf taint tracking) {% /collapsible-section %} {% collapsible-section #integration-netty-3-8 %} #### NETTY_3_8 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_3_8_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_NETTY_3_8_ENABLED`, `DD_INTEGRATION_NETTY_3_8_ENABLED` Enables Netty 3.8 HTTP client/server and websocket tracing (wraps pipeline handlers to propagate context and create request spans) {% /collapsible-section %} {% collapsible-section #integration-netty-3-9 %} #### NETTY_3_9 (2) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_3_9_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_NETTY_3_9_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Netty 3.8/3.9 HTTP client/server tracing`DD_TRACE_NETTY_3_9_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_NETTY_3_9_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Netty 3.8/3.9 spans {% /collapsible-section %} {% collapsible-section #integration-netty-4-0 %} #### NETTY_4_0 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_4_0_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_NETTY_4_0_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Netty 4.0 HTTP client/server tracing`DD_TRACE_NETTY_4_0_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_NETTY_4_0_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Netty 4.0 HTTP client/server spans`DD_TRACE_NETTY_4_0_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_NETTY_4_0_ENABLED`, `DD_TRACE_INTEGRATION_NETTY_4_0_ENABLED` Enables Netty 4.0 instrumentation for tracing and security (adds HTTP client/server and websocket tracing handlers to channel pipelines, propagates context across Netty callbacks/futures, and supports IAST ByteBuf taint tracking) {% /collapsible-section %} {% collapsible-section #integration-netty-4-1 %} #### NETTY_4_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_4_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_NETTY_4_1_ENABLED`, `DD_INTEGRATION_NETTY_4_1_ENABLED` Enables Netty 4.1 instrumentation for tracing and security (adds HTTP client/server tracing handlers to channel pipelines, propagates context across Netty callbacks/futures—including HTTP/2 streams—and supports AppSec request-body inspection/blocking for multipart/urlencoded posts) {% /collapsible-section %} {% collapsible-section #integration-netty-4-1-http2 %} #### NETTY_4_1_HTTP2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_4_1_HTTP2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_NETTY_4_1_HTTP2_ENABLED`, `DD_TRACE_INTEGRATION_NETTY_4_1_HTTP2_ENABLED` Enables Netty 4.1 HTTP/2 (Http2MultiplexHandlerStreamChannel) instrumentation {% /collapsible-section %} {% collapsible-section #integration-netty-concurrent %} #### NETTY_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_NETTY_CONCURRENT_ENABLED`, `DD_INTEGRATION_NETTY_CONCURRENT_ENABLED` Enables Netty Concurrent (SingleThreadEventExecutor) instrumentation {% /collapsible-section %} {% collapsible-section #integration-netty-event-executor %} #### NETTY_EVENT_EXECUTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_EVENT_EXECUTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_NETTY_EVENT_EXECUTOR_ENABLED`, `DD_TRACE_INTEGRATION_NETTY_EVENT_EXECUTOR_ENABLED` Enables Netty EventExecutor (SingleThreadEventExecutor) instrumentation {% /collapsible-section %} {% collapsible-section #integration-netty-promise %} #### NETTY_PROMISE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NETTY_PROMISE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_NETTY_PROMISE_ENABLED`, `DD_INTEGRATION_NETTY_PROMISE_ENABLED` Enables Netty Promise (NettyPromise) instrumentation {% /collapsible-section %} {% collapsible-section #integration-new-task-for %} #### NEW_TASK_FOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NEW_TASK_FOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_NEW_TASK_FOR_ENABLED`, `DD_INTEGRATION_NEW_TASK_FOR_ENABLED` Enables NewTaskFor (WrapRunnableAsNewTask) instrumentation {% /collapsible-section %} {% collapsible-section #integration-ning %} #### NING (3) {% icon name="icon-link-wui" /%} `DD_TRACE_NING_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_NING_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the GrizzlyClient integration`DD_TRACE_NING_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_NING_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the GrizzlyClient integration`DD_TRACE_NING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_NING_ENABLED`, `DD_TRACE_INTEGRATION_NING_ENABLED` Enables Ning (GrizzlyClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-not-not-trace %} #### NOT_NOT_TRACE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NOT_NOT_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_NOT_NOT_TRACE_ENABLED`, `DD_INTEGRATION_NOT_NOT_TRACE_ENABLED` Enables Not-Not-Trace (DoNotTraceAnnotation) instrumentation {% /collapsible-section %} {% collapsible-section #integration-ognl %} #### OGNL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OGNL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_OGNL_ENABLED`, `DD_TRACE_INTEGRATION_OGNL_ENABLED` Enables OGNL instrumentation {% /collapsible-section %} {% collapsible-section #integration-okhttp %} #### OKHTTP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_OKHTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OKHTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by OkHttp client request tracing`DD_TRACE_OKHTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_OKHTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by OkHttp client request spans`DD_TRACE_OKHTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OKHTTP_ENABLED`, `DD_INTEGRATION_OKHTTP_ENABLED` Enables OkHttp client tracing (OkHttp 2.x and 3.x): creates spans for outbound requests, injects propagation headers via interceptors, and adds AppSec redirect tracking plus IAST `HttpUrl` taint propagation when enabled {% /collapsible-section %} {% collapsible-section #integration-okhttp-2 %} #### OKHTTP_2 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_OKHTTP_2_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OKHTTP_2_ANALYTICS_ENABLED` Enables trace analytics for spans produced by OkHttp 2.x client request tracing`DD_TRACE_OKHTTP_2_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_OKHTTP_2_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by OkHttp 2.x client request spans`DD_TRACE_OKHTTP_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OKHTTP_2_ENABLED`, `DD_INTEGRATION_OKHTTP_2_ENABLED` Enables OkHttp 2.x client tracing (adds a tracing interceptor to create spans for outbound requests and inject propagation headers; includes AppSec redirect tracking and IAST `HttpUrl` taint propagation when enabled) {% /collapsible-section %} {% collapsible-section #integration-okhttp-3 %} #### OKHTTP_3 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_OKHTTP_3_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OKHTTP_3_ANALYTICS_ENABLED` Enables trace analytics for spans produced by OkHttp 3.x client request tracing`DD_TRACE_OKHTTP_3_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_OKHTTP_3_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by OkHttp 3.x client request spans`DD_TRACE_OKHTTP_3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OKHTTP_3_ENABLED`, `DD_INTEGRATION_OKHTTP_3_ENABLED` Enables OkHttp 3.x client tracing (adds a tracing interceptor to create spans for outbound requests and inject propagation headers; includes AppSec redirect tracking and IAST `HttpUrl` taint propagation when enabled) {% /collapsible-section %} {% collapsible-section #integration-openai-java %} #### OPENAI_JAVA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENAI_JAVA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_OPENAI_JAVA_ANALYTICS_ENABLED` Enables analytics for the openai-java integration`DD_TRACE_OPENAI_JAVA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.61.0` **Aliases**:`DD_OPENAI_JAVA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the openai-java integration`DD_TRACE_OPENAI_JAVA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_OPENAI_JAVA_ENABLED`, `DD_INTEGRATION_OPENAI_JAVA_ENABLED` Enables openai-java integration {% /collapsible-section %} {% collapsible-section #integration-opensearch %} #### OPENSEARCH (2) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` **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` **Since**: `v1.55.0` **Aliases**:`DD_OPENSEARCH_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the OpenSearch integration. {% /collapsible-section %} {% collapsible-section #integration-opensearch-rest %} #### OPENSEARCH_REST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_REST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OPENSEARCH_REST_ENABLED`, `DD_INTEGRATION_OPENSEARCH_REST_ENABLED` Enables OpenSearch REST (OpensearchRestClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-opensearch-transport %} #### OPENSEARCH_TRANSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_TRANSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_OPENSEARCH_TRANSPORT_ENABLED`, `DD_TRACE_INTEGRATION_OPENSEARCH_TRANSPORT_ENABLED` Enables OpenSearch TransportClient tracing (creates spans around transport actions and propagates context through ActionListener/ThreadedActionListener callbacks) {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-1 %} #### OPENTELEMETRY_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_1_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_1_ENABLED` Enables OpenTelemetry API 1.x tracing bridge (replaces OpenTelemetry `TracerProvider` and propagators with the Datadog shim so OpenTelemetry spans/contexts are reported via the Datadog tracer) {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-1-47 %} #### OPENTELEMETRY_1_47 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_1_47_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_1_47_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_1_47_ENABLED` Enables opentelemetry-1.47 integration {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-annotations %} #### OPENTELEMETRY_ANNOTATIONS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_ANNOTATIONS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OPENTELEMETRY_ANNOTATIONS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by OpenTelemetry annotations tracing`DD_TRACE_OPENTELEMETRY_ANNOTATIONS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_OPENTELEMETRY_ANNOTATIONS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by OpenTelemetry annotations spans`DD_TRACE_OPENTELEMETRY_ANNOTATIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_ENABLED` Enables OpenTelemetry annotations tracing (`@WithSpan`, `@SpanAttribute`, `@AddingSpanAttributes`): creates method spans (including async completion handling) and tags spans with annotated parameters {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-annotations-1 %} #### OPENTELEMETRY_ANNOTATIONS_1 (2) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_ANNOTATIONS_1_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_OPENTELEMETRY_ANNOTATIONS_1_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the WithSpanAnnotation integration`DD_TRACE_OPENTELEMETRY_ANNOTATIONS_1_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_OPENTELEMETRY_ANNOTATIONS_1_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the WithSpanAnnotation integration {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-annotations-1-20 %} #### OPENTELEMETRY_ANNOTATIONS_1_20 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_ANNOTATIONS_1_20_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_1_20_ENABLED`, `DD_TRACE_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_1_20_ENABLED` Enables OpenTelemetry Annotations 1.20 (WithSpanAnnotation) instrumentation {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-annotations-1-26 %} #### OPENTELEMETRY_ANNOTATIONS_1_26 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_ANNOTATIONS_1_26_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_1_26_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_ANNOTATIONS_1_26_ENABLED` Enables OpenTelemetry Annotations 1.26 (AddingSpanAttributes) instrumentation {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-beta %} #### OPENTELEMETRY_BETA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_BETA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_BETA_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_BETA_ENABLED` Enables OpenTelemetry Beta (OpenTelemetry) instrumentation {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-experimental %} #### OPENTELEMETRY_EXPERIMENTAL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_EXPERIMENTAL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_ENABLED`, `DD_TRACE_INTEGRATION_OPENTELEMETRY_EXPERIMENTAL_ENABLED` Enables the experimental OpenTelemetry API bridge (Datadog shim for `OpenTelemetry` tracer provider, context storage/root, and propagators) {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-metrics %} #### OPENTELEMETRY_METRICS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_OPENTELEMETRY_METRICS_ENABLED`, `DD_INTEGRATION_OPENTELEMETRY_METRICS_ENABLED` Enables opentelemetry-metrics integration {% /collapsible-section %} {% collapsible-section #integration-opentracing %} #### OPENTRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OPENTRACING_ENABLED`, `DD_INTEGRATION_OPENTRACING_ENABLED` Enables OpenTracing (GlobalTracer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-opentracing-globaltracer %} #### OPENTRACING_GLOBALTRACER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTRACING_GLOBALTRACER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_OPENTRACING_GLOBALTRACER_ENABLED`, `DD_TRACE_INTEGRATION_OPENTRACING_GLOBALTRACER_ENABLED` Enables OpenTracing GlobalTracer (GlobalTracer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-org-json %} #### ORG_JSON (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ORG_JSON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_ORG_JSON_ENABLED`, `DD_TRACE_INTEGRATION_ORG_JSON_ENABLED` Enables org.json IAST propagation (taints `JSONTokener`/`JSONObject`/`JSONArray` created from tainted inputs and propagates taint through accessors and cookie parsing) {% /collapsible-section %} {% collapsible-section #integration-osgi %} #### OSGI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OSGI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_OSGI_ENABLED`, `DD_INTEGRATION_OSGI_ENABLED` Enables OSGi (BundleReference) instrumentation {% /collapsible-section %} {% collapsible-section #integration-peer-hostname %} #### PEER_HOSTNAME (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEER_HOSTNAME_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Peer hostname tagging: when enabled, sets `peer.hostname` on spans when the remote address is resolved; when disabled, `peer.hostname` is not set (peer IP tags may still be set). Default: true. {% /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-peerservicetaginterceptor %} #### PEERSERVICETAGINTERCEPTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEERSERVICETAGINTERCEPTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Tag interceptor rule `PeerServiceTagInterceptor`: when enabled, honors the `peer.service` tag by setting the span service name to that value (and records `peer.service.source=peer.service`). Default: false. {% /collapsible-section %} {% collapsible-section #integration-pekko-actor %} #### PEKKO_ACTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_ACTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_ACTOR_ENABLED`, `DD_INTEGRATION_PEKKO_ACTOR_ENABLED` Enables Pekko actor context propagation (captures active span context into message `Envelope`s and restores/cleans it during ActorCell invocation and mailbox processing) {% /collapsible-section %} {% collapsible-section #integration-pekko-actor-mailbox %} #### PEKKO_ACTOR_MAILBOX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_ACTOR_MAILBOX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_ACTOR_MAILBOX_ENABLED`, `DD_INTEGRATION_PEKKO_ACTOR_MAILBOX_ENABLED` Enables Pekko Actor Mailbox (PekkoMailbox) instrumentation {% /collapsible-section %} {% collapsible-section #integration-pekko-actor-receive %} #### PEKKO_ACTOR_RECEIVE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_ACTOR_RECEIVE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_ACTOR_RECEIVE_ENABLED`, `DD_INTEGRATION_PEKKO_ACTOR_RECEIVE_ENABLED` Enables Pekko Actor Receive (PekkoActorCell) instrumentation {% /collapsible-section %} {% collapsible-section #integration-pekko-actor-send %} #### PEKKO_ACTOR_SEND (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_ACTOR_SEND_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_ACTOR_SEND_ENABLED`, `DD_INTEGRATION_PEKKO_ACTOR_SEND_ENABLED` Enables Pekko actor send context propagation (captures active span context into `Envelope`s and activates it during routed actor send logic when messages are deconstructed) {% /collapsible-section %} {% collapsible-section #integration-pekko-concurrent %} #### PEKKO_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_PEKKO_CONCURRENT_ENABLED`, `DD_TRACE_INTEGRATION_PEKKO_CONCURRENT_ENABLED` Enables Pekko concurrency context propagation (actors, scheduler, and fork/join executor tasks): captures/restores active span context across Pekko async execution boundaries and cleans up leaking scopes {% /collapsible-section %} {% collapsible-section #integration-pekko-http %} #### PEKKO_HTTP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_PEKKO_HTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Pekko HTTP tracing`DD_TRACE_PEKKO_HTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_PEKKO_HTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Pekko HTTP spans`DD_TRACE_PEKKO_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_HTTP_ENABLED`, `DD_INTEGRATION_PEKKO_HTTP_ENABLED` Enables Pekko HTTP tracing (client and server request spans with context propagation across Futures/streams) and, when IAST is enabled, taints request data extracted by directives (params, cookies, forms, headers, URIs) {% /collapsible-section %} {% collapsible-section #integration-pekko-http-client %} #### PEKKO_HTTP_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_HTTP_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_PEKKO_HTTP_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Pekko HTTP client tracing`DD_TRACE_PEKKO_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_PEKKO_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Pekko HTTP client spans`DD_TRACE_PEKKO_HTTP_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_HTTP_CLIENT_ENABLED`, `DD_INTEGRATION_PEKKO_HTTP_CLIENT_ENABLED` Enables Pekko HTTP client tracing (creates spans for `HttpExt.singleRequest`, injects propagation headers, and finishes spans on Future completion; avoids leaking scope into long-lived connection-pool futures) {% /collapsible-section %} {% collapsible-section #integration-pekko-http-server %} #### PEKKO_HTTP_SERVER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_HTTP_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_PEKKO_HTTP_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Pekko HTTP server tracing`DD_TRACE_PEKKO_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_PEKKO_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Pekko HTTP server spans`DD_TRACE_PEKKO_HTTP_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_PEKKO_HTTP_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_PEKKO_HTTP_SERVER_ENABLED` Enables Pekko HTTP server tracing (wraps `bindAndHandle`/`bindAndHandleAsync` handlers—including HTTP/2—to create request spans and finish them when corresponding responses are produced) {% /collapsible-section %} {% collapsible-section #integration-pekko-http2 %} #### PEKKO_HTTP2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_HTTP2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_HTTP2_ENABLED`, `DD_INTEGRATION_PEKKO_HTTP2_ENABLED` Enables Pekko HTTP/2 (PekkoHttp2Server) instrumentation {% /collapsible-section %} {% collapsible-section #integration-pekko-scheduler %} #### PEKKO_SCHEDULER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PEKKO_SCHEDULER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_PEKKO_SCHEDULER_ENABLED`, `DD_INTEGRATION_PEKKO_SCHEDULER_ENABLED` Enables Pekko Scheduler (PekkoScheduler) instrumentation {% /collapsible-section %} {% collapsible-section #integration-perf-metrics %} #### PERF_METRICS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PERF_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Performance metrics: when enabled (and runtime metrics are enabled), turns on tracer performance monitoring (timers/metrics such as trace writing duration). Default: false. {% /collapsible-section %} {% collapsible-section #integration-play %} #### PLAY (4) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_PLAY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by Play Framework request tracing`DD_TRACE_PLAY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_PLAY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by Play request spans`DD_TRACE_PLAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PLAY_ENABLED`, `DD_INTEGRATION_PLAY_ENABLED` Enables Play Framework tracing and AppSec instrumentation (creates request spans around Play `Action.apply` and finishes them on Future completion; when AppSec is enabled, inspects request bodies/params/path patterns and can block requests)`DD_TRACE_PLAY_REPORT_HTTP_STATUS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Play framework: when enabled, sets the HTTP status code to 500 on Play request spans when an exception is thrown (so error spans still have an HTTP status). Default: false. {% /collapsible-section %} {% collapsible-section #integration-play-action %} #### PLAY_ACTION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAY_ACTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PLAY_ACTION_ENABLED`, `DD_INTEGRATION_PLAY_ACTION_ENABLED` Enables Play Action (Play) instrumentation {% /collapsible-section %} {% collapsible-section #integration-play-ws %} #### PLAY_WS (3) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAY_WS_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_PLAY_WS_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the PlayWSClient integration`DD_TRACE_PLAY_WS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_PLAY_WS_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the PlayWSClient integration`DD_TRACE_PLAY_WS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PLAY_WS_ENABLED`, `DD_INTEGRATION_PLAY_WS_ENABLED` Enables Play WS (PlayWSClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-powermock %} #### POWERMOCK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_POWERMOCK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_POWERMOCK_ENABLED`, `DD_INTEGRATION_POWERMOCK_ENABLED` Enables PowerMock (JUnitLegacySuiteEvents) instrumentation {% /collapsible-section %} {% collapsible-section #integration-propagation-style-b3-padding %} #### PROPAGATION_STYLE_B3_PADDING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROPAGATION_STYLE_B3_PADDING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_PROPAGATION_STYLE_B3_PADDING_ENABLED` B3 propagation padding: when enabled, injects B3 trace/span IDs as fixed-width lowercase hex (32 chars for trace IDs, 16 for span IDs). When disabled, injects non-padded 64-bit IDs when possible. Default: true. {% /collapsible-section %} {% collapsible-section #integration-protobuf %} #### PROTOBUF (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROTOBUF_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_PROTOBUF_ENABLED`, `DD_INTEGRATION_PROTOBUF_ENABLED` Enables protobuf schema extraction (attaches protobuf message descriptors to the active span during protobuf serialization/deserialization and records parse/write errors) {% /collapsible-section %} {% collapsible-section #integration-quartz %} #### QUARTZ (3) {% icon name="icon-link-wui" /%} `DD_TRACE_QUARTZ_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_QUARTZ_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the QuartzScheduling integration`DD_TRACE_QUARTZ_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_QUARTZ_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the QuartzScheduling integration`DD_TRACE_QUARTZ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_QUARTZ_ENABLED`, `DD_INTEGRATION_QUARTZ_ENABLED` Enables Quartz (QuartzScheduling) instrumentation {% /collapsible-section %} {% collapsible-section #integration-rabbit-legacy-tracing %} #### RABBIT_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBIT_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBIT_LEGACY_TRACING_ENABLED` Rabbit (RabbitMQ) legacy tracing: when enabled (and inferred services are allowed), uses legacy tracing/service naming behavior for RabbitMQ spans (affects the service name chosen for RabbitMQ messaging spans). Default: true. {% /collapsible-section %} {% collapsible-section #integration-rabbit-propagation %} #### RABBIT_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBIT_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBIT_PROPAGATION_ENABLED` Rabbit (RabbitMQ) context propagation: when enabled, injects and extracts trace context via AMQP message headers so traces can continue across publish/consume. This also gates injecting the tracer's RabbitMQ time-in-queue timestamp header. Default: true. {% /collapsible-section %} {% collapsible-section #integration-rabbit-time-in-queue %} #### RABBIT_TIME_IN_QUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBIT_TIME_IN_QUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBIT_TIME_IN_QUEUE_ENABLED` Rabbit (RabbitMQ) time-in-queue: when enabled (and inferred services are allowed), records broker time by injecting a produced timestamp into AMQP headers and creating an `amqp.deliver` span representing time in the broker; the consumer span is parented to it when the header is present. {% /collapsible-section %} {% collapsible-section #integration-rabbitmq %} #### RABBITMQ (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBITMQ_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RABBITMQ_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the RabbitMQ integration`DD_TRACE_RABBITMQ_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RABBITMQ_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the RabbitMQ integration`DD_TRACE_RABBITMQ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RABBITMQ_ENABLED`, `DD_INTEGRATION_RABBITMQ_ENABLED` Enables RabbitMQ AMQP client tracing (creates spans for Channel commands and message publish/consume/get operations, injects/extracts trace context and Data Streams time-in-queue headers via message properties, and wraps Consumers to propagate context) {% /collapsible-section %} {% collapsible-section #integration-rabbitmq-e2e-duration %} #### RABBITMQ_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBITMQ_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RABBITMQ_E2E_DURATION_ENABLED` RabbitMQ/AMQP end-to-end duration: when enabled for the RabbitMQ instrumentation, begins end-to-end duration tracking on RabbitMQ spans (`beginEndToEnd()`), and consumer spans are finished with end-to-end semantics (`finishWithEndToEnd()`), enabling `record.e2e_duration_ms`. Default: false. {% /collapsible-section %} {% collapsible-section #integration-rabbitmq-legacy-tracing %} #### RABBITMQ_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBITMQ_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBITMQ_LEGACY_TRACING_ENABLED` RabbitMQ legacy tracing: when enabled (and inferred services are allowed), uses legacy tracing/service naming behavior for RabbitMQ spans (affects the service name chosen for RabbitMQ messaging spans). Default: true. {% /collapsible-section %} {% collapsible-section #integration-rabbitmq-propagation %} #### RABBITMQ_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBITMQ_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBITMQ_PROPAGATION_ENABLED` RabbitMQ context propagation: when enabled, injects and extracts trace context via AMQP message headers so traces can continue across publish/consume. This also gates injecting the tracer's RabbitMQ time-in-queue timestamp header. Default: true. {% /collapsible-section %} {% collapsible-section #integration-rabbitmq-time-in-queue %} #### RABBITMQ_TIME_IN_QUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RABBITMQ_TIME_IN_QUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_RABBITMQ_TIME_IN_QUEUE_ENABLED` RabbitMQ time-in-queue: when enabled (and inferred services are allowed), records broker time by injecting a produced timestamp into AMQP headers and creating an `amqp.deliver` span representing time in the broker; the consumer span is parented to it when the header is present. {% /collapsible-section %} {% collapsible-section #integration-ratpack %} #### RATPACK (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RATPACK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RATPACK_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Ratpack integration`DD_TRACE_RATPACK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RATPACK_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Ratpack integration`DD_TRACE_RATPACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RATPACK_ENABLED`, `DD_TRACE_INTEGRATION_RATPACK_ENABLED` Enables Ratpack server tracing (creates `ratpack.handler` request spans with route naming, propagates context across Ratpack executions/continuations, and captures errors); also enables Ratpack AppSec hooks for path binding and request parsing/rendering when AppSec is active {% /collapsible-section %} {% collapsible-section #integration-ratpack-request-body %} #### RATPACK_REQUEST_BODY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RATPACK_REQUEST_BODY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RATPACK_REQUEST_BODY_ENABLED`, `DD_TRACE_INTEGRATION_RATPACK_REQUEST_BODY_ENABLED` Enables Ratpack AppSec request-body collection (wraps `RequestBody.readStream` to capture HTTP body bytes for WAF inspection/blocking and tracks typed-data buffer/text access) {% /collapsible-section %} {% collapsible-section #integration-reactive-streams %} #### REACTIVE_STREAMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACTIVE_STREAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_REACTIVE_STREAMS_ENABLED`, `DD_INTEGRATION_REACTIVE_STREAMS_ENABLED` Enables Reactive Streams context propagation (captures the current span on `Publisher.subscribe` and activates it during downstream `Subscriber` callbacks like `onNext`, `onError`, and `onComplete`) {% /collapsible-section %} {% collapsible-section #integration-reactive-streams-1 %} #### REACTIVE_STREAMS_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACTIVE_STREAMS_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_REACTIVE_STREAMS_1_ENABLED`, `DD_INTEGRATION_REACTIVE_STREAMS_1_ENABLED` Enables Reactive Streams 1.0 context propagation (captures the current span on `Publisher.subscribe` and activates it during downstream `Subscriber` callbacks like `onNext`, `onError`, and `onComplete`) {% /collapsible-section %} {% collapsible-section #integration-reactor-core %} #### REACTOR_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACTOR_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_REACTOR_CORE_ENABLED`, `DD_TRACE_INTEGRATION_REACTOR_CORE_ENABLED` Enables Reactor Core context propagation (extracts the span from Reactor `Context` on subscribe and activates it around `CoreSubscriber` signals and `Mono/Flux.block*` operations) {% /collapsible-section %} {% collapsible-section #integration-reactor-netty %} #### REACTOR_NETTY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACTOR_NETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_REACTOR_NETTY_ENABLED`, `DD_TRACE_INTEGRATION_REACTOR_NETTY_ENABLED` Enables Reactor Netty (HttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-reactor-netty-1 %} #### REACTOR_NETTY_1 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACTOR_NETTY_1_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_REACTOR_NETTY_1_ENABLED`, `DD_INTEGRATION_REACTOR_NETTY_1_ENABLED` Enables Reactor Netty (HttpClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-redis %} #### REDIS (2) {% icon name="icon-link-wui" /%} `DD_TRACE_REDIS_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.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` **Since**: `v1.55.0` **Aliases**:`DD_TRACE_INTEGRATION_REDIS_ENABLED`, `DD_INTEGRATION_REDIS_ENABLED` Enables instrumentation for redis. When disabled, spans for redis operations are not created. {% /collapsible-section %} {% collapsible-section #integration-rediscala %} #### REDISCALA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_REDISCALA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.57.0` **Aliases**:`DD_REDISCALA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Rediscala integration`DD_TRACE_REDISCALA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.55.0` **Aliases**:`DD_REDISCALA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Rediscala integration`DD_TRACE_REDISCALA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_REDISCALA_ENABLED`, `DD_INTEGRATION_REDISCALA_ENABLED` Enables Rediscala client tracing (creates spans for Redis commands sent via Rediscala, finishes spans on `Future` completion, and tags peer/DB info from the underlying Redis client actor connection) {% /collapsible-section %} {% collapsible-section #integration-rediscala-connection %} #### REDISCALA_CONNECTION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REDISCALA_CONNECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_REDISCALA_CONNECTION_ENABLED`, `DD_INTEGRATION_REDISCALA_CONNECTION_ENABLED` Enables Rediscala Connection (RedisClientActor) instrumentation {% /collapsible-section %} {% collapsible-section #integration-redisson %} #### REDISSON (3) {% icon name="icon-link-wui" /%} `DD_TRACE_REDISSON_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_REDISSON_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Redisson integration`DD_TRACE_REDISSON_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_REDISSON_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Redisson integration`DD_TRACE_REDISSON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_REDISSON_ENABLED`, `DD_TRACE_INTEGRATION_REDISSON_ENABLED` Enables Redisson instrumentation {% /collapsible-section %} {% collapsible-section #integration-rejected-execution-handler %} #### REJECTED_EXECUTION_HANDLER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REJECTED_EXECUTION_HANDLER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_REJECTED_EXECUTION_HANDLER_ENABLED`, `DD_TRACE_INTEGRATION_REJECTED_EXECUTION_HANDLER_ENABLED` RejectedExecutionHandler instrumentation: when enabled, instruments rejected task execution to cancel wrapped runnables/continuations when a task is rejected (prevents leaked continuations/scopes; may also record backpressure profiling events). Default: true. {% /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-renaissance %} #### RENAISSANCE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RENAISSANCE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_RENAISSANCE_ENABLED`, `DD_TRACE_INTEGRATION_RENAISSANCE_ENABLED` Enables Renaissance instrumentation {% /collapsible-section %} {% collapsible-section #integration-resilience4j %} #### RESILIENCE4J (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RESILIENCE4J_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_RESILIENCE4J_ANALYTICS_ENABLED` Enables analytics for the Resilience4j integration`DD_TRACE_RESILIENCE4J_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.61.0` **Aliases**:`DD_RESILIENCE4J_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Resilience4j integration`DD_TRACE_RESILIENCE4J_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_TRACE_INTEGRATION_RESILIENCE4J_ENABLED`, `DD_INTEGRATION_RESILIENCE4J_ENABLED` Enables Resilience4j instrumentation {% /collapsible-section %} {% collapsible-section #integration-resilience4j-reactor %} #### RESILIENCE4J_REACTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESILIENCE4J_REACTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_TRACE_INTEGRATION_RESILIENCE4J_REACTOR_ENABLED`, `DD_INTEGRATION_RESILIENCE4J_REACTOR_ENABLED` Enables Resilience4j Reactor (Resilience4jReactor) instrumentation {% /collapsible-section %} {% collapsible-section #integration-resilience4j-retry %} #### RESILIENCE4J_RETRY (2) {% icon name="icon-link-wui" /%} `DD_TRACE_RESILIENCE4J_RETRY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_RESILIENCE4J_RETRY_ANALYTICS_ENABLED` Enables analytics for the Resilience4j Retry integration`DD_TRACE_RESILIENCE4J_RETRY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.61.0` **Aliases**:`DD_RESILIENCE4J_RETRY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Resilience4j Retry integration {% /collapsible-section %} {% collapsible-section #integration-resolver %} #### RESOLVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESOLVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` OpenTracing tracer resolver: when enabled, `DDTracerResolver`/`DDTracerFactory` can create a `DDTracer` via `io.opentracing.contrib.tracerresolver`. When disabled, resolver/factory return null (no auto-created tracer). Default: true. {% /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**: `v1.60.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-resourcenamerule %} #### RESOURCENAMERULE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESOURCENAMERULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `ResourceNameRule`: when enabled, honors the `resource.name` tag by setting the span resource name to that value (tag interceptor). Default: true. {% /collapsible-section %} {% collapsible-section #integration-response %} #### RESPONSE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESPONSE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RESPONSE_ENABLED`, `DD_TRACE_INTEGRATION_RESPONSE_ENABLED` Enables Response (Vertx39HttpServertResponse) instrumentation {% /collapsible-section %} {% collapsible-section #integration-resteasy %} #### RESTEASY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESTEASY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RESTEASY_ENABLED`, `DD_INTEGRATION_RESTEASY_ENABLED` Enables RESTEasy JAX-RS security instrumentation (IAST taints injected params/headers/cookies and tracks response headers/redirects; AppSec inspects processed request bodies—including multipart—and can trigger request blocking) {% /collapsible-section %} {% collapsible-section #integration-restlet-http %} #### RESTLET_HTTP (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RESTLET_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RESTLET_HTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Restlet HTTP integration`DD_TRACE_RESTLET_HTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RESTLET_HTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Restlet HTTP integration`DD_TRACE_RESTLET_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RESTLET_HTTP_ENABLED`, `DD_INTEGRATION_RESTLET_HTTP_ENABLED` Enables Restlet HTTP server tracing (creates request spans around `HttpServerHelper` handling and `ServerResource.doHandle`, captures route templates from `TemplateRoute`, and records HTTP request/response metadata) {% /collapsible-section %} {% collapsible-section #integration-restlet-http-server %} #### RESTLET_HTTP_SERVER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RESTLET_HTTP_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RESTLET_HTTP_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Restlet integration`DD_TRACE_RESTLET_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RESTLET_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Restlet integration`DD_TRACE_RESTLET_HTTP_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RESTLET_HTTP_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_RESTLET_HTTP_SERVER_ENABLED` Enables Restlet HTTP Server (Restlet) instrumentation {% /collapsible-section %} {% collapsible-section #integration-rmi %} #### RMI (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RMI_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Java RMI integration`DD_TRACE_RMI_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RMI_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Java RMI integration`DD_TRACE_RMI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RMI_ENABLED`, `DD_TRACE_INTEGRATION_RMI_ENABLED` Enables Java RMI tracing (creates spans for client `UnicastRef.invoke` calls and server-side `RemoteServer` method handling) and propagates trace context across RMI calls when both sides support it {% /collapsible-section %} {% collapsible-section #integration-rmi-client %} #### RMI_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RMI_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the RmiClient integration`DD_TRACE_RMI_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RMI_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the RmiClient integration`DD_TRACE_RMI_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RMI_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_RMI_CLIENT_ENABLED` Enables RMI Client (RmiClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-rmi-client-context-propagator %} #### RMI_CLIENT_CONTEXT_PROPAGATOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_CLIENT_CONTEXT_PROPAGATOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RMI_CLIENT_CONTEXT_PROPAGATOR_ENABLED`, `DD_TRACE_INTEGRATION_RMI_CLIENT_CONTEXT_PROPAGATOR_ENABLED` Enables RMI Client Context Propagator (RmiClientContext) instrumentation {% /collapsible-section %} {% collapsible-section #integration-rmi-context-propagator %} #### RMI_CONTEXT_PROPAGATOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_CONTEXT_PROPAGATOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RMI_CONTEXT_PROPAGATOR_ENABLED`, `DD_INTEGRATION_RMI_CONTEXT_PROPAGATOR_ENABLED` Enables distributed tracing context propagation for Java RMI (injects trace context into `StreamRemoteCall` connections and installs a server-side context dispatcher so `RMI_REQUEST` spans can be linked to their parent trace) {% /collapsible-section %} {% collapsible-section #integration-rmi-server %} #### RMI_SERVER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_RMI_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the RmiServer integration`DD_TRACE_RMI_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_RMI_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the RmiServer integration`DD_TRACE_RMI_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RMI_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_RMI_SERVER_ENABLED` Enables RMI Server (RmiServer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-rmi-server-context-propagator %} #### RMI_SERVER_CONTEXT_PROPAGATOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RMI_SERVER_CONTEXT_PROPAGATOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RMI_SERVER_CONTEXT_PROPAGATOR_ENABLED`, `DD_INTEGRATION_RMI_SERVER_CONTEXT_PROPAGATOR_ENABLED` Enables RMI Server Context Propagator (RmiServerContext) instrumentation {% /collapsible-section %} {% collapsible-section #integration-runnable %} #### RUNNABLE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RUNNABLE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RUNNABLE_ENABLED`, `DD_INTEGRATION_RUNNABLE_ENABLED` Runnable instrumentation: enables tracing context propagation for `Runnable.run()` by restoring the captured task scope when a runnable executes. This module is registered under integration names `java_concurrent` and `runnable`. Default: true. {% /collapsible-section %} {% collapsible-section #integration-runnable-future %} #### RUNNABLE_FUTURE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RUNNABLE_FUTURE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_RUNNABLE_FUTURE_ENABLED`, `DD_INTEGRATION_RUNNABLE_FUTURE_ENABLED` Enables RunnableFuture instrumentation {% /collapsible-section %} {% collapsible-section #integration-rxjava %} #### RXJAVA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RXJAVA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_RXJAVA_ENABLED`, `DD_TRACE_INTEGRATION_RXJAVA_ENABLED` Enables RxJava 2.x context propagation (captures the active span at reactive type creation/subscription and activates it during observer/subscriber callbacks) {% /collapsible-section %} {% collapsible-section #integration-s3 %} #### S3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_S3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_S3_ENABLED`, `DD_INTEGRATION_S3_ENABLED` Enables S3 (S3Client) instrumentation {% /collapsible-section %} {% collapsible-section #integration-scala-concurrent %} #### SCALA_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALA_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SCALA_CONCURRENT_ENABLED`, `DD_INTEGRATION_SCALA_CONCURRENT_ENABLED` Enables Scala `Future`/`Promise` context propagation (captures the active span when scheduling callbacks/transformations and restores it when they execute, including Scala fork-join pool/task execution) {% /collapsible-section %} {% collapsible-section #integration-scala-future-object %} #### SCALA_FUTURE_OBJECT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALA_FUTURE_OBJECT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SCALA_FUTURE_OBJECT_ENABLED`, `DD_TRACE_INTEGRATION_SCALA_FUTURE_OBJECT_ENABLED` Enables Scala Future (FutureObject) instrumentation {% /collapsible-section %} {% collapsible-section #integration-scala-promise-complete %} #### SCALA_PROMISE_COMPLETE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALA_PROMISE_COMPLETE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SCALA_PROMISE_COMPLETE_ENABLED`, `DD_TRACE_INTEGRATION_SCALA_PROMISE_COMPLETE_ENABLED` Enables Scala Promise (DefaultPromise) instrumentation {% /collapsible-section %} {% collapsible-section #integration-scala-promise-completion-priority %} #### SCALA_PROMISE_COMPLETION_PRIORITY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALA_PROMISE_COMPLETION_PRIORITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_SCALA_PROMISE_COMPLETION_PRIORITY_ENABLED`, `DD_TRACE_INTEGRATION_SCALA_PROMISE_COMPLETION_PRIORITY_ENABLED` Scala Promise completion priority: when enabled, Scala Promise instrumentation prefers the span associated with the promise completion (stored on the resolved `Try`) when capturing context for promise callbacks/transformations, so callbacks run under the completing span's context. Default: false. {% /collapsible-section %} {% collapsible-section #integration-scala-promise-resolve %} #### SCALA_PROMISE_RESOLVE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALA_PROMISE_RESOLVE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SCALA_PROMISE_RESOLVE_ENABLED`, `DD_TRACE_INTEGRATION_SCALA_PROMISE_RESOLVE_ENABLED` Enables Scala Promise (PromiseObject) instrumentation {% /collapsible-section %} {% collapsible-section #integration-scalatest %} #### SCALATEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SCALATEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SCALATEST_ENABLED`, `DD_TRACE_INTEGRATION_SCALATEST_ENABLED` Enables ScalaTest CI Visibility (captures ScalaTest events to create test/suite spans, applies execution policies like retries/skips, and handles SBT forked test runs) {% /collapsible-section %} {% collapsible-section #integration-servelet-response %} #### SERVELET_RESPONSE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVELET_RESPONSE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVELET_RESPONSE_ENABLED`, `DD_INTEGRATION_SERVELET_RESPONSE_ENABLED` Enables Servlet Response (HttpServletResponse) instrumentation {% /collapsible-section %} {% collapsible-section #integration-service-discovery %} #### SERVICE_DISCOVERY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVICE_DISCOVERY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.55.0` Service discovery: when enabled, the tracer can initialize the (Linux-only) service discovery implementation; when disabled, service discovery is not initialized (it is also skipped on non-Linux and on native images). Default: true. {% /collapsible-section %} {% collapsible-section #integration-servicenametaginterceptor %} #### SERVICENAMETAGINTERCEPTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVICENAMETAGINTERCEPTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `ServiceNameTagInterceptor`: when enabled, honors `service.name` (and `service`) tags by setting the span service name to that value and recording it for service discovery. Default: true. {% /collapsible-section %} {% collapsible-section #integration-servicetalk %} #### SERVICETALK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVICETALK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVICETALK_ENABLED`, `DD_TRACE_INTEGRATION_SERVICETALK_ENABLED` Enables ServiceTalk context propagation (captures the active span in ServiceTalk `ContextMap` copies and activates it in `ContextPreserving*` wrappers; installs the Datadog `CapturedContextProvider`) {% /collapsible-section %} {% collapsible-section #integration-servicetalk-concurrent %} #### SERVICETALK_CONCURRENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVICETALK_CONCURRENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVICETALK_CONCURRENT_ENABLED`, `DD_TRACE_INTEGRATION_SERVICETALK_CONCURRENT_ENABLED` Enables ServiceTalk concurrent context propagation (adds the Datadog `CapturedContextProvider` and propagates active spans via ServiceTalk `ContextMap` and `ContextPreserving*` wrappers) {% /collapsible-section %} {% collapsible-section #integration-servlet %} #### SERVLET (5) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Servlet integration`DD_TRACE_SERVLET_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Servlet integration`DD_TRACE_SERVLET_ASYNC_TIMEOUT_ERROR` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` By default, long running asynchronous requests will be marked as an error, setting this value to false allows to mark all timeouts as successful requests.`DD_TRACE_SERVLET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_ENABLED`, `DD_INTEGRATION_SERVLET_ENABLED` Enables Servlet API instrumentation (creates inbound HTTP request spans for Servlet 2.x/3.x and Jakarta Servlet 5, including async dispatch support and AppSec request blocking; when IAST is enabled, taints request inputs (params/headers/cookies/body/multipart) and monitors session usage)`DD_TRACE_SERVLET_ROOT_CONTEXT_SERVICE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `root-servlet` Servlet root context service name: when servlet-context based service naming is applied and the servlet context is `/`, this value is used as the service name instead of an empty name. Default: `root-servlet`. {% /collapsible-section %} {% collapsible-section #integration-servlet-2 %} #### SERVLET_2 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_2_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_2_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Servlet 2.x integration`DD_TRACE_SERVLET_2_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_2_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Servlet 2.x integration`DD_TRACE_SERVLET_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_2_ENABLED`, `DD_INTEGRATION_SERVLET_2_ENABLED` Enables Servlet 2.x request tracing (creates inbound request spans around `HttpServlet.service`/filters, records response status/redirects, and supports AppSec request blocking; when IAST is enabled, activates the Servlet 2 IAST hooks) {% /collapsible-section %} {% collapsible-section #integration-servlet-3 %} #### SERVLET_3 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_3_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_3_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Servlet 3.x integration`DD_TRACE_SERVLET_3_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_3_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Servlet 3.x integration`DD_TRACE_SERVLET_3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_3_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_3_ENABLED` Enables Servlet 3.x request tracing (creates inbound request spans around `HttpServlet.service`/filters, adds async dispatch spans via `AsyncContext.dispatch`, supports AppSec request blocking, and (when enabled) commits RUM-injected responses and runs IAST servlet hooks) {% /collapsible-section %} {% collapsible-section #integration-servlet-3-async-context %} #### SERVLET_3_ASYNC_CONTEXT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_3_ASYNC_CONTEXT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_3_ASYNC_CONTEXT_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_3_ASYNC_CONTEXT_ENABLED` Enables Servlet 3 Async Context (RumAsyncContext) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servlet-5 %} #### SERVLET_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_5_ENABLED`, `DD_INTEGRATION_SERVLET_5_ENABLED` Enables Jakarta Servlet 5 instrumentation for tracing correlation and security (supports RUM request/response wrapping and async commits, enriches active servlet spans with user principal, and enables IAST taint tracking for request/response/multipart plus session URL-rewriting detection) {% /collapsible-section %} {% collapsible-section #integration-servlet-5-async-context %} #### SERVLET_5_ASYNC_CONTEXT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_5_ASYNC_CONTEXT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_5_ASYNC_CONTEXT_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_5_ASYNC_CONTEXT_ENABLED` Enables Servlet 5 Async Context (RumAsyncContext) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servlet-cookie %} #### SERVLET_COOKIE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_COOKIE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_COOKIE_ENABLED`, `DD_INTEGRATION_SERVLET_COOKIE_ENABLED` Enables Servlet Cookie (Cookie) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servlet-dispatcher %} #### SERVLET_DISPATCHER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_DISPATCHER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_DISPATCHER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Servlet dispatcher integration`DD_TRACE_SERVLET_DISPATCHER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_DISPATCHER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Servlet dispatcher integration`DD_TRACE_SERVLET_DISPATCHER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_DISPATCHER_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_DISPATCHER_ENABLED` Enables Servlet `RequestDispatcher` tracing (creates spans for `forward`/`include`/`error`, sets the resource name to the dispatch target, and injects trace context into the request to preserve propagation across dispatches) {% /collapsible-section %} {% collapsible-section #integration-servlet-filter %} #### SERVLET_FILTER (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_FILTER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_FILTER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Filter integration`DD_TRACE_SERVLET_FILTER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_FILTER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Filter integration`DD_TRACE_SERVLET_FILTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_FILTER_ENABLED`, `DD_INTEGRATION_SERVLET_FILTER_ENABLED` Enables Servlet Filter (Filter) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servlet-principal %} #### SERVLET_PRINCIPAL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_PRINCIPAL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When `true`, user principal is collected. Available for versions 0.61+. {% /collapsible-section %} {% collapsible-section #integration-servlet-request %} #### SERVLET_REQUEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_REQUEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_REQUEST_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_REQUEST_ENABLED` Enables Servlet request IAST instrumentation (taints request headers/params/cookies/query/body, tracks unvalidated redirects via `getRequestDispatcher`, and reports session URL-rewriting risks via `getSession` when IAST is enabled) {% /collapsible-section %} {% collapsible-section #integration-servlet-request-body %} #### SERVLET_REQUEST_BODY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_REQUEST_BODY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_REQUEST_BODY_ENABLED`, `DD_INTEGRATION_SERVLET_REQUEST_BODY_ENABLED` Enables Servlet AppSec request-body collection (wraps `HttpServletRequest.getInputStream/getReader` for Servlet 2.x/3.0, Servlet 3.1+, and Jakarta Servlet 5 to capture body bytes/chars and feed AppSec callbacks for WAF inspection/blocking) {% /collapsible-section %} {% collapsible-section #integration-servlet-response %} #### SERVLET_RESPONSE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_RESPONSE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_RESPONSE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Servlet response integration`DD_TRACE_SERVLET_RESPONSE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_RESPONSE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Servlet response integration`DD_TRACE_SERVLET_RESPONSE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_RESPONSE_ENABLED`, `DD_INTEGRATION_SERVLET_RESPONSE_ENABLED` Enables Servlet response instrumentation (creates `servlet.response` spans for `sendError`/`sendRedirect` and, when IAST is enabled, tracks response headers/cookies plus redirect/URL-encoding sinks for vulnerability detection) {% /collapsible-section %} {% collapsible-section #integration-servlet-service %} #### SERVLET_SERVICE (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_SERVICE_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SERVLET_SERVICE_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the HttpServlet integration`DD_TRACE_SERVLET_SERVICE_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SERVLET_SERVICE_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the HttpServlet integration`DD_TRACE_SERVLET_SERVICE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_SERVLET_SERVICE_ENABLED`, `DD_INTEGRATION_SERVLET_SERVICE_ENABLED` Enables Servlet Service (HttpServlet) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servlet-session %} #### SERVLET_SESSION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLET_SESSION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SERVLET_SESSION_ENABLED`, `DD_TRACE_INTEGRATION_SERVLET_SESSION_ENABLED` Enables Servlet Session (HttpSession) instrumentation {% /collapsible-section %} {% collapsible-section #integration-servletcontexttaginterceptor %} #### SERVLETCONTEXTTAGINTERCEPTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SERVLETCONTEXTTAGINTERCEPTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `ServletContextTagInterceptor`: when enabled, allows the servlet context tag to influence service naming (including mapping the root context `/` to `DD_TRACE_SERVLET_ROOT_CONTEXT_SERVICE_NAME`). Default: true. {% /collapsible-section %} {% collapsible-section #integration-setup-teardown %} #### SETUP_TEARDOWN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SETUP_TEARDOWN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SETUP_TEARDOWN_ENABLED`, `DD_TRACE_INTEGRATION_SETUP_TEARDOWN_ENABLED` Enables CI Visibility setup/teardown tracing for JUnit 4 and JUnit 5 (creates spans for `@Before/@After` and `@BeforeEach/@AfterEach` operations via internal runners/extensions) {% /collapsible-section %} {% collapsible-section #integration-sfn %} #### SFN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SFN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SFN_ENABLED`, `DD_TRACE_INTEGRATION_SFN_ENABLED` Enables SFN (SfnClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-sfn-inject-datadog-attribute %} #### SFN_INJECT_DATADOG_ATTRIBUTE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SFN_INJECT_DATADOG_ATTRIBUTE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_SFN_INJECT_DATADOG_ATTRIBUTE_ENABLED` Controls whether or not the "_datadog" attribute, which holds trace context, is injected into SFN inputs {% /collapsible-section %} {% collapsible-section #integration-shutdown %} #### SHUTDOWN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SHUTDOWN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SHUTDOWN_ENABLED`, `DD_INTEGRATION_SHUTDOWN_ENABLED` Enables Shutdown instrumentation {% /collapsible-section %} {% collapsible-section #integration-slick %} #### SLICK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SLICK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SLICK_ENABLED`, `DD_TRACE_INTEGRATION_SLICK_ENABLED` Enables Slick (SlickRunnable) instrumentation {% /collapsible-section %} {% collapsible-section #integration-snakeyaml %} #### SNAKEYAML (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SNAKEYAML_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SNAKEYAML_ENABLED`, `DD_INTEGRATION_SNAKEYAML_ENABLED` Enables SnakeYAML instrumentation {% /collapsible-section %} {% collapsible-section #integration-sns %} #### SNS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SNS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SNS_ENABLED`, `DD_TRACE_INTEGRATION_SNS_ENABLED` Enables SNS (SnsClient) instrumentation {% /collapsible-section %} {% collapsible-section #integration-sns-inject-datadog-attribute %} #### SNS_INJECT_DATADOG_ATTRIBUTE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SNS_INJECT_DATADOG_ATTRIBUTE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_SNS_INJECT_DATADOG_ATTRIBUTE_ENABLED` Controls whether or not the "_datadog" attribute, which holds trace context, is injected into SNS requests {% /collapsible-section %} {% collapsible-section #integration-socket %} #### SOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SOCKET_ENABLED`, `DD_TRACE_INTEGRATION_SOCKET_ENABLED` Enables Socket (SocketConnect) instrumentation {% /collapsible-section %} {% collapsible-section #integration-sofarpc %} #### SOFARPC (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SOFARPC_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.62.0` **Aliases**:`DD_SOFARPC_ANALYTICS_ENABLED` Enables App Analytics (trace search and analytics) for SOFA RPC spans`DD_TRACE_SOFARPC_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.62.0` **Aliases**:`DD_SOFARPC_ANALYTICS_SAMPLE_RATE` Sets the App Analytics sample rate for SOFA RPC spans`DD_TRACE_SOFARPC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_TRACE_INTEGRATION_SOFARPC_ENABLED`, `DD_INTEGRATION_SOFARPC_ENABLED` Enables automatic tracing for SOFA RPC client and server calls {% /collapsible-section %} {% collapsible-section #integration-spark %} #### SPARK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_SPARK_ENABLED`, `DD_INTEGRATION_SPARK_ENABLED` Enables Apache Spark tracing for data jobs (injects the Datadog Spark listener into `SparkContext`/`LiveListenerBus`, captures application lifecycle for job execution, and can enrich Spark SQL plans / integrate with OpenLineage when enabled) {% /collapsible-section %} {% collapsible-section #integration-spark-executor %} #### SPARK_EXECUTOR (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARK_EXECUTOR_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPARK_EXECUTOR_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the SparkExecutor integration`DD_TRACE_SPARK_EXECUTOR_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPARK_EXECUTOR_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the SparkExecutor integration`DD_TRACE_SPARK_EXECUTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_SPARK_EXECUTOR_ENABLED`, `DD_INTEGRATION_SPARK_EXECUTOR_ENABLED` Enables Spark Executor (SparkExecutor) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spark-exit %} #### SPARK_EXIT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARK_EXIT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_SPARK_EXIT_ENABLED`, `DD_TRACE_INTEGRATION_SPARK_EXIT_ENABLED` Enables Spark Exit (SparkExit) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spark-launcher %} #### SPARK_LAUNCHER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARK_LAUNCHER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_SPARK_LAUNCHER_ENABLED`, `DD_INTEGRATION_SPARK_LAUNCHER_ENABLED` Enables spark-launcher integration {% /collapsible-section %} {% collapsible-section #integration-spark-openlineage %} #### SPARK_OPENLINEAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARK_OPENLINEAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_SPARK_OPENLINEAGE_ENABLED`, `DD_TRACE_INTEGRATION_SPARK_OPENLINEAGE_ENABLED` Enables Spark OpenLineage (OpenLineage) instrumentation {% /collapsible-section %} {% collapsible-section #integration-sparkjava %} #### SPARKJAVA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARKJAVA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_SPARKJAVA_ENABLED`, `DD_TRACE_INTEGRATION_SPARKJAVA_ENABLED` Enables SparkJava (Routes) instrumentation {% /collapsible-section %} {% collapsible-section #integration-sparkjava-2-4 %} #### SPARKJAVA_2_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPARKJAVA_2_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_SPARKJAVA_2_4_ENABLED`, `DD_TRACE_INTEGRATION_SPARKJAVA_2_4_ENABLED` Enables SparkJava 2.4 (Routes) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spray %} #### SPRAY (2) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRAY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRAY_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the SprayHttpServer integration`DD_TRACE_SPRAY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRAY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the SprayHttpServer integration {% /collapsible-section %} {% collapsible-section #integration-spray-http %} #### SPRAY_HTTP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRAY_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRAY_HTTP_ENABLED`, `DD_INTEGRATION_SPRAY_HTTP_ENABLED` Enables Spray HTTP (SprayHttpServer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spray-http-server %} #### SPRAY_HTTP_SERVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRAY_HTTP_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRAY_HTTP_SERVER_ENABLED`, `DD_TRACE_INTEGRATION_SPRAY_HTTP_SERVER_ENABLED` Enables Spray HTTP Server (SprayHttpServer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-async %} #### SPRING_ASYNC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_ASYNC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_ASYNC_ENABLED`, `DD_INTEGRATION_SPRING_ASYNC_ENABLED` Enables Spring Async (SpringAsync) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-beans %} #### SPRING_BEANS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_BEANS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_BEANS_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_BEANS_ENABLED` Enables Spring Beans (BeanFactory) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-boot %} #### SPRING_BOOT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_BOOT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_BOOT_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_BOOT_ENABLED` Enables Spring Boot startup instrumentation (sets the tracer service name from `spring.application.name` when not user-set, adds Spring Boot process tags, and detects WAR deployments via `SpringBootServletInitializer`) {% /collapsible-section %} {% collapsible-section #integration-spring-boot-span-origin %} #### SPRING_BOOT_SPAN_ORIGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_BOOT_SPAN_ORIGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_BOOT_SPAN_ORIGIN_ENABLED`, `DD_INTEGRATION_SPRING_BOOT_SPAN_ORIGIN_ENABLED` Enables Spring Boot Span Origin (SBCodeOrigin) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-cloud-zuul %} #### SPRING_CLOUD_ZUUL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_CLOUD_ZUUL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_CLOUD_ZUUL_ENABLED`, `DD_INTEGRATION_SPRING_CLOUD_ZUUL_ENABLED` Enables Spring Cloud Zuul proxy instrumentation (prevents forwarded requests from overwriting Datadog propagation headers and updates the inbound span route/resource name with the downstream Spring controller pattern after forwarding) {% /collapsible-section %} {% collapsible-section #integration-spring-core %} #### SPRING_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_CORE_ENABLED`, `DD_INTEGRATION_SPRING_CORE_ENABLED` Enables Spring Core (StreamUtils) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-data %} #### SPRING_DATA (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_DATA_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_DATA_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the SpringRepository integration`DD_TRACE_SPRING_DATA_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_DATA_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the SpringRepository integration`DD_TRACE_SPRING_DATA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_DATA_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_DATA_ENABLED` Enables Spring Data (SpringRepository) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-jms %} #### SPRING_JMS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_JMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_JMS_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_JMS_ENABLED` Enables Spring JMS (AbstractPollingMessageListenerContainer) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-messaging %} #### SPRING_MESSAGING (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_MESSAGING_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_MESSAGING_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the SpringMessageHandler integration`DD_TRACE_SPRING_MESSAGING_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_MESSAGING_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the SpringMessageHandler integration`DD_TRACE_SPRING_MESSAGING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_MESSAGING_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_MESSAGING_ENABLED` Enables Spring Messaging (SpringMessageHandler) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-messaging-4 %} #### SPRING_MESSAGING_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_MESSAGING_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_MESSAGING_4_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_MESSAGING_4_ENABLED` Enables Spring Messaging 4 (SpringMessageHandler) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-messaging-e2e-duration %} #### SPRING_MESSAGING_E2E_DURATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_MESSAGING_E2E_DURATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_MESSAGING_E2E_DURATION_ENABLED` Spring Messaging end-to-end duration: when enabled for `spring-messaging`, the messaging decorator calls `span.beginEndToEnd()` at span start, enabling end-to-end duration calculation when spans are finished with end-to-end semantics. Default: false. {% /collapsible-section %} {% collapsible-section #integration-spring-messaging-kotlin %} #### SPRING_MESSAGING_KOTLIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_MESSAGING_KOTLIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_MESSAGING_KOTLIN_ENABLED`, `DD_INTEGRATION_SPRING_MESSAGING_KOTLIN_ENABLED` Toggle Spring Messaging Kotlin Instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-path-filter %} #### SPRING_PATH_FILTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_PATH_FILTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_PATH_FILTER_ENABLED`, `DD_INTEGRATION_SPRING_PATH_FILTER_ENABLED` Enables Spring path/filter helpers for improved route naming (registers `ServletRequestPathFilter` and Datadog's `HandlerMappingResourceNameFilter` early in the filter chain to set best-matching patterns and servlet path handling) {% /collapsible-section %} {% collapsible-section #integration-spring-rabbit %} #### SPRING_RABBIT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_RABBIT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_RABBIT_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_RABBIT_ENABLED` Enables Spring AMQP (spring-rabbit) consumer tracing (propagates context from `Delivery` to listener execution and creates measured `amqp.consume` spans tagged with the consumer queue) {% /collapsible-section %} {% collapsible-section #integration-spring-scheduling %} #### SPRING_SCHEDULING (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_SCHEDULING_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_SCHEDULING_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the SpringScheduling integration`DD_TRACE_SPRING_SCHEDULING_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_SCHEDULING_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the SpringScheduling integration`DD_TRACE_SPRING_SCHEDULING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_SCHEDULING_ENABLED`, `DD_INTEGRATION_SPRING_SCHEDULING_ENABLED` Enables Spring Scheduling (SpringScheduling) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-scheduling-legacy-tracing %} #### SPRING_SCHEDULING_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_SCHEDULING_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_SCHEDULING_LEGACY_TRACING_ENABLED` Spring Scheduling legacy tracing: when enabled, scheduled task spans are started with an implicit parent (linked to the currently active span). When disabled, scheduled task spans are started with an explicit `null` parent (new trace). Default: false. {% /collapsible-section %} {% collapsible-section #integration-spring-security %} #### SPRING_SECURITY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_SECURITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_SECURITY_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_SECURITY_ENABLED` Enables Spring Security AppSec user-event instrumentation (records login/signup/user context events from AuthenticationManager/SecurityContextHolder/UserDetailsManager and signals user-not-found events when AppSec is active) {% /collapsible-section %} {% collapsible-section #integration-spring-web %} #### SPRING_WEB (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WEB_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_WEB_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Spring Web integration`DD_TRACE_SPRING_WEB_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_WEB_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Spring Web integration`DD_TRACE_SPRING_WEB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_WEB_ENABLED`, `DD_INTEGRATION_SPRING_WEB_ENABLED` Enables Spring Web MVC instrumentation (creates handler/controller spans and view-render spans, sets resource names from HandlerMapping best-matching patterns, supports async CompletionStage continuations, and adds AppSec/IAST hooks for endpoint collection and path/template/matrix parameter processing/blocking) {% /collapsible-section %} {% collapsible-section #integration-spring-web-code-origin %} #### SPRING_WEB_CODE_ORIGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WEB_CODE_ORIGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_WEB_CODE_ORIGIN_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_WEB_CODE_ORIGIN_ENABLED` Enables Spring Web Code Origin (SpringWebCodeOrigin) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-webflux %} #### SPRING_WEBFLUX (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WEBFLUX_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_WEBFLUX_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Spring WebFlux integration`DD_TRACE_SPRING_WEBFLUX_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_WEBFLUX_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Spring WebFlux integration`DD_TRACE_SPRING_WEBFLUX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_WEBFLUX_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_WEBFLUX_ENABLED` Enables Spring WebFlux tracing and security (creates server spans for `DispatcherHandler`/handler execution and finishes them on reactive completion, updates route resource names from best-matching patterns, adds WebClient outbound tracing, and enables IAST taint tracking for reactive request/response data) {% /collapsible-section %} {% collapsible-section #integration-spring-webflux-client %} #### SPRING_WEBFLUX_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WEBFLUX_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPRING_WEBFLUX_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the WebClientFilter integration`DD_TRACE_SPRING_WEBFLUX_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPRING_WEBFLUX_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the WebClientFilter integration`DD_TRACE_SPRING_WEBFLUX_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_WEBFLUX_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_WEBFLUX_CLIENT_ENABLED` Enables Spring WebFlux Client (WebClientFilter) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-webflux-functional %} #### SPRING_WEBFLUX_FUNCTIONAL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WEBFLUX_FUNCTIONAL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_WEBFLUX_FUNCTIONAL_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_WEBFLUX_FUNCTIONAL_ENABLED` Enables Spring WebFlux Functional (RouterFunction) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-ws %} #### SPRING_WS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SPRING_WS_ENABLED`, `DD_INTEGRATION_SPRING_WS_ENABLED` Enables Spring WS (MethodEndpoint) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spring-ws-2 %} #### SPRING_WS_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SPRING_WS_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPRING_WS_2_ENABLED`, `DD_TRACE_INTEGRATION_SPRING_WS_2_ENABLED` Enables Spring WS 2 (MethodEndpoint) instrumentation {% /collapsible-section %} {% collapsible-section #integration-spymemcached %} #### SPYMEMCACHED (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SPYMEMCACHED_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SPYMEMCACHED_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Spymemcached integration`DD_TRACE_SPYMEMCACHED_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SPYMEMCACHED_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Spymemcached integration`DD_TRACE_SPYMEMCACHED_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SPYMEMCACHED_ENABLED`, `DD_TRACE_INTEGRATION_SPYMEMCACHED_ENABLED` Enables spymemcached client tracing (creates spans for `MemcachedClient` operations including async futures/bulk gets and `incr`/`decr`, finishes spans via completion listeners, and tags peer connection addresses) {% /collapsible-section %} {% collapsible-section #integration-sqs %} #### SQS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SQS_ENABLED`, `DD_INTEGRATION_SQS_ENABLED` Enables AWS SQS instrumentation (requests `AWSTraceHeader` for receives, wraps received message lists to extract/propagate trace context, and adds AWS SDK v2 SQS interceptors / JMS helpers when propagation or Data Streams is enabled) {% /collapsible-section %} {% collapsible-section #integration-sqs-body-propagation %} #### SQS_BODY_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_BODY_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` SQS body propagation: when enabled, if the `_datadog` SQS message attribute is not present, the tracer attempts to parse the message body as JSON and extract `MessageAttributes._datadog` for context propagation. Default: false. {% /collapsible-section %} {% collapsible-section #integration-sqs-inject-datadog-attribute %} #### SQS_INJECT_DATADOG_ATTRIBUTE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_INJECT_DATADOG_ATTRIBUTE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_SQS_INJECT_DATADOG_ATTRIBUTE_ENABLED` Controls whether or not the "_datadog" attribute, is injected into SQS messageAttributes {% /collapsible-section %} {% collapsible-section #integration-sqs-legacy-tracing %} #### SQS_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_SQS_LEGACY_TRACING_ENABLED` SQS legacy tracing: when enabled (and inferred services are allowed), uses legacy tracing/naming behavior for SQS spans; this also changes the default enablement of SQS time-in-queue tracking (disabled by default in legacy mode). Default: true. {% /collapsible-section %} {% collapsible-section #integration-sqs-propagation %} #### SQS_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_SQS_PROPAGATION_ENABLED` SQS context propagation: when enabled, extracts incoming distributed context from SQS messages (message attributes and/or body, depending on configuration) and uses it as the parent context for consumer spans; also ensures required SQS attributes (e.g. `AWSTraceHeader`) are requested. Default: true. {% /collapsible-section %} {% collapsible-section #integration-sqs-time-in-queue %} #### SQS_TIME_IN_QUEUE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQS_TIME_IN_QUEUE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_SQS_TIME_IN_QUEUE_ENABLED` SQS time-in-queue: when enabled (and inferred services are allowed), creates a time-in-queue span starting at the message `SentTimestamp` and parents the consumer span to it, representing time spent in SQS before delivery. Default: enabled for non-legacy SQS traces. {% /collapsible-section %} {% collapsible-section #integration-sslsocket %} #### SSLSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SSLSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SSLSOCKET_ENABLED`, `DD_INTEGRATION_SSLSOCKET_ENABLED` Enables SSLSocket instrumentation {% /collapsible-section %} {% collapsible-section #integration-status404decorator %} #### STATUS404DECORATOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STATUS404DECORATOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tag interceptor rule `Status404Decorator`: when enabled (together with `URLAsResourceNameRule` and `Status404Rule`), sets the span resource name to `404` when the HTTP status code is 404. Default: true. {% /collapsible-section %} {% collapsible-section #integration-status404rule %} #### STATUS404RULE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STATUS404RULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` By default, HTTP 404 responses use "404" as the span resource name. When `false`, HTTP 404 responses keep the original URL path as the resource name. {% /collapsible-section %} {% collapsible-section #integration-strict-writes %} #### STRICT_WRITES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STRICT_WRITES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Strict trace writes: when enabled, enforces strict pending-reference accounting when deciding to write a trace (throws if the pending reference count becomes negative, and writes as soon as the reference count reaches zero). Default: false. {% /collapsible-section %} {% collapsible-section #integration-structured-task-scope %} #### STRUCTURED_TASK_SCOPE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STRUCTURED_TASK_SCOPE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_STRUCTURED_TASK_SCOPE_ENABLED`, `DD_TRACE_INTEGRATION_STRUCTURED_TASK_SCOPE_ENABLED` Enables context propagation for Java structured concurrency (`StructuredTaskScope`) subtasks (captures the active span at Subtask creation and restores it when the Runnable executes; supports JDK 21–24 and JDK 25+ implementations) {% /collapsible-section %} {% collapsible-section #integration-structured-task-scope-21 %} #### STRUCTURED_TASK_SCOPE_21 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STRUCTURED_TASK_SCOPE_21_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_TRACE_INTEGRATION_STRUCTURED_TASK_SCOPE_21_ENABLED`, `DD_INTEGRATION_STRUCTURED_TASK_SCOPE_21_ENABLED` Enables Structured Task Scope (JDK 21) (StructuredTaskScope21) instrumentation {% /collapsible-section %} {% collapsible-section #integration-structured-task-scope-25 %} #### STRUCTURED_TASK_SCOPE_25 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_STRUCTURED_TASK_SCOPE_25_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.57.0` **Aliases**:`DD_TRACE_INTEGRATION_STRUCTURED_TASK_SCOPE_25_ENABLED`, `DD_INTEGRATION_STRUCTURED_TASK_SCOPE_25_ENABLED` Enables Structured Task Scope (JDK 25) (StructuredTaskScope25) instrumentation {% /collapsible-section %} {% collapsible-section #integration-surefire %} #### SUREFIRE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SUREFIRE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SUREFIRE_ENABLED`, `DD_INTEGRATION_SUREFIRE_ENABLED` Enables Surefire (JUnit4ClassOrder) instrumentation {% /collapsible-section %} {% collapsible-section #integration-synapse3 %} #### SYNAPSE3 (3) {% icon name="icon-link-wui" /%} `DD_TRACE_SYNAPSE3_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_SYNAPSE3_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Synapse 3 integration`DD_TRACE_SYNAPSE3_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_SYNAPSE3_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Synapse 3 integration`DD_TRACE_SYNAPSE3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SYNAPSE3_ENABLED`, `DD_TRACE_INTEGRATION_SYNAPSE3_ENABLED` Enables Apache Synapse 3 pass-through transport tracing (creates client and server spans for `TargetHandler`/`SourceHandler` HTTP processing, injects/extracts distributed trace headers, propagates context across worker threads/continuations, and strips `x-datadog*` headers on passthru to avoid leakage) {% /collapsible-section %} {% collapsible-section #integration-synapse3-client %} #### SYNAPSE3_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SYNAPSE3_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_SYNAPSE3_CLIENT_ENABLED`, `DD_TRACE_INTEGRATION_SYNAPSE3_CLIENT_ENABLED` Enables Apache Synapse 3 client-side tracing (creates spans for outgoing requests via `TargetHandler`, injects distributed trace headers into target requests, propagates parent spans through passthru/ClientWorker continuations, and finishes spans on final responses or errors) {% /collapsible-section %} {% collapsible-section #integration-synapse3-server %} #### SYNAPSE3_SERVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SYNAPSE3_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_SYNAPSE3_SERVER_ENABLED`, `DD_INTEGRATION_SYNAPSE3_SERVER_ENABLED` Enables Apache Synapse 3 server-side tracing (creates spans for incoming requests via `SourceHandler`, extracts distributed trace headers, propagates context through `ServerWorker`, and finishes spans on final responses or errors) {% /collapsible-section %} {% collapsible-section #integration-task-runner %} #### TASK_RUNNER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TASK_RUNNER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TASK_RUNNER_ENABLED`, `DD_INTEGRATION_TASK_RUNNER_ENABLED` Enables Task Runner (TaskRunner) instrumentation {% /collapsible-section %} {% collapsible-section #integration-task-unwrapping %} #### TASK_UNWRAPPING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TASK_UNWRAPPING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TASK_UNWRAPPING_ENABLED`, `DD_INTEGRATION_TASK_UNWRAPPING_ENABLED` Enables Task Unwrapping (TaskUnwrapping) instrumentation {% /collapsible-section %} {% collapsible-section #integration-test-order %} #### TEST_ORDER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TEST_ORDER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TEST_ORDER_ENABLED`, `DD_TRACE_INTEGRATION_TEST_ORDER_ENABLED` Enables CI Visibility test ordering (applies Datadog fail-fast ordering for JUnit 4/5 and TestNG so tests are executed in a Datadog-provided priority order) {% /collapsible-section %} {% collapsible-section #integration-test-retry %} #### TEST_RETRY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TEST_RETRY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TEST_RETRY_ENABLED`, `DD_TRACE_INTEGRATION_TEST_RETRY_ENABLED` Enables CI Visibility execution policies for tests (automatic test retries and failure-suppression across supported frameworks such as JUnit, TestNG, Cucumber, Karate, ScalaTest, and MUnit) {% /collapsible-section %} {% collapsible-section #integration-testng %} #### TESTNG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TESTNG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TESTNG_ENABLED`, `DD_INTEGRATION_TESTNG_ENABLED` Enables CI Visibility instrumentation for TestNG (installs Datadog listeners to report suite/class/test spans, and supports ITR test skipping, fail-fast test ordering, and automatic test retries when execution policies are enabled) {% /collapsible-section %} {% collapsible-section #integration-testng-6 %} #### TESTNG_6 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TESTNG_6_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TESTNG_6_ENABLED`, `DD_TRACE_INTEGRATION_TESTNG_6_ENABLED` Enables TestNG 6 (TestNGClassListener) instrumentation {% /collapsible-section %} {% collapsible-section #integration-testng-7 %} #### TESTNG_7 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TESTNG_7_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TESTNG_7_ENABLED`, `DD_INTEGRATION_TESTNG_7_ENABLED` Enables TestNG 7 (TestNGClassListener) instrumentation {% /collapsible-section %} {% collapsible-section #integration-testng-itr %} #### TESTNG_ITR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TESTNG_ITR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TESTNG_ITR_ENABLED`, `DD_INTEGRATION_TESTNG_ITR_ENABLED` Enables TestNG ITR (TestNGSkip) instrumentation {% /collapsible-section %} {% collapsible-section #integration-thread-pool-executors-legacy-tracing %} #### THREAD_POOL_EXECUTORS_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_THREAD_POOL_EXECUTORS_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_THREAD_POOL_EXECUTORS_LEGACY_TRACING_ENABLED` Thread pool executors legacy tracing: when enabled, the thread-pool-executors instrumentation uses wrapping-based propagation for tasks (wrapping `Runnable`s). When disabled (default), it uses field-backed context storage on tasks (and a ThreadLocal between executor hooks) instead of wrapping. {% /collapsible-section %} {% collapsible-section #integration-throwables %} #### THROWABLES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_THROWABLES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_THROWABLES_ENABLED`, `DD_INTEGRATION_THROWABLES_ENABLED` Enables exception profiling (`throwables`) when JFR is available (records `Exception`/`Error` instantiation events for continuous profiling and excludes known control-flow/leak-detection exceptions like Hikari's `ProxyLeakTask`) {% /collapsible-section %} {% collapsible-section #integration-thymeleaf %} #### THYMELEAF (1) {% icon name="icon-link-wui" /%} `DD_TRACE_THYMELEAF_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_THYMELEAF_ENABLED`, `DD_INTEGRATION_THYMELEAF_ENABLED` Enables Thymeleaf IAST XSS instrumentation (tracks unescaped template output via `StandardUtextTagProcessor` and `ElementTagStructureHandler.setBody`, and reports XSS sinks with template name and line) {% /collapsible-section %} {% collapsible-section #integration-tibco %} #### TIBCO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TIBCO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TIBCO_ENABLED`, `DD_TRACE_INTEGRATION_TIBCO_ENABLED` Enables TIBCO BusinessWorks tracing including thread-pool context propagation (creates spans for BW processes and activities, and wraps scheduled runnables to keep trace continuity across worker threads) {% /collapsible-section %} {% collapsible-section #integration-tibco-bw %} #### TIBCO_BW (3) {% icon name="icon-link-wui" /%} `DD_TRACE_TIBCO_BW_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TIBCO_BW_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Tibco BusinessWorks integration`DD_TRACE_TIBCO_BW_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_TIBCO_BW_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Tibco BusinessWorks integration`DD_TRACE_TIBCO_BW_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TIBCO_BW_ENABLED`, `DD_TRACE_INTEGRATION_TIBCO_BW_ENABLED` Enables TIBCO BusinessWorks (BW) tracing (creates spans for process instances and activities/tasks, propagates parent/child process context, and can derive the service name from the BW application/module) {% /collapsible-section %} {% collapsible-section #integration-tinylog %} #### TINYLOG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TINYLOG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TINYLOG_ENABLED`, `DD_TRACE_INTEGRATION_TINYLOG_ENABLED` Enables tinylog 2 log correlation (injects trace/span IDs plus `dd.service`, `dd.env`, and `dd.version` into Tinylog's log context when logs injection is enabled) {% /collapsible-section %} {% collapsible-section #integration-tomcat %} #### TOMCAT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_TOMCAT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TOMCAT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Tomcat integration`DD_TRACE_TOMCAT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_TOMCAT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Tomcat integration`DD_TRACE_TOMCAT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TOMCAT_ENABLED`, `DD_TRACE_INTEGRATION_TOMCAT_ENABLED` Enables Apache Tomcat server tracing and security instrumentation (creates inbound HTTP request spans via `CoyoteAdapter`, finishes them on request/response recycle, supports AppSec request blocking and request-body parameter collection, tags Tomcat process info, and propagates context through Tomcat WebSocket handshakes/upgrades) {% /collapsible-section %} {% collapsible-section #integration-tomcat-classloading %} #### TOMCAT_CLASSLOADING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TOMCAT_CLASSLOADING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TOMCAT_CLASSLOADING_ENABLED`, `DD_INTEGRATION_TOMCAT_CLASSLOADING_ENABLED` Enables Tomcat Classloading (WebappClassLoader) instrumentation {% /collapsible-section %} {% collapsible-section #integration-tomcat-websocket %} #### TOMCAT_WEBSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TOMCAT_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TOMCAT_WEBSOCKET_ENABLED`, `DD_INTEGRATION_TOMCAT_WEBSOCKET_ENABLED` Enables Tomcat WebSocket context propagation (captures the active HTTP handshake span in `WsHandshakeRequest` and re-activates it for `WsHttpUpgradeHandler` initialization) {% /collapsible-section %} {% collapsible-section #integration-trace %} #### TRACE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TRACE_ENABLED`, `DD_TRACE_INTEGRATION_TRACE_ENABLED` Enables method tracing via trace annotations and configured trace methods (creates spans for methods annotated with `datadog.trace.api.Trace` and other supported `@Trace` annotations, and for class/methods listed in tracer configuration) {% /collapsible-section %} {% collapsible-section #integration-trace-annotation %} #### TRACE_ANNOTATION (3) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACE_ANNOTATION_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_ANNOTATION_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the TraceAnnotations integration`DD_TRACE_TRACE_ANNOTATION_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_TRACE_ANNOTATION_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the TraceAnnotations integration`DD_TRACE_TRACE_ANNOTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TRACE_ANNOTATION_ENABLED`, `DD_INTEGRATION_TRACE_ANNOTATION_ENABLED` Enables Trace Annotation (TraceAnnotations) instrumentation {% /collapsible-section %} {% collapsible-section #integration-trace-config %} #### TRACE_CONFIG (3) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACE_CONFIG_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_CONFIG_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the TraceConfig integration`DD_TRACE_TRACE_CONFIG_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_TRACE_CONFIG_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the TraceConfig integration`DD_TRACE_TRACE_CONFIG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_TRACE_CONFIG_ENABLED`, `DD_INTEGRATION_TRACE_CONFIG_ENABLED` Enables Trace Config (TraceConfig) instrumentation {% /collapsible-section %} {% collapsible-section #integration-trace-ffm %} #### TRACE_FFM (2) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACE_FFM_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_FFM_ANALYTICS_ENABLED` Enables analytics for the trace-ffm integration`DD_TRACE_TRACE_FFM_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_FFM_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the trace-ffm integration {% /collapsible-section %} {% collapsible-section #integration-tracer-metrics %} #### TRACER_METRICS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACER_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Tracer metrics: enables computation and reporting of tracer metrics (client stats) to the Datadog Agent. Note: metrics are only enabled when APM tracing is enabled (`isTracerMetricsEnabled()` also checks `isApmTracingEnabled()`). Default: true. {% /collapsible-section %} {% collapsible-section #integration-tracer-metrics-buffering %} #### TRACER_METRICS_BUFFERING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TRACER_METRICS_BUFFERING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Tracer metrics buffering: when enabled, tracer metrics payloads are buffered and sent asynchronously when agent request latency is high; when disabled, metrics are sent synchronously (no buffering). Default: false. {% /collapsible-section %} {% collapsible-section #integration-twilio-sdk %} #### TWILIO_SDK (3) {% icon name="icon-link-wui" /%} `DD_TRACE_TWILIO_SDK_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TWILIO_SDK_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Twilio SDK integration`DD_TRACE_TWILIO_SDK_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_TWILIO_SDK_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Twilio SDK integration`DD_TRACE_TWILIO_SDK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_TWILIO_SDK_ENABLED`, `DD_TRACE_INTEGRATION_TWILIO_SDK_ENABLED` Enables Twilio Java SDK client tracing (creates spans for Twilio `create/read/fetch/update/delete` operations, including async calls finished via callbacks, and tags spans with operation/result details) {% /collapsible-section %} {% collapsible-section #integration-undertow %} #### UNDERTOW (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_UNDERTOW_ENABLED`, `DD_INTEGRATION_UNDERTOW_ENABLED` Enables Undertow server tracing and security instrumentation (creates inbound HTTP spans around `Connectors.executeRootHandler`, propagates context across `HttpServerExchange.dispatch`, bridges to servlet requests (javax/jakarta), records 400 spans on request-parse failures, and supports AppSec response/header callbacks plus form/multipart body inspection and blocking) {% /collapsible-section %} {% collapsible-section #integration-undertow-2-0 %} #### UNDERTOW_2_0 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_2_0_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_UNDERTOW_2_0_ENABLED`, `DD_TRACE_INTEGRATION_UNDERTOW_2_0_ENABLED` Enables Undertow 2.0 server tracing and AppSec hooks (creates inbound HTTP spans, propagates context across `HttpServerExchange.dispatch`, bridges to `javax.servlet` requests, and enables response/header callbacks plus form/multipart body inspection and blocking) {% /collapsible-section %} {% collapsible-section #integration-undertow-2-2 %} #### UNDERTOW_2_2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_2_2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_UNDERTOW_2_2_ENABLED`, `DD_TRACE_INTEGRATION_UNDERTOW_2_2_ENABLED` Enables Undertow 2.2 servlet/request parsing instrumentation (propagates tracing context into `jakarta.servlet` requests and records a 400 span when HTTP request parsing fails before a normal server span can be created) {% /collapsible-section %} {% collapsible-section #integration-undertow-http %} #### UNDERTOW_HTTP (2) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_HTTP_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_UNDERTOW_HTTP_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Undertow HTTP integration`DD_TRACE_UNDERTOW_HTTP_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_UNDERTOW_HTTP_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Undertow HTTP integration {% /collapsible-section %} {% collapsible-section #integration-undertow-http-server %} #### UNDERTOW_HTTP_SERVER (2) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_HTTP_SERVER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_UNDERTOW_HTTP_SERVER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Undertow HTTP server integration`DD_TRACE_UNDERTOW_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_UNDERTOW_HTTP_SERVER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Undertow HTTP server integration {% /collapsible-section %} {% collapsible-section #integration-undertow-legacy-tracing %} #### UNDERTOW_LEGACY_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_LEGACY_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_UNDERTOW_LEGACY_TRACING_ENABLED` Undertow legacy tracing: when enabled, Undertow HTTP server instrumentation uses legacy tracing behavior (including how it sets framework route/resource names during servlet dispatch). Default: true. {% /collapsible-section %} {% collapsible-section #integration-undertow-request-parse %} #### UNDERTOW_REQUEST_PARSE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDERTOW_REQUEST_PARSE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_UNDERTOW_REQUEST_PARSE_ENABLED`, `DD_INTEGRATION_UNDERTOW_REQUEST_PARSE_ENABLED` Enables Undertow Request Parse (HttpRequestParser) instrumentation {% /collapsible-section %} {% collapsible-section #integration-urlasresourcenamerule %} #### URLASRESOURCENAMERULE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_URLASRESOURCENAMERULE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` HTTP URL-as-resource-name rule (`URLAsResourceNameRule`): when enabled, HTTP server spans can use the request URL/path to compute the span resource name (and participates in 404 resource-name behavior). When disabled, the default resource name is `/` unless a framework route is set. Default: true. {% /collapsible-section %} {% collapsible-section #integration-urlconnection %} #### URLCONNECTION (3) {% icon name="icon-link-wui" /%} `DD_TRACE_URLCONNECTION_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_URLCONNECTION_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Url integration`DD_TRACE_URLCONNECTION_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_URLCONNECTION_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Url integration`DD_TRACE_URLCONNECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_TRACE_INTEGRATION_URLCONNECTION_ENABLED`, `DD_INTEGRATION_URLCONNECTION_ENABLED` Enables URLConnection (Url) instrumentation {% /collapsible-section %} {% collapsible-section #integration-valkey %} #### VALKEY (3) {% icon name="icon-link-wui" /%} `DD_TRACE_VALKEY_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v1.55.0` **Aliases**:`DD_VALKEY_ANALYTICS_ENABLED` This setting is currently not used by the valkey-go integration and has no effect.`DD_TRACE_VALKEY_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_VALKEY_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Valkey integration`DD_TRACE_VALKEY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_VALKEY_ENABLED`, `DD_TRACE_INTEGRATION_VALKEY_ENABLED` Enables Valkey instrumentation {% /collapsible-section %} {% collapsible-section #integration-velocity %} #### VELOCITY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VELOCITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_VELOCITY_ENABLED`, `DD_INTEGRATION_VELOCITY_ENABLED` Enables Velocity (ASTReference) instrumentation {% /collapsible-section %} {% collapsible-section #integration-vertx %} #### VERTX (3) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_VERTX_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Vert.x integration`DD_TRACE_VERTX_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_VERTX_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Vert.x integration`DD_TRACE_VERTX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_VERTX_ENABLED`, `DD_TRACE_INTEGRATION_VERTX_ENABLED` Enables Vert.x instrumentation (creates spans for Vert.x Web route handlers and updates HTTP routes/resource names, traces Vert.x Redis and SQL clients, and adds AppSec/IAST hooks for request bodies, cookies, JSON helpers, and buffer taint propagation) {% /collapsible-section %} {% collapsible-section #integration-vertx-3-4 %} #### VERTX_3_4 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_3_4_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_VERTX_3_4_ENABLED`, `DD_TRACE_INTEGRATION_VERTX_3_4_ENABLED` Enables Vert.x Web 3.4 tracing and security hooks (creates spans for route handler execution, updates route-based resource names, and adds AppSec/IAST instrumentation for request bodies/JSON/session helpers, cookies, reroute redirects, and buffer taint propagation) {% /collapsible-section %} {% collapsible-section #integration-vertx-3-5 %} #### VERTX_3_5 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_3_5_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_VERTX_3_5_ENABLED`, `DD_INTEGRATION_VERTX_3_5_ENABLED` Enables Vert.x 3.5 (VertxHttpHeaders) instrumentation {% /collapsible-section %} {% collapsible-section #integration-vertx-3-9 %} #### VERTX_3_9 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_3_9_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_VERTX_3_9_ENABLED`, `DD_INTEGRATION_VERTX_3_9_ENABLED` Enables Vert.x 3.9 (Vertx39HttpServertResponse) instrumentation {% /collapsible-section %} {% collapsible-section #integration-vertx-4-0 %} #### VERTX_4_0 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_4_0_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_VERTX_4_0_ENABLED`, `DD_TRACE_INTEGRATION_VERTX_4_0_ENABLED` Enables Vert.x Web 4.0 tracing and security hooks (creates spans for route handler execution, updates route-based resource names, decorates HTTP client failures, and adds AppSec/IAST instrumentation for request/response JSON helpers, request-body processing, and buffer taint propagation) {% /collapsible-section %} {% collapsible-section #integration-vertx-5-0 %} #### VERTX_5_0 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_5_0_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_VERTX_5_0_ENABLED`, `DD_TRACE_INTEGRATION_VERTX_5_0_ENABLED` Enables Vert.x 5.0 (HttpServerRequest) instrumentation {% /collapsible-section %} {% collapsible-section #integration-vertx-redis-client %} #### VERTX_REDIS_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_REDIS_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_VERTX_REDIS_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Vert.x Redis client integration`DD_TRACE_VERTX_REDIS_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_VERTX_REDIS_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Vert.x Redis client integration`DD_TRACE_VERTX_REDIS_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_VERTX_REDIS_CLIENT_ENABLED`, `DD_INTEGRATION_VERTX_REDIS_CLIENT_ENABLED` Enables Vert.x Redis client tracing (creates spans for Redis commands sent via `Redis.send`/`RedisAPI`, clones reused `Request` objects so each use gets its own span, wraps async handlers/futures to finish spans and preserve parent context, and tags spans with command + peer connection info) {% /collapsible-section %} {% collapsible-section #integration-vertx-route-handler %} #### VERTX_ROUTE_HANDLER (2) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_ROUTE_HANDLER_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_VERTX_ROUTE_HANDLER_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Vert.x route handler integration`DD_TRACE_VERTX_ROUTE_HANDLER_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_VERTX_ROUTE_HANDLER_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Vert.x route handler integration {% /collapsible-section %} {% collapsible-section #integration-vertx-sql-client %} #### VERTX_SQL_CLIENT (3) {% icon name="icon-link-wui" /%} `DD_TRACE_VERTX_SQL_CLIENT_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_VERTX_SQL_CLIENT_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the Vert.x SQL client integration`DD_TRACE_VERTX_SQL_CLIENT_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_VERTX_SQL_CLIENT_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the Vert.x SQL client integration`DD_TRACE_VERTX_SQL_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_VERTX_SQL_CLIENT_ENABLED`, `DD_INTEGRATION_VERTX_SQL_CLIENT_ENABLED` Enables Vert.x SQL client tracing (creates `database.query` spans for statement/prepared query execution and cursor reads, wraps async result handlers to finish spans and preserve parent context, and tags spans with SQL/operation plus DB connection metadata for Vert.x MySQL and PostgreSQL clients) {% /collapsible-section %} {% collapsible-section #integration-virtual-thread %} #### VIRTUAL_THREAD (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VIRTUAL_THREAD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.61.0` **Aliases**:`DD_TRACE_INTEGRATION_VIRTUAL_THREAD_ENABLED`, `DD_INTEGRATION_VIRTUAL_THREAD_ENABLED` Enables virtual-thread integration {% /collapsible-section %} {% collapsible-section #integration-wallclock %} #### WALLCLOCK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WALLCLOCK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_WALLCLOCK_ENABLED`, `DD_INTEGRATION_WALLCLOCK_ENABLED` Enables Wallclock (EnableWallclockProfiling) instrumentation {% /collapsible-section %} {% collapsible-section #integration-weaver %} #### WEAVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WEAVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_WEAVER_ENABLED`, `DD_TRACE_INTEGRATION_WEAVER_ENABLED` Enables Weaver instrumentation {% /collapsible-section %} {% collapsible-section #integration-websocket %} #### WEBSOCKET (4) {% icon name="icon-link-wui" /%} `DD_TRACE_WEBSOCKET_ANALYTICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_WEBSOCKET_ANALYTICS_ENABLED` Enables trace analytics for spans produced by the WebSocket integration`DD_TRACE_WEBSOCKET_ANALYTICS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1.0` **Aliases**:`DD_WEBSOCKET_ANALYTICS_SAMPLE_RATE` Sampling rate for analytics events generated by the WebSocket integration`DD_TRACE_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` **Aliases**:`DD_INTEGRATION_WEBSOCKET_ENABLED`, `DD_TRACE_INTEGRATION_WEBSOCKET_ENABLED` Enables WebSocket tracing (links WebSocket sessions to the active HTTP handshake span, creates spans for WebSocket frame send/receive and session close events for javax/jakarta WebSocket APIs and Jetty WebSocket, and propagates handshake context through Tomcat WebSocket handshakes/upgrades)`DD_TRACE_WEBSOCKET_TAG_SESSION_ID` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` When set to `true`, the websocket spans have the tag `websocket.session.id` containing the session ID when available. {% /collapsible-section %} {% collapsible-section #integration-websocket-messages %} #### WEBSOCKET_MESSAGES (2) {% icon name="icon-link-wui" /%} `DD_TRACE_WEBSOCKET_MESSAGES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.62.0` Enables tracing sent and received websocket messages (text and binary) and connection close events.`DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` By default, each received message generates a new trace. The handshake is linked to it as a span link. Setting this parameter to `false` causes all the spans captured during the session to be in the same trace. {% /collapsible-section %} {% collapsible-section #integration-websphere-jmx %} #### WEBSPHERE_JMX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WEBSPHERE_JMX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_INTEGRATION_WEBSPHERE_JMX_ENABLED`, `DD_TRACE_INTEGRATION_WEBSPHERE_JMX_ENABLED` Enables WebSphere JMX (WebsphereSecurity) instrumentation {% /collapsible-section %} {% collapsible-section #integration-wildfly %} #### WILDFLY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WILDFLY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_TRACE_INTEGRATION_WILDFLY_ENABLED`, `DD_INTEGRATION_WILDFLY_ENABLED` Enables WildFly JEE env-entry classloader overrides (captures `EnvEntryInjectionSource` values and applies any JNDI entries under `java:comp/env/datadog/tags/*` as per-deployment tags so spans can be enriched via `ClassloaderConfigurationOverrides`) {% /collapsible-section %} {% collapsible-section #integration-zio-experimental %} #### ZIO_EXPERIMENTAL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ZIO_EXPERIMENTAL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Aliases**:`DD_INTEGRATION_ZIO_EXPERIMENTAL_ENABLED`, `DD_TRACE_INTEGRATION_ZIO_EXPERIMENTAL_ENABLED` Enables ZIO Experimental (ZioRuntime) instrumentation {% /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**: `v1.55.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 %} (4) {% icon name="icon-link-wui" /%} Tracer log output settings: log levels, log file paths, log rotation, and startup diagnostics. `DD_LOG_FORMAT_JSON` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Since**: `v1.58.0` Set to 'true' to output logs in JSON format`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_LOG_LEVEL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.62.0` **Aliases**:`DD_LOG_LEVEL` A string for the minimum log level for the tracer to use when debug logging is enabled. Possible levels are info, warn, error, debug.`DD_TRACE_STARTUP_LOGS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables emission of startup configuration and diagnostic log lines when the tracer initializes. {% collapsible-section #registry-retired-trace_logging %} #### Retired keys (1) {% icon name="icon-link-wui" /%} These keys are no longer supported in current versions of the library. They are listed here for reference if you are running an older version. `DD_LOG_LEVEL` {% icon name="icon-link-wui" /%} Removed in v1.59.0. **Type**: `string` Sets the Datadog logging level. Valid values are trace, debug, info, warn, error, critical, or off. {% /collapsible-section %} {% /collapsible-section %} {% collapsible-section %} ### Continuous Profiling{% #registry-profiling %} (9) {% 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_AGENTLESS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables agentless profile upload, sending profiles directly to the profiling intake instead of through a local agent.`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_DEBUG_UPLOAD_COMPRESSION` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `zstd` **Aliases**:`DD_PROFILING_UPLOAD_COMPRESSION` Profiling upload: compression type for profile uploads. Supported values: `on` (equivalent to `zstd`), `off`, `lz4`, `gzip`, `zstd`. Default: `zstd`.`DD_PROFILING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `false` **Since**: `v1.57.0` **Aliases**:`DD_EXPERIMENTAL_PROFILING_ENABLED` If set to `true`, enables the profiler. Defaults to `false`.`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_HEAP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` If set to `true`, enables Live Heap profiling (in Preview). Defaults to `false`.`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**: `int` **Default**: `30` **Since**: `v1.57.0` Profiling upload: HTTP request timeout in seconds for profile uploads (used by the profiling uploader HTTP client). Default: 30s.`DD_PROFILING_URL` {% icon name="icon-link-wui" /%} **Type**: `string` Profiling: explicit profiling intake URL. If set, the tracer uses this URL regardless of agentless/agent-based profiling settings; otherwise it targets the agentless intake (`https://intake.profile./api/v2/profile`) when agentless, or the Datadog Agent endpoint (`/profiling/v1/input`) when not agentless. {% /collapsible-section %} {% collapsible-section %} ### Application Security{% #registry-appsec %} (38) {% 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_REQUEST_BODY_ANALYSIS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `0.5` **Since**: `v1.55.0` **Aliases**:`DD_API_SECURITY_DOWNSTREAM_REQUEST_ANALYSIS_SAMPLE_RATE` 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_ENDPOINT_COLLECTION_MESSAGE_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `300` Sets the maximum number of API endpoints included in a single endpoint-collection telemetry message. If unset, a default limit is used.`DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1` **Since**: `v1.55.0` The maximum number of downstream requests per request for which the request and response body should be analysed.`DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE` {% icon name="icon-link-wui" /%} **Type**: `string` Sets AppSec automated user instrumentation mode (user ID collection mode). Supported values include `identification`/`ident`, `anonymization`/`anon`, and `disabled`.`DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Controls automated user event tracking mode used by AppSec when `DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE` is not set. Values like `safe` map to anonymization, `extended` maps to identification, and other values disable automated user events.`DD_APPSEC_BODY_PARSING_SIZE_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000000` **Since**: `v1.55.0` Maximum size of the bodies to be processed in bytes. If set to `0`, the bodies are not processed. (Recommended value: `10000000` (10MB))`DD_APPSEC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `inactive` **Since**: `v1.57.0` 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 returned when a request is blocked and the response should be JSON. If unset or invalid, the tracer uses the default blocking JSON template defined by the product RFC. The tracer chooses HTML or JSON based on the `Accept` header or the block action's parameters.`DD_APPSEC_IPHEADER` {% icon name="icon-link-wui" /%} **Type**: `string` Specify a single HTTP header to use for client IP resolution. When set, the tracer treats that header as the authoritative source of client IP and ignores the default set of candidate headers. This helps avoid ambiguity and IP spoofing issues when proxies or CDNs provide custom client IP headers; use with caution and follow deployment best practices.`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_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` A regular expression used by the AppSec obfuscator to identify parameter keys that must cause full redaction. When any `key_path` string matches this regexp the entire parameter is replaced by ``. The default key regexp matches common secret/key names (password, token, authorization, jwt, etc.) an empty string disables the key regexp`DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP` {% icon name="icon-link-wui" /%} **Type**: `string` 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` Path to a JSON rules file that overrides the default AppSec rules shipped with the tracer.`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**: `int` **Default**: `100000` **Since**: `v1.57.0` Limits the WAF synchronous execution time (in microseconds).`DD_IAST_DB_ROWS_TO_TAINT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1` IAST: maximum number of JDBC `ResultSet` rows to treat as taint sources (SQL table data) for a given `ResultSet`. Rows beyond this limit are not tainted. Default: 1.`DD_IAST_DEDUPLICATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables or disables vulnerability deduplication detection. When enabled, a vulnerability is only reported once in the lifetime of an app, instead of on every occurrence. Default value is true (enabled).`DD_IAST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `false` IAST: controls IAST product activation. `true`/`1` fully enables IAST; `inactive` applies instrumentation but keeps logic inactive so it can be toggled via remote config; any other value fully disables IAST. Default: false.`DD_IAST_MAX_CONCURRENT_REQUESTS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `4` IAST: maximum number of concurrent requests that can be analyzed (overhead control). Only used in `DEFAULT` detection mode; in `FULL` detection mode this is unlimited. Default (in `DEFAULT` mode): 4.`DD_IAST_MAX_RANGE_COUNT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10` IAST: maximum number of tainted ranges stored per tainted object/value. If more ranges are produced, they are truncated to this limit. Only used in `DEFAULT` detection mode; in `FULL` detection mode this is unlimited. Default (in `DEFAULT` mode): 10.`DD_IAST_REDACTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables or disables IAST redaction of sensitive data. Default value is in TracerSettings.`DD_IAST_REDACTION_NAME_PATTERN` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `(?:p(?:ass)?w(?:or)?d|pass(?:_?phrase)?|secret|(?:api_?|private_?|public_?|access_?|secret_?)key(?:_?id)?|token|consumer_?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?)` IAST: regular expression used to identify sensitive source names (header/parameter/cookie names, etc.) that should be redacted (compiled case-insensitively). Default matches common secrets like password/token/key.`DD_IAST_REDACTION_VALUE_PATTERN` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `(?:bearer\s+[a-z0-9\._\-]+|glpat-[\w\-]{20}|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[\-]{5}|ssh-rsa\s*[a-z0-9/\.+]{100,}))` IAST: regular expression used to identify sensitive values that should be redacted (compiled case-insensitively, multiline). Default matches patterns like Bearer tokens, GitHub/GitLab tokens, JWTs, and private keys.`DD_IAST_REQUEST_SAMPLING` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `33.0` IAST: request sampling percentage for analysis (overhead control). Used by the IAST overhead controller to decide which requests are analyzed. Values <= 0 are treated as 100% (it does not disable IAST). In `FULL` detection mode the sampling is forced to 100%. Default (in `DEFAULT` mode): 33%.`DD_IAST_SECURITY_CONTROLS_CONFIGURATION` {% icon name="icon-link-wui" /%} **Type**: `string` IAST: configures custom security controls (sanitizers / input validators) via a semicolon-separated configuration string. When set, the tracer installs a transformer that instruments the specified classes/methods so IAST can mark data as validated/sanitized for specific vulnerability types.`DD_IAST_STACK_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Aliases**:`DD_IAST_STACKTRACE_ENABLED` IAST: when enabled (default), captures a user-code stack trace and attaches it to IAST vulnerability reports (via a stack id). Useful for locating where vulnerable code executed. This also accepts the deprecated alias `DD_IAST_STACKTRACE_ENABLED`.`DD_IAST_TELEMETRY_VERBOSITY` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `INFORMATION` IAST: controls IAST telemetry verbosity (`OFF`, `MANDATORY`, `INFORMATION`, `DEBUG`). When tracer telemetry is disabled, this is forced to `OFF`. Default: `INFORMATION`.`DD_IAST_TRUNCATION_MAX_VALUE_LENGTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `250` Default value is 250`DD_IAST_VULNERABILITIES_PER_REQUEST` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `2` IAST: maximum number of vulnerabilities that can be reported per request (quota/overhead control). In `FULL` detection mode this limit is removed; in `DEFAULT` detection mode the default is 2.`DD_IAST_WEAK_CIPHER_ALGORITHMS` {% icon name="icon-link-wui" /%} **Type**: `string` IAST: regular expression (matched against the uppercased cipher algorithm id) that defines which cipher algorithms are considered weak. When a used cipher algorithm matches this pattern, IAST reports a `WEAK_CIPHER` vulnerability.`DD_IAST_WEAK_HASH_ALGORITHMS` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `["SHA1", "SHA-1", "MD2", "RIPEMD128", "MD4", "MD5"]` IAST: comma-separated set of hash algorithm ids considered weak (compared against the uppercased algorithm id). When a used hashing algorithm is in this set, IAST reports a `WEAK_HASH` vulnerability (for example for `MD5` or `SHA1`). {% /collapsible-section %} {% collapsible-section %} ### Dynamic Instrumentation & Debugging{% #registry-debugging %} (16) {% 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_CODE_ORIGIN_FOR_SPANS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables Code Origin for spans (Dynamic Instrumentation): starts the code-origin recorder and enables instrumentations that capture code origin at span entry (via `DebuggerContext.captureCodeOrigin`), producing code-origin snapshots/tags for spans. Default: false.`DD_CODE_ORIGIN_MAX_USER_FRAMES` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8` Code Origin for spans (Dynamic Instrumentation): sets the maximum number of user stack frames to capture/consider when recording code origin (default: 8). Note: the current code-origin recorder reads this value but does not use it, so it may have no effect in this version.`DD_DYNAMIC_INSTRUMENTATION_DIAGNOSTICS_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `3600` Interval (seconds) at which probe diagnostic/status messages (received/installed/emitting/errors) may be re-emitted`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` 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**: `string` **Since**: `v1.57.0` Comma-separated list of additional identifier keywords to redact in captured snapshot data`DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` 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**: `string` 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_DYNAMIC_INSTRUMENTATION_UPLOAD_BATCH_SIZE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `100` Upload batch size (number of snapshots/diagnostic messages per request). Controls how many snapshots are serialized and sent per flush. Default: 100.`DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` Low-rate upload flush interval in milliseconds. 0 (default) enables an adaptive flush interval; any other value uses a fixed interval. Deprecated in favor of DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS.`DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `string` Interval in seconds between uploads of probe data.`DD_EXCEPTION_REPLAY_CAPTURE_INTERVAL_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `3600` Exception Replay: minimum interval in seconds between capturing the same exception fingerprint again. Used to rate-limit repeated captures of identical exceptions. Default: 3600 seconds.`DD_EXCEPTION_REPLAY_CAPTURE_MAX_FRAMES` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` Exception Replay (legacy): deprecated alias for `DD_EXCEPTION_REPLAY_MAX_FRAMES_TO_CAPTURE`. Sets the maximum number of stack frames (non-native, non-excluded, with line numbers) to instrument/capture per exception. Default: 3.`DD_EXCEPTION_REPLAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Exception Replay (Live Debugging): enables the Exception Replay product. When enabled (for example via Remote Config), the tracer starts/stops the Exception Replay subsystem. This key is also accepted as a backward-compatible alias for `DD_EXCEPTION_DEBUGGING_ENABLED`.`DD_EXCEPTION_REPLAY_MAX_EXCEPTION_ANALYSIS_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `100` Exception Replay: maximum number of exceptions per second to analyze/handle (circuit breaker). When the limit is exceeded, additional exceptions are ignored for that second. Default: 100.`DD_SYMBOL_DATABASE_UPLOAD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Symbol Database (SymDB): enables uploading symbol information (for Live Debugging / Dynamic Instrumentation). Default: true. {% /collapsible-section %} {% collapsible-section %} ### CI Visibility{% #registry-civisibility %} (36) {% 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_ACTION_EXECUTION_ID` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the action execution ID reported as CI metadata for AWS CodePipeline builds. This value is used as the CI job identifier when running a CodeBuild job initiated by CodePipeline.`DD_CIVISIBILITY_AGENTLESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables agentless mode for CI Visibility, sending test data directly to the Datadog intake instead of through a local Agent.`DD_CIVISIBILITY_AGENTLESS_URL` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the intake base URL used for agentless CI test reporting. When set, payloads are sent to this URL instead of the default site-based intake URL.`DD_CIVISIBILITY_AUTO_INSTRUMENTATION_PROVIDER` {% icon name="icon-link-wui" /%} **Type**: `string` Marks CI test sessions as running under an auto-instrumentation workflow. Any non-empty value enables this marker for telemetry.`DD_CIVISIBILITY_CODE_COVERAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables CI Visibility per-test code coverage collection/reporting. When enabled, the tracer configures an additional intake track (`CITESTCOV`) to submit coverage data; when disabled, code coverage data is not sent.`DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables CI Visibility Early Flake Detection (EFD), which can run selected tests multiple times early to detect flakiness (based on backend-provided execution settings).`DD_CIVISIBILITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables CI Visibility instrumentation for test executions, reporting test sessions, modules, suites, and individual test results to Datadog.`DD_CIVISIBILITY_FLAKY_RETRY_COUNT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `5` Can be set to any non-negative number to change the maximum number of retries per test case.`DD_CIVISIBILITY_FLAKY_RETRY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Kill switch for the CI Visibility automatic test retries feature. When false, failing tests are not automatically re-run, even if remote settings would enable retries.`DD_CIVISIBILITY_GIT_UNSHALLOW_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Provide users the option to enable/disable the `git unshallow` process wheen retrieving git metadata.`DD_CIVISIBILITY_GIT_UPLOAD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Disable git upload if the DD_CIVISIBILITY_GIT_UPLOAD_ENABLED is set to false`DD_CIVISIBILITY_IMPACTED_TESTS_DETECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables CI Visibility impacted tests detection (TIA). When enabled, impacted-tests detection is requested/applied as part of execution settings propagated to child processes.`DD_CIVISIBILITY_ITR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables or disables Intelligent Test Runner in CI Visibility. Default Value is false (disabled).`DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `500` CI Visibility (Selenium): after calling `window.DD_RUM.stopSession()` at the end of a browser test, waits this many milliseconds before proceeding to allow RUM data to flush (default: 500ms).`DD_CIVISIBILITY_TEST_COMMAND` {% icon name="icon-link-wui" /%} **Type**: `string` CI Visibility: sets the test command string propagated to child test JVMs (for example, `mvn test` or `gradle test`). It is used to build the CI Visibility test session name when an explicit session name is not set.`DD_CIVISIBILITY_TOTAL_FLAKY_RETRY_COUNT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1000` Maximum total number of automatic test retries allowed across the entire CI test session, applied when automatic flaky-test retries are enabled.`DD_CUSTOM_TRACE_ID` {% icon name="icon-link-wui" /%} **Type**: `string` Custom trace ID propagated by the Jenkins Datadog Plugin, used to correlate Jenkins pipeline executions with traces emitted by the application under test.`DD_GIT_BRANCH` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the Git branch value used by CI Visibility for repository and commit correlation.`DD_GIT_COMMIT_AUTHOR_DATE` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the commit-author date, in ISO 8601 format, reported as CI metadata.`DD_GIT_COMMIT_AUTHOR_EMAIL` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit author email reported as CI metadata.`DD_GIT_COMMIT_AUTHOR_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit author name reported as CI metadata.`DD_GIT_COMMIT_COMMITTER_DATE` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the commit-committer date, in ISO 8601 format, reported as CI metadata.`DD_GIT_COMMIT_COMMITTER_EMAIL` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit committer email reported as CI metadata.`DD_GIT_COMMIT_COMMITTER_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit committer name reported as CI metadata.`DD_GIT_COMMIT_HEAD_SHA` {% icon name="icon-link-wui" /%} **Type**: `string` CI Visibility: sets the git head commit SHA for the current build/pull request, used to populate pull request info and CI git tags (for example, `git.commit.head.sha`) when user-supplied git metadata is needed.`DD_GIT_COMMIT_MESSAGE` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the git commit message reported as CI metadata.`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_PULL_REQUEST_BASE_BRANCH` {% icon name="icon-link-wui" /%} **Type**: `string` CI Visibility: sets the pull request base/target branch name, used to populate pull request info and CI git tags (for example, `git.pull_request.base_branch`) when user-supplied git metadata is needed.`DD_GIT_PULL_REQUEST_BASE_BRANCH_SHA` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the pull request base commit SHA reported as git metadata for CI features. Use this to set the base commit when it cannot be detected automatically.`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.`DD_GIT_TAG` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the Git tag used by CI Visibility for repository and release correlation.`DD_PIPELINE_EXECUTION_ID` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the pipeline execution ID reported as CI metadata for AWS CodePipeline builds. This value is used as the CI pipeline identifier when running a CodeBuild job initiated by CodePipeline.`DD_TEST_FAILED_TEST_REPLAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v1.55.0` CI Visibility: enables the Failed Test Replay feature (kill-switch). When enabled in execution settings, the tracer enables exception replay debugging during test execution to capture data for failed-test replay. Default: true (still requires backend/remote settings to enable).`DD_TEST_MANAGEMENT_ATTEMPT_TO_FIX_RETRIES` {% icon name="icon-link-wui" /%} **Type**: `int` Overrides the number of retry executions for tests flagged as "attempt to fix". When unset, the value from backend/remote settings is used.`DD_TEST_MANAGEMENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Local kill switch for CI Visibility Test Management features (disabled, quarantined, and attempt-to-fix tests). Set to false to disable Test Management even when remote settings would enable it.`DD_TEST_SESSION_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the auto-generated test session name reported to CI Visibility. When unset, the tracer builds a name from the detected CI provider, repository, and branch information. {% /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 %} (4) {% icon name="icon-link-wui" /%} Direct log submission to Datadog, agentless log forwarding, log injection for trace-log correlation, and OpenTelemetry log export. `DD_AGENTLESS_LOG_SUBMISSION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables direct log submission to Datadog without routing logs through the Datadog Agent.`DD_AGENTLESS_LOG_SUBMISSION_URL` {% icon name="icon-link-wui" /%} **Type**: `string` Overrides the intake URL used when agentless log submission is enabled.`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**: `v1.62.0` Enables collection and export of logs produced via the OpenTelemetry Logs API. {% /collapsible-section %} {% collapsible-section %} ### Runtime Metrics{% #registry-runtime_metrics %} (7) {% icon name="icon-link-wui" /%} Runtime metrics collection and DogStatsD connection configuration for metric submission. `DD_DOGSTATSD_ARGS` {% icon name="icon-link-wui" /%} **Type**: `string` Azure App Services: extra command-line arguments appended when the tracer starts an external DogStatsD process (only used when `DD_DOGSTATSD_PATH` is set).`DD_DOGSTATSD_HOST` {% icon name="icon-link-wui" /%} **Type**: `string` Override the address of the trace Agent host that the default tracer attempts to submit DogStatsD metrics to. Use `DD_AGENT_HOST` to override `DD_DOGSTATSD_HOST`.`DD_DOGSTATSD_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` Azure App Services: path to the DogStatsD executable to run as an external process. When set, the tracer starts and supervises a `dogstatsd` process (passing `DD_DOGSTATSD_ARGS`) and optionally health-checks it using `DD_DOGSTATSD_PIPE_NAME`.`DD_DOGSTATSD_PIPE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Named pipe that DogStatsD binds to. Default value is null.`DD_DOGSTATSD_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8125` The port of the DogStatsD Agent that metrics are submitted to. If the Agent configuration sets `dogstatsd_port` or `DD_DOGSTATSD_PORT` to something other than the default `8125`, then this tracing library `DD_DOGSTATSD_PORT` must match it.`DD_RUNTIME_METRICS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Configuration**: `runtimeMetrics` Whether to enable capturing runtime metrics. Port `8125` (or configured with `DD_DOGSTATSD_PORT`) must be opened on the Agent for UDP.`DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Description**: Enables enhanced runtime metrics, providing a `runtime_id` tag along with every metric. The `runtime_id` represents the application's process identifier and allows you to directly correlate runtime metrics with individual running applications. {% /collapsible-section %} {% collapsible-section %} ### Data Streams Monitoring{% #registry-data_streams %} (2) {% 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` Enables Data Streams Monitoring (DSM) and its checkpoint propagation. When enabled, the tracer registers the DSM propagator and reports pathway statistics and payloads.`DD_DATA_STREAMS_TRANSACTION_EXTRACTORS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.62.0` Allows configuring Data Streams extractors for transaction tracking {% /collapsible-section %} {% collapsible-section %} ### Instrumentation Telemetry{% #registry-telemetry %} (6) {% 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_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_FORWARDER_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` Bootstrap initialization telemetry: path to an executable used to forward tracer activation telemetry as JSON. If unset, bootstrap initialization telemetry is disabled (no forwarding).`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_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_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables Remote Config polling in the tracer (fetches configuration updates from the remote config endpoint and applies them to subscribed products). Default: true.`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 %} (31) {% 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**: `v1.56.0` Enables OpenTelemetry metrics export. Metrics are disabled by default and are only enabled when this is set to a truthy value.`DD_TRACE_OTEL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables the Datadog SDK's OpenTelemetry interoperability for traces.`OTEL_EXPORTER_OTLP_ENDPOINT` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.56.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**: `v1.56.0` **Description**: Specifies a comma-separated list of key-value pairs to be used as headers on all outgoing OTLP requests (for example, `api-key=key,other-config=value`).`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.62.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**: `string` **Since**: `v1.62.0` **Aliases**:`OTEL_EXPORTER_OTLP_HEADERS` Specifies a comma-separated list of key-value pairs to be used as headers on outgoing OTLP logs requests. Takes precedence over the general `OTEL_EXPORTER_OTLP_HEADERS`.`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `SDK-dependent, but will typically be either http/protobuf or grpc.` **Since**: `v1.62.0` Specifies the OTLP transport protocol for logs. Takes precedence over `OTEL_EXPORTER_OTLP_PROTOCOL`. : **Accepted values**: `grpc`, `http/protobuf`, `http/json``OTEL_EXPORTER_OTLP_LOGS_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v1.62.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**: `v1.56.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**: `string` **Since**: `v1.56.0` **Aliases**:`OTEL_EXPORTER_OTLP_HEADERS` Sets additional headers to include in OTLP exporter requests for metrics. When set, it takes precedence over OTEL_EXPORTER_OTLP_HEADERS for metrics export.`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.56.0` Specifies the OTLP transport protocol to use for metrics data. Takes precedence over the general `OTEL_EXPORTER_OTLP_PROTOCOL`. **Accepted values**: `grpc`, `http/protobuf`, `http/json`.`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.56.0` **Description**: Specifies the aggregation `temporality` to use for each instrument kind. **Notes**: This default value `delta` is Datadog's recommended configuration and differs from the OpenTelemetry specification's default.`OTEL_EXPORTER_OTLP_METRICS_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v1.56.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` **Since**: `v1.56.0` **Description**: Specifies the transport protocol to use for all signals unless overridden.`OTEL_EXPORTER_OTLP_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v1.56.0` Default timeout, in milliseconds, for OTLP export requests. Used as a fallback when a signal-specific timeout is not set.`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.61.0` **Aliases**:`OTEL_EXPORTER_OTLP_ENDPOINT` Configures the endpoint URL for OTLP trace submission, taking precedence over the fallback configuration OTEL_EXPORTER_OTLP_ENDPOINT. If the value of OTEL_EXPORTER_OTLP_ENDPOINT is used, then a signal-agnostic endpoint is assumed and a /v1/traces subpath must be appended when constructing the trace endpoint URL for http/protobuf and http/json protocols Default value: - gRPC: "http://localhost:4317" - HTTP: "http://localhost:4318/v1/traces" `OTEL_EXPORTER_OTLP_TRACES_HEADERS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.61.0` Configuration key to set custom headers for OTLP metrics export. Takes precedence over general OTLP headers. Format: api-key=key,other=value.`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.61.0` Configuration key to set the OTLP protocol for metrics export. Takes precedence over the general OTLP protocol setting. Valid values: grpc, http/protobuf, http/json.`OTEL_EXPORTER_OTLP_TRACES_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v1.61.0` Configuration key to set the request timeout for OTLP metrics export in milliseconds. Takes precedence over the general OTLP timeout setting.`OTEL_LOG_LEVEL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Configuration key to set the log level.`OTEL_LOGS_EXPORTER` {% icon name="icon-link-wui" /%} **Type**: `string` Controls the OpenTelemetry logs exporter selection. This setting is not supported and is ignored.`OTEL_METRIC_EXPORT_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v1.56.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**: `v1.56.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` **Description**: Specifies the metrics exporter to be used. **Notes**: The only accepted values are `otlp` and `none`. A value of `none` disables the emission of OTel metrics, as well as APM runtime metrics (equivalent to `DD_RUNTIME_METRICS_ENABLED=false`)`OTEL_PROPAGATORS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Specifies trace context propagation formats for both extraction and injection (comma-separated list). Lowest precedence; ignored if any other Datadog trace context propagation environment variable is set.`OTEL_RESOURCE_ATTRIBUTES` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Sets OpenTelemetry resource attributes that are mapped to tracer tags when the corresponding tracer tag setting is not set. Reserved attributes for service, environment, and version are mapped to standard tags, and only the first 10 attributes are applied.`OTEL_SDK_DISABLED` {% icon name="icon-link-wui" /%} **Type**: `string` Disables the Datadog SDK's OpenTelemetry interoperability for all signals. **Notes**: When set to `true`, this effectively sets `DD_TRACE_OTEL_ENABLED=false`, `DD_LOGS_OTEL_ENABLED=false`, and `DD_METRICS_OTEL_ENABLED=false`. **Ruby & Go SDKs**: The OpenTelemetry SDK activates automatically upon import and configuration, so this setting is not applicable.`OTEL_SERVICE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the application's default service name. Alias for `DD_SERVICE` when `DD_SERVICE` is not set.`OTEL_TRACES_EXPORTER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Configuration key to set the exporter for traces. Only the value `none` is recognized, which is equivalent to setting trace export to disabled.`OTEL_TRACES_SAMPLER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` Sets the trace sampler via OpenTelemetry configuration and maps it to the tracer's sample rate when the corresponding setting is not set. Parent-based samplers are supported; unsupported values are ignored.`OTEL_TRACES_SAMPLER_ARG` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v1.57.0` OpenTelemetry traces sampler argument (`otel.traces.sampler.arg` / `OTEL_TRACES_SAMPLER_ARG`): used when `OTEL_TRACES_SAMPLER=parentbased_traceidratio`; the value is treated as the traceidratio sample rate and mapped to Datadog's trace sample rate. Default: unset. {% /collapsible-section %} {% collapsible-section %} ### AI & LLM Observability{% #registry-ai_observability %} (8) {% 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**: `v1.55.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**: `v1.55.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**: `v1.55.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**: `v1.55.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**: `v1.55.0` Timeout used in calls to the AI Guard REST API in milliseconds (default 5000)`DD_LLMOBS_AGENTLESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Optional - *integer or string* - **default**: `false` Only required if you are not using the Datadog Agent, in which case this should be set to `1` or `true`.`DD_LLMOBS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Toggle to enable submitting data to LLM Observability`DD_LLMOBS_ML_APP` {% icon name="icon-link-wui" /%} **Type**: `string` Sets the default ML app name used for LLM Observability data. This value is required when LLM Observability is enabled. {% /collapsible-section %} {% collapsible-section %} ### Instrumentation & Platform{% #registry-instrumentation %} (9) {% icon name="icon-link-wui" /%} Instrumentation setup and platform-specific configuration: auto-injection, third-party library detection, and platform adapters. `DD_AZURE_APP_SERVICES` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` Enables Azure App Services mode. When enabled, the tracer adds Azure App Services environment tags (`aas.*`) to the local root span and profiling tags (derived from Azure environment variables such as `WEBSITE_*` and `DD_AAS_JAVA_EXTENSION_VERSION`).`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` Single Step Instrumentation (SSI): marker/metadata indicating the tracer was injected by SSI (and potentially which components were injected). When present, the bootstrap sets the instrumentation source to `ssi`, and other subsystems may use the value (for example, profiling treats it as injected when it contains `profiler`).`DD_INSTRUMENTATION_CONFIG_ID` {% icon name="icon-link-wui" /%} **Type**: `string` Telemetry metadata: instrumentation configuration id. When set, it is propagated in the tracer telemetry as a configuration entry named `instrumentation_config_id`, allowing correlation to the configuration/injection that produced this tracer setup.`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.`DD_THIRD_PARTY_DETECTION_EXCLUDES` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `[]` **Since**: `v1.56.0` Alias of `DD_THIRD_PARTY_EXCLUDES`. Live Debugging / Exception Replay: package prefixes to treat as first-party (exclude from the third-party library filter). This allowlist overrides the default third-party library list.`DD_THIRD_PARTY_DETECTION_INCLUDES` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `[]` **Since**: `v1.56.0` Comma-separated list of libraries to include in third-party detection. Default value is empty. {% /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**: `v1.56.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)})() **Note**: - If the same key type is set for both, the system property configuration takes priority. - System properties can be used as JVM parameters. - By default, JMX metrics from your application are sent to the Datadog Agent thanks to DogStatsD over port `8125`. Make sure that [DogStatsD is enabled for the Agent](https://docs.datadoghq.com/extend/dogstatsd.md#setup). - If you are running the Agent as a container, ensure that `DD_DOGSTATSD_NON_LOCAL_TRAFFIC` [is set to `true`](https://docs.datadoghq.com/agent/docker.md#dogstatsd-custom-metrics), and that port `8125` is open on the Agent container. - In Kubernetes, [bind the DogStatsD port to a host port](https://docs.datadoghq.com/extend/dogstatsd.md); in ECS, [set the appropriate flags in your task definition](https://docs.datadoghq.com/agent/amazon_ecs.md#create-an-ecs-task). ### Examples{% #examples %} #### `dd.service.mapping`{% #ddservicemapping %} Example with system property: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.service.mapping=postgresql:web-app-pg -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/service_mapping.1e4418c4e7268a9e5d7f9b4bdbec658c.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/service_mapping.1e4418c4e7268a9e5d7f9b4bdbec658c.png?auto=format&fit=max&w=850&dpr=2 2x" alt="service mapping" /%} #### `dd.tags`{% #ddtags %} Setting a global env for spans and JMX metrics: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/trace_global_tags.4924c1f09967c8f6142bb1f7038d1822.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/trace_global_tags.4924c1f09967c8f6142bb1f7038d1822.png?auto=format&fit=max&w=850&dpr=2 2x" alt="trace global tags" /%} #### `dd.trace.span.tags`{% #ddtracespantags %} Example with adding project:test to every span: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/trace_span_tags.b12c31702ad1ba44461b517dbffa45a5.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/trace_span_tags.b12c31702ad1ba44461b517dbffa45a5.png?auto=format&fit=max&w=850&dpr=2 2x" alt="trace span tags" /%} #### `dd.trace.jmx.tags`{% #ddtracejmxtags %} Setting custom.type:2 on a JMX metric: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -Ddd.trace.jmx.tags=custom.type:2 -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/trace_jmx_tags.ab1f3a6c1f86e1f8c3dae578bb95be87.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/trace_jmx_tags.ab1f3a6c1f86e1f8c3dae578bb95be87.png?auto=format&fit=max&w=850&dpr=2 2x" alt="trace JMX tags" /%} #### `dd.trace.methods`{% #ddtracemethods %} Example with system property: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.methods="hello.GreetingController[doSomeStuff,doSomeOtherStuff];hello.Randomizer[randomize]" -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/trace_methods.a4cf3dfe0943fd95ddc07a0c41b22f75.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/trace_methods.a4cf3dfe0943fd95ddc07a0c41b22f75.png?auto=format&fit=max&w=850&dpr=2 2x" alt="trace methods" /%} #### `dd.trace.db.client.split-by-instance`{% #ddtracedbclientsplit-by-instance %} Example with system property: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.env=dev -Ddd.service=web-app -Ddd.trace.db.client.split-by-instance=TRUE -jar path/to/application.jar ``` DB Instance 1, `webappdb`, now gets its own service name that is the same as the `db.instance` span metadata: {% image source="https://docs.dd-static.net/images/tracing/setup/java/split_by_instance_1.1b1cc98848cf748b3d517f040d2060de.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/split_by_instance_1.1b1cc98848cf748b3d517f040d2060de.png?auto=format&fit=max&w=850&dpr=2 2x" alt="instance 1" /%} DB Instance 2, `secondwebappdb`, now gets its own service name that is the same as the `db.instance` span metadata: {% image source="https://docs.dd-static.net/images/tracing/setup/java/split_by_instance_2.bfe603fda9eb49d96941c7db0e16e4c9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/split_by_instance_2.bfe603fda9eb49d96941c7db0e16e4c9.png?auto=format&fit=max&w=850&dpr=2 2x" alt="instance 2" /%} Similarly on the service map, you would now see one web app making calls to two different Postgres databases. #### `dd.http.server.tag.query-string`{% #ddhttpservertagquery-string %} Example with system property: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.http.server.tag.query-string=TRUE -jar path/to/application.jar ``` {% image source="https://docs.dd-static.net/images/tracing/setup/java/query_string.9b5adfddf595f54c9b29de7efd0309bd.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/query_string.9b5adfddf595f54c9b29de7efd0309bd.png?auto=format&fit=max&w=850&dpr=2 2x" alt="query string" /%} #### `dd.trace.enabled`{% #ddtraceenabled %} Example with system property and debug app mode: ```shell java -javaagent:/path/to/dd-java-agent.jar -Ddd.trace.enabled=false -Ddd.trace.debug=true -jar path/to/application.jar ``` Debug app logs show that `Tracing is disabled, not installing instrumentations.` #### `dd.jmxfetch.config.dir` and `dd.jmxfetch.config`{% #ddjmxfetchconfigdir-and-ddjmxfetchconfig %} Example configuration: - Either the combination of: `DD_JMXFETCH_CONFIG_DIR=` + `DD_JMXFETCH_CONFIG=conf.yaml` - Or directly: `DD_JMXFETCH_CONFIG=/conf.yaml` With the following content for `conf.yaml`: ```yaml init_config: instances: - jvm_direct: true port: '' conf: - include: bean: - java.lang:type=MemoryPool,name=Metaspace attribute: Usage.used: metric_type: gauge alias: sb.usage.used ``` Would produce the following result: {% image source="https://docs.dd-static.net/images/tracing/setup/java/jmxfetch_example.69f52b3d632f112e76941720a3ff4bd7.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/setup/java/jmxfetch_example.69f52b3d632f112e76941720a3ff4bd7.png?auto=format&fit=max&w=850&dpr=2 2x" alt="JMX fetch example" /%} See the [Java integration documentation](https://docs.datadoghq.com/integrations/java.md?tab=host#metric-collection) to learn more about Java metrics collection with JMX fetch. ## Further Reading{% #further-reading %} - [Datadog Java APM source code](https://github.com/DataDog/dd-trace-java) - [Explore your services, resources and traces](https://docs.datadoghq.com/tracing/glossary.md) - [Propagating trace context with headers](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)