--- title: Configuring the Node.js SDK description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: >- Docs > APM > Application Instrumentation > Configure the Datadog SDK > Configuring the Node.js SDK --- # Configuring the Node.js 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. It is recommended that you use `DD_ENV`, `DD_SERVICE`, and `DD_VERSION` to set `env`, `service`, and `version` for your services. Review the [Unified Service Tagging](https://docs.datadoghq.com/getting_started/tagging/unified_service_tagging.md) documentation for recommendations on configuring these environment variables. For more examples of how to work with the library see [API documentation](https://datadog.github.io/dd-trace-js/). ## Configurations keys{% #configurations-keys %} **474** configuration keys available for this library. {% collapsible-section open=null %} ### General Settings{% #registry-general %} (17) {% icon name="icon-link-wui" /%} Top-level Datadog configuration: API keys, service identity, Agent connection, intake site, hostname, global tags, and proxy settings. `DD_AGENT_HOST` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `127.0.0.1` **Since**: `v5.88.0` **Aliases**:`DD_TRACE_AGENT_HOSTNAME` The host name to use to connect the Datadog agent for traces. The host name can be IPv4, IPv6, or a domain name. If DD_TRACE_AGENT_URL is specified, the value of DD_AGENT_HOST is ignored.`DD_API_KEY` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` **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_FLUSH_DEADLINE_MILLISECONDS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `100` **Since**: `v5.83.0` Doesn't crash when spans are finished early and reached impending timeout`DD_APM_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **Aliases**:`DD_TRACING_ENABLED` Enables or disables sending APM trace data. When disabled, tracing still runs to support other products, but only periodic heartbeat traces and manually kept traces are sent.`DD_APP_KEY` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Sets the application key used to authenticate LLM Observability dataset and experiment requests in agentless mode. If agentless mode is enabled and this is not set, dataset/experiment operations that require an application key will fail.`DD_ENABLE_NX_SERVICE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Give DD_SERVICE precedence over NX_TASK_TARGET_PROJECT`DD_ENV` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` The application's environment. Sets the "env" tag on every span.`DD_EXTERNAL_ENV` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Sets an external environment identifier attached to emitted telemetry for origin and environment attribution.`DD_LAMBDA_HANDLER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` - Set the environment variable `DD_LAMBDA_HANDLER` to your original handler, for example, `myfunc.handler`. `DD_MINI_AGENT_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Sets the filesystem path used to reach the mini-agent for tracer communication in constrained environments.`DD_SERVERLESS_PUBSUB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` Enables new GCP PubSub Push subscription plugin for Node.js Distributed Tracing.`DD_SERVICE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` **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` **Since**: `v5.88.0` Provide service names for each plugin. Accepts comma separated plugin:service-name pairs, with or without spaces.`DD_SITE` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `datadoghq.com` **Since**: `v5.88.0` 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` **Since**: `v5.83.0` Custom tags applied to traces, profiles, and metrics, provided as comma-separated `key:value` pairs (for example, `layer:api,team:intake`).`DD_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables tracing behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_VERSION` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Your application version, set as the version tag on traces. {% collapsible-section #registry-retired-general %} #### 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_FLAGGING_PROVIDER_ENABLED` {% icon name="icon-link-wui" /%} Removed in v5.84.0. **Default**: `false` **Since**: `v5.83.0` To enable feature flagging capabilities in SDKs [PREVIEW] {% /collapsible-section %} {% /collapsible-section %} {% collapsible-section %} ### Tracing Core{% #registry-trace_core %} (23) {% icon name="icon-link-wui" /%} Core distributed tracing engine: Agent connection, trace and span ID generation, span lifecycle management, peer service mapping, resource normalization, query string obfuscation, and DB client configuration. `DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Controls whether 128-bit trace IDs are logged in their full 32-character format or truncated to 16 characters. Set to false for compatibility with systems that expect the shorter format.`DD_TRACE_AGENT_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8126` **Since**: `v5.83.0` The port of the Trace Agent that the tracer submits to. If the Agent configuration sets receiver_port or DD_APM_RECEIVER_PORT to something other than the default 8126, then DD_TRACE_AGENT_PORT or DD_TRACE_AGENT_URL must match it.`DD_TRACE_AGENT_PROTOCOL_VERSION` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `0.4` **Since**: `v5.83.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_URL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` **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_CLIENT_IP_HEADER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Name of an optional custom HTTP header used to resolve the client IP address.`DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10` **Since**: `v5.83.0` An integer representing the maximum depth of an AWS SDK request/reponse payload to use for AWS payload tagging.`DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` A comma-separated string of JSONPath entries to redact from AWS SDK responses. Setting this enables AWS payload tagging for responses.`DD_TRACE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **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_EXPORTER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Whether to write traces to log output or agentless, rather than send to an agent`DD_TRACE_EXPERIMENTAL_SPAN_COUNTS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables experimental span-count tracking so traces include aggregate span count metadata.`DD_TRACE_FLUSH_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `2000` **Since**: `v5.88.0` Interval in milliseconds at which the tracer will submit traces to the agent.`DD_TRACE_NATIVE_SPAN_EVENTS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Encode span events in the native `span_events` payload format instead of `meta.events` JSON.`DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP` {% 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)?)(?:(?:\s|%20)*(?:=|%3D)[^&]+|(?:"|%22)(?:\s|%20)*(?::|%3A)(?:\s|%20)*(?:"|%22)(?:%2[^2]|%[^2]|[^"%])+(?:"|%22))|bearer(?:\s|%20)+[a-z0-9\._\-]+|token(?::|%3A)[a-z0-9]{13}|gh[opsu]_[0-9a-zA-Z]{36}|ey[I-L](?:[\w=-]|%3D)+\.ey[I-L](?:[\w=-]|%3D)+(?:\.(?:[\w.+\/=-]|%3D|%2F|%2B)+)?|[\-]{5}BEGIN(?:[a-z\s]|%20)+PRIVATE(?:\s|%20)KEY[\-]{5}[^\-]+[\-]{5}END(?:[a-z\s]|%20)+PRIVATE(?:\s|%20)KEY|ssh-rsa(?:\s|%20)*(?:[a-z0-9\/\.+]|%2F|%5C|%2B){100,}` **Since**: `v5.88.0` Applies a regex to redact sensitive data from query strings on incoming HTTP requests. The default regex matches various sensitive data patterns, including passwords, tokens, API keys, private keys, and authorization terms. Matches are replaced with. If an empty string is passed, no obfuscation occurs. The resulting value is reported in the http.url tag.`DD_TRACE_PARTIAL_FLUSH_MIN_SPANS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1000` **Since**: `v5.88.0` 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` **Since**: `v5.83.0` Maps detected peer service names to normalized values before they are attached to spans.`DD_TRACE_REPORT_HOSTNAME` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Whether to report the system's hostname for each trace. When disabled, the hostname of the Agent is used instead.`DD_TRACE_SCOPE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Selects the async context propagation implementation used to keep trace context across asynchronous boundaries.`DD_TRACE_SPAN_ATTRIBUTE_SCHEMA` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `v0` **Since**: `v5.88.0` Selects the span attribute and naming schema version used by integrations. Accepted values: `v0`, `v1`.`DD_TRACE_SPAN_LEAK_DEBUG` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` **Since**: `v5.83.0` 0: Disabled, 1: logging, 2: garbage collection + logging`DD_TRACE_STATS_COMPUTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables trace-stats computation in the tracer for stats payload generation and ingestion-side metrics.`DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `512` **Since**: `v5.83.0` Maximum length of the `x-datadog-tags` header for trace tag propagation. Set to 0 to disable. {% collapsible-section #registry-retired-trace_core %} #### 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_TRACE_GLOBAL_TAGS` {% icon name="icon-link-wui" /%} Removed in v5.88.0. **Type**: `map` **Since**: `v5.83.0` 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. {% /collapsible-section %} {% /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**: `array` **Since**: `v5.88.0` Span sampling rules to keep individual spans when the rest of the trace would otherwise be dropped. A JSON array of objects. Rules are applied in configured order to determine the span's sample rate. The sample_rate value must be between 0.0 and 1.0 (inclusive). For more information, see Ingestion Mechanisms. Example: - Set the span sample rate to 50% for the service my-service and operation name http.request, up to 50 traces per second: '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'`DD_SPAN_SAMPLING_RULES_FILE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.88.0` **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**: `array` **Since**: `v5.83.0` Configures custom sampling rules for traces. Rules are evaluated in order, and the first matching rule determines the sampling rate. If no rules match, the default sampling rate is used. For more information about how these configurations affect trace ingestion, see Ingestion Mechanisms.`DD_TRACE_WEBSOCKET_MESSAGES_INHERIT_SAMPLING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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 %} (11) {% icon name="icon-link-wui" /%} Distributed trace context propagation, extraction and injection behavior, baggage handling, header tagging, HTTP client and server configuration, and SQL comment injection for Database Monitoring. `DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.93.0` Controls whether process-level tags (such as entrypoint metadata) are collected and attached to tracing payloads.`DD_TRACE_BAGGAGE_MAX_BYTES` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8192` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Comma-separated list of baggage keys to copy into span tags. Set to * to tag all baggage items; if unset, a default allowlist is used.`DD_TRACE_EXPERIMENTAL_B3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables instrumentation for experimental b3. When disabled, spans for experimental b3 operations are not created.`DD_TRACE_HEADER_TAGS` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.83.0` Comma-separated list of HTTP headers to apply automatically as span tags. Each entry can be either a bare header name (which is reported under `http.request.headers.
` for incoming requests and `http.response.headers.
` for outgoing responses) or `
:` to control the tag key.`DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `continue` **Since**: `v5.88.0` Specifies how incoming distributed tracing headers should be handled at a service level. Accepted values are: `continue`: The SDK will continue the distributed trace if the incoming distributed tracing headers represent a valid trace context. `restart`: The SDK will always start a new trace. If the incoming distributed tracing headers represent a valid trace context, that trace context will be represented as a span link on service entry spans (as opposed to the parent span in the `continue` configuration). `ignore`: The SDK will always start a new trace and all incoming distributed tracing headers are ignored.`DD_TRACE_PROPAGATION_EXTRACT_FIRST` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` When set to true, stops extracting after the first successful trace context extraction.`DD_TRACE_PROPAGATION_STYLE` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `datadog,tracecontext,baggage` **Since**: `v5.88.0` **Aliases**:`OTEL_PROPAGATORS` A comma-separated list of header formats from which to attempt to inject and extract distributed tracing propagation data. The first format found with complete and valid headers is used to define the trace to continue. The more specific DD_TRACE_PROPAGATION_STYLE_INJECT and DD_TRACE_PROPAGATION_STYLE_EXTRACT configurations take priority when present.`DD_TRACE_PROPAGATION_STYLE_EXTRACT` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `datadog, tracecontext, baggage` **Since**: `v5.88.0` **Aliases**:`DD_TRACE_PROPAGATION_STYLE` A comma-separated list of header formats from which to attempt to extract distributed tracing propagation data. The first format found with complete and valid headers is used to define the trace to continue.`DD_TRACE_PROPAGATION_STYLE_INJECT` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `datadog, tracecontext, baggage` **Since**: `v5.88.0` **Aliases**:`DD_TRACE_PROPAGATION_STYLE` Comma-separated list of header formats to include to propagate distributed traces between services. {% /collapsible-section %} {% collapsible-section %} ### Trace Integrations{% #registry-trace_integrations %} (217) {% 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_GRPC_CLIENT_ERROR_STATUSES` {% icon name="icon-link-wui" /%} **Type**: `array` **Default**: `1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16` **Since**: `v5.83.0` 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**: `array` **Default**: `2,3,4,5,6,7,8,9,10,11,12,13,14,15,16` **Since**: `v5.83.0` 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_TRACE_DISABLED_INSTRUMENTATIONS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Set the `DD_TRACE_DISABLED_INSTRUMENTATIONS` environment variable to a comma-separated list of integration names to disable.`DD_TRACE_DISABLED_PLUGINS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Comma-separated plugin IDs to disable; prevents those integrations from being auto-instrumented. #### 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` (209 integrations) {% icon name="icon-link-wui" /%} Enable or disable tracing for a specific integration. Available integrations:`AI`, `AMQP10`, `AMQPLIB`, `ANTHROPIC`, `APOLLO`, `APOLLO_GATEWAY`, `APOLLO_SERVER`, `APOLLO_SERVER_CORE`, `APOLLO_SERVER_EXPRESS`, `APOLLO_SERVER_FASTIFY`, `APOLLO_SUBGRAPH`, `AVSC`, `AWS_SDK_AWS`, `AWS_SDK_AWS_BATCH_PROPAGATION`, `AWS_SDK_BATCH_PROPAGATION`, `AWS_SDK_BEDROCKRUNTIME`, `AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION`, `AWS_SDK_CLOUDWATCHLOGS`, `AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION`, `AWS_SDK_DYNAMODB`, `AWS_SDK_DYNAMODB_BATCH_PROPAGATION`, `AWS_SDK_EVENTBRIDGE`, `AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION`, `AWS_SDK_KINESIS`, `AWS_SDK_KINESIS_BATCH_PROPAGATION`, `AWS_SDK_LAMBDA`, `AWS_SDK_LAMBDA_BATCH_PROPAGATION`, `AWS_SDK_NODE_HTTP_HANDLER`, `AWS_SDK_REDSHIFT`, `AWS_SDK_REDSHIFT_BATCH_PROPAGATION`, `AWS_SDK_S3`, `AWS_SDK_S3_BATCH_PROPAGATION`, `AWS_SDK_SFN`, `AWS_SDK_SFN_BATCH_PROPAGATION`, `AWS_SDK_SFN_CLIENT`, `AWS_SDK_SMITHY_CLIENT`, `AWS_SDK_SNS`, `AWS_SDK_SNS_BATCH_PROPAGATION`, `AWS_SDK_SQS`, `AWS_SDK_SQS_BATCH_PROPAGATION`, `AWS_SDK_STATES`, `AWS_SDK_STATES_BATCH_PROPAGATION`, `AWS_SDK_STEPFUNCTIONS`, `AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION`, `AXIOS`, `AZURE_EVENT_HUBS`, `AZURE_EVENTHUBS_BATCH_LINKS`, `AZURE_SERVICE_BUS`, `AZURE_SERVICEBUS_BATCH_LINKS`, `BLUEBIRD`, `BODY_PARSER`, `BSON`, `BULLMQ`, `BUNYAN`, `CASSANDRA_DRIVER`, `CHILD_PROCESS`, `CLIENT_IP`, `COLLECTIONS`, `COMMONPLUGIN`, `CONFLUENTINC_KAFKA_JAVASCRIPT`, `CONNECT`, `COOKIE`, `COOKIE_PARSER`, `CRYPTO`, `CUCUMBER_CUCUMBER`, `CYPRESS`, `DNS`, `ELASTIC_ELASTICSEARCH`, `ELASTIC_TRANSPORT`, `ELASTICSEARCH`, `EXPRESS`, `EXPRESS_MONGO_SANITIZE`, `EXPRESS_SESSION`, `FASTIFY`, `FETCH`, `FIND_MY_WAY`, `FS`, `GCP_PUBSUB_PUSH`, `GENERIC_POOL`, `GIT_METADATA`, `GOOGLE_CLOUD_PUBSUB`, `GOOGLE_CLOUD_VERTEXAI`, `GOOGLE_GAX`, `GOOGLE_GENAI`, `GRAPHQL`, `GRAPHQL_TAG`, `GRAPHQL_TOOLS`, `GRAPHQL_TOOLS_EXECUTOR`, `GRAPHQL_YOGA`, `GRPC`, `GRPC_GRPC_JS`, `GRPC_PROTO_LOADER`, `HANDLEBARS`, `HAPI`, `HAPI_BOOM`, `HAPI_HAPI`, `HONO`, `HTTP`, `HTTP2`, `HTTPS`, `INFERRED_PROXY_SERVICES`, `IOREDIS`, `IOVALKEY`, `JEST`, `JEST_CIRCUS`, `JEST_CONFIG`, `JEST_CORE`, `JEST_ENVIRONMENT_JSDOM`, `JEST_ENVIRONMENT_NODE`, `JEST_GLOBALS`, `JEST_REPORTERS`, `JEST_RUNTIME`, `JEST_TEST_SEQUENCER`, `JEST_TRANSFORM`, `JEST_WORKER`, `KAFKAJS`, `KNEX`, `KOA`, `KOA_ROUTE`, `KOA_ROUTER`, `KOA_WEBSOCKET`, `LANGCHAIN`, `LANGCHAIN_ANTHROPIC`, `LANGCHAIN_COHERE`, `LANGCHAIN_CORE`, `LANGCHAIN_GOOGLE_GENAI`, `LANGCHAIN_OPENAI`, `LANGGRAPH`, `LDAPJS`, `LDAPJS_PROMISE`, `LEGACY_BAGGAGE`, `LIMITD_CLIENT`, `LODASH`, `LOOPBACK`, `MARIADB`, `MEMCACHED`, `MEMCACHED_COMMAND`, `MICROGATEWAY_CORE`, `MIDDIE`, `MIDDLEWARE_TRACING`, `MOCHA`, `MOCHA_EACH`, `MOLECULER`, `MONGODB`, `MONGODB_CORE`, `MONGODB_HEARTBEAT`, `MONGOOSE`, `MQUERY`, `MULTER`, `MYSQL`, `MYSQL2`, `NET`, `NEXT`, `NODE_CHILD_PROCESS`, `NODE_REDIS_CLIENT`, `NODE_SERIALIZE`, `NYC`, `OPENAI`, `OPENSEARCH`, `OPENSEARCH_PROJECT_OPENSEARCH`, `OPENTELEMETRY_SDK_TRACE_NODE`, `ORACLEDB`, `PASSPORT`, `PASSPORT_HTTP`, `PASSPORT_LOCAL`, `PEER_SERVICE_DEFAULTS`, `PG`, `PG_CURSOR`, `PG_NATIVE`, `PG_QUERY_STREAM`, `PINO`, `PINO_PRETTY`, `PLAYWRIGHT`, `PLAYWRIGHT_CORE`, `PLAYWRIGHT_TEST`, `PRISMA`, `PROCESS`, `PROMISE`, `PROMISE_JS`, `PROTOBUFJS`, `PUG`, `Q`, `REACT`, `REACT_DOM`, `REDIS`, `REDIS_CLIENT`, `REMOVE_INTEGRATION_SERVICE_NAMES`, `REQUEST`, `RESOURCE_RENAMING`, `RESTIFY`, `RHEA`, `ROUTER`, `SELENIUM_WEBDRIVER`, `SEQUELIZE`, `SHAREDB`, `SMITHY_SMITHY_CLIENT`, `SQLITE3`, `SUFFIXPLUGIN`, `TEDIOUS`, `UNDICI`, `URL`, `VITEST`, `VITEST_RUNNER`, `VM`, `WEBSOCKET_MESSAGES`, `WHEN`, `WINSTON`, `WORKERPOOL`, `WS` {% /collapsible-section %} #### Per-Integration Settings (211 integrations) Each section lists all configuration keys available for a specific integration. {% collapsible-section #integration-ai %} #### AI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for ai. When disabled, spans for ai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-amqp10 %} #### AMQP10 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AMQP10_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for amqp10. When disabled, spans for amqp10 operations are not created. {% /collapsible-section %} {% collapsible-section #integration-amqplib %} #### AMQPLIB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AMQPLIB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for amqplib. When disabled, spans for amqplib operations are not created. {% /collapsible-section %} {% collapsible-section #integration-anthropic %} #### ANTHROPIC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ANTHROPIC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for anthropic. When disabled, spans for anthropic operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo %} #### APOLLO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo. When disabled, spans for apollo operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-gateway %} #### APOLLO_GATEWAY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_GATEWAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo gateway. When disabled, spans for apollo gateway operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-server %} #### APOLLO_SERVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_SERVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo server. When disabled, spans for apollo server operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-server-core %} #### APOLLO_SERVER_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_SERVER_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo server core. When disabled, spans for apollo server core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-server-express %} #### APOLLO_SERVER_EXPRESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_SERVER_EXPRESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo server express. When disabled, spans for apollo server express operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-server-fastify %} #### APOLLO_SERVER_FASTIFY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_SERVER_FASTIFY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo server fastify. When disabled, spans for apollo server fastify operations are not created. {% /collapsible-section %} {% collapsible-section #integration-apollo-subgraph %} #### APOLLO_SUBGRAPH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_APOLLO_SUBGRAPH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for apollo subgraph. When disabled, spans for apollo subgraph operations are not created. {% /collapsible-section %} {% collapsible-section #integration-avsc %} #### AVSC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AVSC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for avsc. When disabled, spans for avsc operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws %} #### AWS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_ADD_SPAN_POINTERS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables or disables span pointers on AWS requests. Default value is true {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-aws %} #### AWS_SDK_AWS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_AWS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk aws. When disabled, spans for aws sdk aws operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-aws-batch-propagation %} #### AWS_SDK_AWS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_AWS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk aws batch propagation. When disabled, spans for aws sdk aws batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-batch-propagation %} #### AWS_SDK_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk batch propagation. When disabled, spans for aws sdk batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-bedrockruntime %} #### AWS_SDK_BEDROCKRUNTIME (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_BEDROCKRUNTIME_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk bedrockruntime. When disabled, spans for aws sdk bedrockruntime operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-bedrockruntime-batch-propagation %} #### AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk bedrockruntime batch propagation. When disabled, spans for aws sdk bedrockruntime batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-cloudwatchlogs %} #### AWS_SDK_CLOUDWATCHLOGS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_CLOUDWATCHLOGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk cloudwatchlogs. When disabled, spans for aws sdk cloudwatchlogs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-cloudwatchlogs-batch-propagation %} #### AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk cloudwatchlogs batch propagation. When disabled, spans for aws sdk cloudwatchlogs batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-dynamodb %} #### AWS_SDK_DYNAMODB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_DYNAMODB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk dynamodb. When disabled, spans for aws sdk dynamodb operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-dynamodb-batch-propagation %} #### AWS_SDK_DYNAMODB_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_DYNAMODB_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk dynamodb batch propagation. When disabled, spans for aws sdk dynamodb batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-eventbridge %} #### AWS_SDK_EVENTBRIDGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_EVENTBRIDGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk eventbridge. When disabled, spans for aws sdk eventbridge operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-eventbridge-batch-propagation %} #### AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk eventbridge batch propagation. When disabled, spans for aws sdk eventbridge batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-kinesis %} #### AWS_SDK_KINESIS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_KINESIS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk kinesis. When disabled, spans for aws sdk kinesis operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-kinesis-batch-propagation %} #### AWS_SDK_KINESIS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_KINESIS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk kinesis batch propagation. When disabled, spans for aws sdk kinesis batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-lambda %} #### AWS_SDK_LAMBDA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_LAMBDA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk lambda. When disabled, spans for aws sdk lambda operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-lambda-batch-propagation %} #### AWS_SDK_LAMBDA_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_LAMBDA_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk lambda batch propagation. When disabled, spans for aws sdk lambda batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-node-http-handler %} #### AWS_SDK_NODE_HTTP_HANDLER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_NODE_HTTP_HANDLER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk node http handler. When disabled, spans for aws sdk node http handler operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-redshift %} #### AWS_SDK_REDSHIFT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_REDSHIFT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk redshift. When disabled, spans for aws sdk redshift operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-redshift-batch-propagation %} #### AWS_SDK_REDSHIFT_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_REDSHIFT_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk redshift batch propagation. When disabled, spans for aws sdk redshift batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-s3 %} #### AWS_SDK_S3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_S3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk s3. When disabled, spans for aws sdk s3 operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-s3-batch-propagation %} #### AWS_SDK_S3_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_S3_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk s3 batch propagation. When disabled, spans for aws sdk s3 batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sfn %} #### AWS_SDK_SFN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SFN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sfn. When disabled, spans for aws sdk sfn operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sfn-batch-propagation %} #### AWS_SDK_SFN_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SFN_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sfn batch propagation. When disabled, spans for aws sdk sfn batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sfn-client %} #### AWS_SDK_SFN_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SFN_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sfn client. When disabled, spans for aws sdk sfn client operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-smithy-client %} #### AWS_SDK_SMITHY_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SMITHY_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk smithy client. When disabled, spans for aws sdk smithy client operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sns %} #### AWS_SDK_SNS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SNS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sns. When disabled, spans for aws sdk sns operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sns-batch-propagation %} #### AWS_SDK_SNS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SNS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sns batch propagation. When disabled, spans for aws sdk sns batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sqs %} #### AWS_SDK_SQS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SQS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sqs. When disabled, spans for aws sdk sqs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-sqs-batch-propagation %} #### AWS_SDK_SQS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_SQS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk sqs batch propagation. When disabled, spans for aws sdk sqs batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-states %} #### AWS_SDK_STATES (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_STATES_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk states. When disabled, spans for aws sdk states operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-states-batch-propagation %} #### AWS_SDK_STATES_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_STATES_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk states batch propagation. When disabled, spans for aws sdk states batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-stepfunctions %} #### AWS_SDK_STEPFUNCTIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_STEPFUNCTIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk stepfunctions. When disabled, spans for aws sdk stepfunctions operations are not created. {% /collapsible-section %} {% collapsible-section #integration-aws-sdk-stepfunctions-batch-propagation %} #### AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for aws sdk stepfunctions batch propagation. When disabled, spans for aws sdk stepfunctions batch propagation operations are not created. {% /collapsible-section %} {% collapsible-section #integration-axios %} #### AXIOS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AXIOS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for axios. When disabled, spans for axios operations are not created. {% /collapsible-section %} {% collapsible-section #integration-azure-event-hubs %} #### AZURE_EVENT_HUBS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AZURE_EVENT_HUBS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for azure event hubs. When disabled, spans for azure event hubs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-azure-eventhubs-batch-links %} #### AZURE_EVENTHUBS_BATCH_LINKS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AZURE_EVENTHUBS_BATCH_LINKS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for azure eventhubs batch links. When disabled, spans for azure eventhubs batch links operations are not created. {% /collapsible-section %} {% collapsible-section #integration-azure-service-bus %} #### AZURE_SERVICE_BUS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AZURE_SERVICE_BUS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for azure service bus. When disabled, spans for azure service bus operations are not created. {% /collapsible-section %} {% collapsible-section #integration-azure-servicebus-batch-links %} #### AZURE_SERVICEBUS_BATCH_LINKS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_AZURE_SERVICEBUS_BATCH_LINKS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for azure servicebus batch links. When disabled, spans for azure servicebus batch links operations are not created. {% /collapsible-section %} {% collapsible-section #integration-bluebird %} #### BLUEBIRD (1) {% icon name="icon-link-wui" /%} `DD_TRACE_BLUEBIRD_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for bluebird. When disabled, spans for bluebird operations are not created. {% /collapsible-section %} {% collapsible-section #integration-body-parser %} #### BODY_PARSER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_BODY_PARSER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for body parser. When disabled, spans for body parser operations are not created. {% /collapsible-section %} {% collapsible-section #integration-bson %} #### BSON (1) {% icon name="icon-link-wui" /%} `DD_TRACE_BSON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for bson. When disabled, spans for bson operations are not created. {% /collapsible-section %} {% collapsible-section #integration-bullmq %} #### BULLMQ (1) {% icon name="icon-link-wui" /%} `DD_TRACE_BULLMQ_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for bullmq. When disabled, spans for bullmq operations are not created. {% /collapsible-section %} {% collapsible-section #integration-bunyan %} #### BUNYAN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_BUNYAN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for bunyan. When disabled, spans for bunyan operations are not created. {% /collapsible-section %} {% collapsible-section #integration-cassandra-driver %} #### CASSANDRA_DRIVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CASSANDRA_DRIVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for cassandra driver. When disabled, spans for cassandra driver operations are not created. {% /collapsible-section %} {% collapsible-section #integration-child-process %} #### CHILD_PROCESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CHILD_PROCESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for child process. When disabled, spans for child process operations are not created. {% /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` **Since**: `v5.83.0` 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-collections %} #### COLLECTIONS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COLLECTIONS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for collections. When disabled, spans for collections operations are not created. {% /collapsible-section %} {% collapsible-section #integration-commonplugin %} #### COMMONPLUGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COMMONPLUGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for commonplugin. When disabled, spans for commonplugin operations are not created. {% /collapsible-section %} {% collapsible-section #integration-confluentinc-kafka-javascript %} #### CONFLUENTINC_KAFKA_JAVASCRIPT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CONFLUENTINC_KAFKA_JAVASCRIPT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for confluentinc kafka javascript. When disabled, spans for confluentinc kafka javascript operations are not created. {% /collapsible-section %} {% collapsible-section #integration-connect %} #### CONNECT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CONNECT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for connect. When disabled, spans for connect operations are not created. {% /collapsible-section %} {% collapsible-section #integration-cookie %} #### COOKIE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COOKIE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for cookie. When disabled, spans for cookie operations are not created. {% /collapsible-section %} {% collapsible-section #integration-cookie-parser %} #### COOKIE_PARSER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_COOKIE_PARSER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for cookie parser. When disabled, spans for cookie parser operations are not created. {% /collapsible-section %} {% collapsible-section #integration-crypto %} #### CRYPTO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CRYPTO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for crypto. When disabled, spans for crypto operations are not created. {% /collapsible-section %} {% collapsible-section #integration-cucumber-cucumber %} #### CUCUMBER_CUCUMBER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CUCUMBER_CUCUMBER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for cucumber cucumber. When disabled, spans for cucumber cucumber operations are not created. {% /collapsible-section %} {% collapsible-section #integration-cypress %} #### CYPRESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_CYPRESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for cypress. When disabled, spans for cypress operations are not created. {% /collapsible-section %} {% collapsible-section #integration-dns %} #### DNS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DNS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for dns. When disabled, spans for dns operations are not created. {% /collapsible-section %} {% collapsible-section #integration-dynamodb %} #### DYNAMODB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_DYNAMODB_TABLE_PRIMARY_KEYS` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` JSON object mapping DynamoDB table names to primary key field names (1-2) used for span pointers. {% /collapsible-section %} {% collapsible-section #integration-elastic-elasticsearch %} #### ELASTIC_ELASTICSEARCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTIC_ELASTICSEARCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for elastic elasticsearch. When disabled, spans for elastic elasticsearch operations are not created. {% /collapsible-section %} {% collapsible-section #integration-elastic-transport %} #### ELASTIC_TRANSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTIC_TRANSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for elastic transport. When disabled, spans for elastic transport operations are not created. {% /collapsible-section %} {% collapsible-section #integration-elasticsearch %} #### ELASTICSEARCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ELASTICSEARCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for elasticsearch. When disabled, spans for elasticsearch operations are not created. {% /collapsible-section %} {% collapsible-section #integration-express %} #### EXPRESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EXPRESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Disable loading instrumentations using DD_TRACE__ENABLED {% /collapsible-section %} {% collapsible-section #integration-express-mongo-sanitize %} #### EXPRESS_MONGO_SANITIZE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EXPRESS_MONGO_SANITIZE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for express mongo sanitize. When disabled, spans for express mongo sanitize operations are not created. {% /collapsible-section %} {% collapsible-section #integration-express-session %} #### EXPRESS_SESSION (1) {% icon name="icon-link-wui" /%} `DD_TRACE_EXPRESS_SESSION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for express session. When disabled, spans for express session operations are not created. {% /collapsible-section %} {% collapsible-section #integration-fastify %} #### FASTIFY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FASTIFY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for fastify. When disabled, spans for fastify operations are not created. {% /collapsible-section %} {% collapsible-section #integration-fetch %} #### FETCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FETCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for fetch. When disabled, spans for fetch operations are not created. {% /collapsible-section %} {% collapsible-section #integration-find-my-way %} #### FIND_MY_WAY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FIND_MY_WAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for find my way. When disabled, spans for find my way operations are not created. {% /collapsible-section %} {% collapsible-section #integration-fs %} #### FS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_FS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for fs. When disabled, spans for fs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-gcp-pubsub-push %} #### GCP_PUBSUB_PUSH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GCP_PUBSUB_PUSH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for gcp pubsub push. When disabled, spans for gcp pubsub push operations are not created. {% /collapsible-section %} {% collapsible-section #integration-generic-pool %} #### GENERIC_POOL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GENERIC_POOL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for generic pool. When disabled, spans for generic pool operations are not created. {% /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` **Since**: `v5.83.0` 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-google-cloud-pubsub %} #### GOOGLE_CLOUD_PUBSUB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_CLOUD_PUBSUB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for google cloud pubsub. When disabled, spans for google cloud pubsub operations are not created. {% /collapsible-section %} {% collapsible-section #integration-google-cloud-vertexai %} #### GOOGLE_CLOUD_VERTEXAI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_CLOUD_VERTEXAI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for google cloud vertexai. When disabled, spans for google cloud vertexai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-google-gax %} #### GOOGLE_GAX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_GAX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for google gax. When disabled, spans for google gax operations are not created. {% /collapsible-section %} {% collapsible-section #integration-google-genai %} #### GOOGLE_GENAI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GOOGLE_GENAI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for google genai. When disabled, spans for google genai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-graphql %} #### GRAPHQL (2) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for graphql. When disabled, spans for graphql operations are not created.`DD_TRACE_GRAPHQL_ERROR_EXTENSIONS` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.83.0` Comma-separated list of GraphQL error extension keys to capture as span tags. When unset, no extensions are captured. {% /collapsible-section %} {% collapsible-section #integration-graphql-tag %} #### GRAPHQL_TAG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_TAG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for graphql tag. When disabled, spans for graphql tag operations are not created. {% /collapsible-section %} {% collapsible-section #integration-graphql-tools %} #### GRAPHQL_TOOLS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_TOOLS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for graphql tools. When disabled, spans for graphql tools operations are not created. {% /collapsible-section %} {% collapsible-section #integration-graphql-tools-executor %} #### GRAPHQL_TOOLS_EXECUTOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_TOOLS_EXECUTOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for graphql tools executor. When disabled, spans for graphql tools executor operations are not created. {% /collapsible-section %} {% collapsible-section #integration-graphql-yoga %} #### GRAPHQL_YOGA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRAPHQL_YOGA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for graphql yoga. When disabled, spans for graphql yoga operations are not created. {% /collapsible-section %} {% collapsible-section #integration-grpc %} #### GRPC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for grpc. When disabled, spans for grpc operations are not created. {% /collapsible-section %} {% collapsible-section #integration-grpc-grpc-js %} #### GRPC_GRPC_JS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_GRPC_JS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for grpc grpc js. When disabled, spans for grpc grpc js operations are not created. {% /collapsible-section %} {% collapsible-section #integration-grpc-proto-loader %} #### GRPC_PROTO_LOADER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_GRPC_PROTO_LOADER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for grpc proto loader. When disabled, spans for grpc proto loader operations are not created. {% /collapsible-section %} {% collapsible-section #integration-handlebars %} #### HANDLEBARS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HANDLEBARS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for handlebars. When disabled, spans for handlebars operations are not created. {% /collapsible-section %} {% collapsible-section #integration-hapi %} #### HAPI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HAPI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for hapi. When disabled, spans for hapi operations are not created. {% /collapsible-section %} {% collapsible-section #integration-hapi-boom %} #### HAPI_BOOM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HAPI_BOOM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for hapi boom. When disabled, spans for hapi boom operations are not created. {% /collapsible-section %} {% collapsible-section #integration-hapi-hapi %} #### HAPI_HAPI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HAPI_HAPI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for hapi hapi. When disabled, spans for hapi hapi operations are not created. {% /collapsible-section %} {% collapsible-section #integration-hono %} #### HONO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HONO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for hono. When disabled, spans for hono operations are not created. {% /collapsible-section %} {% collapsible-section #integration-http %} #### HTTP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for http. When disabled, spans for http operations are not created. {% /collapsible-section %} {% collapsible-section #integration-http2 %} #### HTTP2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTP2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for http2. When disabled, spans for http2 operations are not created. {% /collapsible-section %} {% collapsible-section #integration-https %} #### HTTPS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_HTTPS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for https. When disabled, spans for https operations are not created. {% /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**: `v5.83.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-ioredis %} #### IOREDIS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_IOREDIS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for ioredis. When disabled, spans for ioredis operations are not created. {% /collapsible-section %} {% collapsible-section #integration-iovalkey %} #### IOVALKEY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_IOVALKEY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for iovalkey. When disabled, spans for iovalkey operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest %} #### JEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest. When disabled, spans for jest operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-circus %} #### JEST_CIRCUS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_CIRCUS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest circus. When disabled, spans for jest circus operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-config %} #### JEST_CONFIG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_CONFIG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest config. When disabled, spans for jest config operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-core %} #### JEST_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest core. When disabled, spans for jest core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-environment-jsdom %} #### JEST_ENVIRONMENT_JSDOM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_ENVIRONMENT_JSDOM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest environment jsdom. When disabled, spans for jest environment jsdom operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-environment-node %} #### JEST_ENVIRONMENT_NODE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_ENVIRONMENT_NODE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest environment node. When disabled, spans for jest environment node operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-globals %} #### JEST_GLOBALS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_GLOBALS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest globals. When disabled, spans for jest globals operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-reporters %} #### JEST_REPORTERS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_REPORTERS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest reporters. When disabled, spans for jest reporters operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-runtime %} #### JEST_RUNTIME (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_RUNTIME_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest runtime. When disabled, spans for jest runtime operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-test-sequencer %} #### JEST_TEST_SEQUENCER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_TEST_SEQUENCER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest test sequencer. When disabled, spans for jest test sequencer operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-transform %} #### JEST_TRANSFORM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_TRANSFORM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest transform. When disabled, spans for jest transform operations are not created. {% /collapsible-section %} {% collapsible-section #integration-jest-worker %} #### JEST_WORKER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_JEST_WORKER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for jest worker. When disabled, spans for jest worker operations are not created. {% /collapsible-section %} {% collapsible-section #integration-kafkajs %} #### KAFKAJS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KAFKAJS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for kafkajs. When disabled, spans for kafkajs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-knex %} #### KNEX (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KNEX_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for knex. When disabled, spans for knex operations are not created. {% /collapsible-section %} {% collapsible-section #integration-koa %} #### KOA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KOA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for koa. When disabled, spans for koa operations are not created. {% /collapsible-section %} {% collapsible-section #integration-koa-route %} #### KOA_ROUTE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KOA_ROUTE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for koa route. When disabled, spans for koa route operations are not created. {% /collapsible-section %} {% collapsible-section #integration-koa-router %} #### KOA_ROUTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KOA_ROUTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for koa router. When disabled, spans for koa router operations are not created. {% /collapsible-section %} {% collapsible-section #integration-koa-websocket %} #### KOA_WEBSOCKET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_KOA_WEBSOCKET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for koa websocket. When disabled, spans for koa websocket operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain %} #### LANGCHAIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain. When disabled, spans for langchain operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain-anthropic %} #### LANGCHAIN_ANTHROPIC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_ANTHROPIC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain anthropic. When disabled, spans for langchain anthropic operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain-cohere %} #### LANGCHAIN_COHERE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_COHERE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain cohere. When disabled, spans for langchain cohere operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain-core %} #### LANGCHAIN_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain core. When disabled, spans for langchain core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain-google-genai %} #### LANGCHAIN_GOOGLE_GENAI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_GOOGLE_GENAI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain google genai. When disabled, spans for langchain google genai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langchain-openai %} #### LANGCHAIN_OPENAI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGCHAIN_OPENAI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for langchain openai. When disabled, spans for langchain openai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-langgraph %} #### LANGGRAPH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LANGGRAPH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.91.0` To enable the LangGraph Integration. {% /collapsible-section %} {% collapsible-section #integration-ldapjs %} #### LDAPJS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LDAPJS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for ldapjs. When disabled, spans for ldapjs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-ldapjs-promise %} #### LDAPJS_PROMISE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LDAPJS_PROMISE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for ldapjs promise. When disabled, spans for ldapjs promise operations are not created. {% /collapsible-section %} {% collapsible-section #integration-legacy-baggage %} #### LEGACY_BAGGAGE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LEGACY_BAGGAGE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for legacy baggage. When disabled, spans for legacy baggage operations are not created. {% /collapsible-section %} {% collapsible-section #integration-limitd-client %} #### LIMITD_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LIMITD_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for limitd client. When disabled, spans for limitd client operations are not created. {% /collapsible-section %} {% collapsible-section #integration-lodash %} #### LODASH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LODASH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for lodash. When disabled, spans for lodash operations are not created. {% /collapsible-section %} {% collapsible-section #integration-loopback %} #### LOOPBACK (1) {% icon name="icon-link-wui" /%} `DD_TRACE_LOOPBACK_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for loopback. When disabled, spans for loopback operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mariadb %} #### MARIADB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MARIADB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mariadb. When disabled, spans for mariadb operations are not created. {% /collapsible-section %} {% collapsible-section #integration-memcached %} #### MEMCACHED (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MEMCACHED_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for memcached. When disabled, spans for memcached operations are not created. {% /collapsible-section %} {% collapsible-section #integration-memcached-command %} #### MEMCACHED_COMMAND (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MEMCACHED_COMMAND_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enable memcached command tagging if DD_TRACE_MEMCACHED_COMMAND_ENABLED is enabled {% /collapsible-section %} {% collapsible-section #integration-microgateway-core %} #### MICROGATEWAY_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MICROGATEWAY_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for microgateway core. When disabled, spans for microgateway core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-middie %} #### MIDDIE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MIDDIE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for middie. When disabled, spans for middie operations are not created. {% /collapsible-section %} {% collapsible-section #integration-middleware-tracing %} #### MIDDLEWARE_TRACING (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MIDDLEWARE_TRACING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for middleware tracing. When disabled, spans for middleware tracing operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mocha %} #### MOCHA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MOCHA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mocha. When disabled, spans for mocha operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mocha-each %} #### MOCHA_EACH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MOCHA_EACH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mocha each. When disabled, spans for mocha each operations are not created. {% /collapsible-section %} {% collapsible-section #integration-moleculer %} #### MOLECULER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MOLECULER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for moleculer. When disabled, spans for moleculer operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mongodb %} #### MONGODB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGODB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mongodb. When disabled, spans for mongodb operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mongodb-core %} #### MONGODB_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGODB_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mongodb core. When disabled, spans for mongodb core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mongodb-heartbeat %} #### MONGODB_HEARTBEAT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGODB_HEARTBEAT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mongodb heartbeat. When disabled, spans for mongodb heartbeat operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mongoose %} #### MONGOOSE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MONGOOSE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mongoose. When disabled, spans for mongoose operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mquery %} #### MQUERY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MQUERY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mquery. When disabled, spans for mquery operations are not created. {% /collapsible-section %} {% collapsible-section #integration-multer %} #### MULTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MULTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for multer. When disabled, spans for multer operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mysql %} #### MYSQL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MYSQL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mysql. When disabled, spans for mysql operations are not created. {% /collapsible-section %} {% collapsible-section #integration-mysql2 %} #### MYSQL2 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_MYSQL2_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for mysql2. When disabled, spans for mysql2 operations are not created. {% /collapsible-section %} {% collapsible-section #integration-net %} #### NET (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NET_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for net. When disabled, spans for net operations are not created. {% /collapsible-section %} {% collapsible-section #integration-next %} #### NEXT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NEXT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for next. When disabled, spans for next operations are not created. {% /collapsible-section %} {% collapsible-section #integration-node-child-process %} #### NODE_CHILD_PROCESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NODE_CHILD_PROCESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for node child process. When disabled, spans for node child process operations are not created. {% /collapsible-section %} {% collapsible-section #integration-node-redis-client %} #### NODE_REDIS_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NODE_REDIS_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for node redis client. When disabled, spans for node redis client operations are not created. {% /collapsible-section %} {% collapsible-section #integration-node-serialize %} #### NODE_SERIALIZE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NODE_SERIALIZE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for node serialize. When disabled, spans for node serialize operations are not created. {% /collapsible-section %} {% collapsible-section #integration-nyc %} #### NYC (1) {% icon name="icon-link-wui" /%} `DD_TRACE_NYC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for nyc. When disabled, spans for nyc operations are not created. {% /collapsible-section %} {% collapsible-section #integration-openai %} #### OPENAI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENAI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for openai. When disabled, spans for openai operations are not created. {% /collapsible-section %} {% collapsible-section #integration-opensearch %} #### OPENSEARCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for opensearch. When disabled, spans for opensearch operations are not created. {% /collapsible-section %} {% collapsible-section #integration-opensearch-project-opensearch %} #### OPENSEARCH_PROJECT_OPENSEARCH (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENSEARCH_PROJECT_OPENSEARCH_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for opensearch project opensearch. When disabled, spans for opensearch project opensearch operations are not created. {% /collapsible-section %} {% collapsible-section #integration-opentelemetry-sdk-trace-node %} #### OPENTELEMETRY_SDK_TRACE_NODE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_OPENTELEMETRY_SDK_TRACE_NODE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for opentelemetry sdk trace node. When disabled, spans for opentelemetry sdk trace node operations are not created. {% /collapsible-section %} {% collapsible-section #integration-oracledb %} #### ORACLEDB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ORACLEDB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for oracledb. When disabled, spans for oracledb operations are not created. {% /collapsible-section %} {% collapsible-section #integration-passport %} #### PASSPORT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PASSPORT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for passport. When disabled, spans for passport operations are not created. {% /collapsible-section %} {% collapsible-section #integration-passport-http %} #### PASSPORT_HTTP (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PASSPORT_HTTP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for passport http. When disabled, spans for passport http operations are not created. {% /collapsible-section %} {% collapsible-section #integration-passport-local %} #### PASSPORT_LOCAL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PASSPORT_LOCAL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for passport local. When disabled, spans for passport local operations are not created. {% /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` **Since**: `v5.83.0` When enabled, the tracer computes default `peer.service` values for eligible spans using the v1 peer-service default algorithm under Naming Schema v0. When disabled, Naming Schema v0 leaves `peer.service` unset. {% /collapsible-section %} {% collapsible-section #integration-pg %} #### PG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pg. When disabled, spans for pg operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pg-cursor %} #### PG_CURSOR (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PG_CURSOR_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pg cursor. When disabled, spans for pg cursor operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pg-native %} #### PG_NATIVE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PG_NATIVE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pg native. When disabled, spans for pg native operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pg-query-stream %} #### PG_QUERY_STREAM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PG_QUERY_STREAM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pg query stream. When disabled, spans for pg query stream operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pino %} #### PINO (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PINO_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pino. When disabled, spans for pino operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pino-pretty %} #### PINO_PRETTY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PINO_PRETTY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pino pretty. When disabled, spans for pino pretty operations are not created. {% /collapsible-section %} {% collapsible-section #integration-playwright %} #### PLAYWRIGHT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAYWRIGHT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for playwright. When disabled, spans for playwright operations are not created. {% /collapsible-section %} {% collapsible-section #integration-playwright-core %} #### PLAYWRIGHT_CORE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAYWRIGHT_CORE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for playwright core. When disabled, spans for playwright core operations are not created. {% /collapsible-section %} {% collapsible-section #integration-playwright-test %} #### PLAYWRIGHT_TEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PLAYWRIGHT_TEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for playwright test. When disabled, spans for playwright test operations are not created. {% /collapsible-section %} {% collapsible-section #integration-prisma %} #### PRISMA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PRISMA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for prisma. When disabled, spans for prisma operations are not created. {% /collapsible-section %} {% collapsible-section #integration-process %} #### PROCESS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROCESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for process. When disabled, spans for process operations are not created. {% /collapsible-section %} {% collapsible-section #integration-promise %} #### PROMISE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROMISE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for promise. When disabled, spans for promise operations are not created. {% /collapsible-section %} {% collapsible-section #integration-promise-js %} #### PROMISE_JS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROMISE_JS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for promise js. When disabled, spans for promise js operations are not created. {% /collapsible-section %} {% collapsible-section #integration-protobufjs %} #### PROTOBUFJS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PROTOBUFJS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for protobufjs. When disabled, spans for protobufjs operations are not created. {% /collapsible-section %} {% collapsible-section #integration-pug %} #### PUG (1) {% icon name="icon-link-wui" /%} `DD_TRACE_PUG_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for pug. When disabled, spans for pug operations are not created. {% /collapsible-section %} {% collapsible-section #integration-q %} #### Q (1) {% icon name="icon-link-wui" /%} `DD_TRACE_Q_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for q. When disabled, spans for q operations are not created. {% /collapsible-section %} {% collapsible-section #integration-react %} #### REACT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for react. When disabled, spans for react operations are not created. {% /collapsible-section %} {% collapsible-section #integration-react-dom %} #### REACT_DOM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REACT_DOM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for react dom. When disabled, spans for react dom operations are not created. {% /collapsible-section %} {% collapsible-section #integration-redis %} #### REDIS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REDIS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.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-redis-client %} #### REDIS_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REDIS_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for redis client. When disabled, spans for redis client operations are not created. {% /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` **Since**: `v5.83.0` 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-request %} #### REQUEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_REQUEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for request. When disabled, spans for request operations are not created. {% /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**: `v5.83.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-restify %} #### RESTIFY (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RESTIFY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for restify. When disabled, spans for restify operations are not created. {% /collapsible-section %} {% collapsible-section #integration-rhea %} #### RHEA (1) {% icon name="icon-link-wui" /%} `DD_TRACE_RHEA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for rhea. When disabled, spans for rhea operations are not created. {% /collapsible-section %} {% collapsible-section #integration-router %} #### ROUTER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_ROUTER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for router. When disabled, spans for router operations are not created. {% /collapsible-section %} {% collapsible-section #integration-selenium-webdriver %} #### SELENIUM_WEBDRIVER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SELENIUM_WEBDRIVER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for selenium webdriver. When disabled, spans for selenium webdriver operations are not created. {% /collapsible-section %} {% collapsible-section #integration-sequelize %} #### SEQUELIZE (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SEQUELIZE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for sequelize. When disabled, spans for sequelize operations are not created. {% /collapsible-section %} {% collapsible-section #integration-sharedb %} #### SHAREDB (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SHAREDB_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for sharedb. When disabled, spans for sharedb operations are not created. {% /collapsible-section %} {% collapsible-section #integration-smithy-smithy-client %} #### SMITHY_SMITHY_CLIENT (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SMITHY_SMITHY_CLIENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for smithy smithy client. When disabled, spans for smithy smithy client operations are not created. {% /collapsible-section %} {% collapsible-section #integration-sqlite3 %} #### SQLITE3 (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SQLITE3_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for sqlite3. When disabled, spans for sqlite3 operations are not created. {% /collapsible-section %} {% collapsible-section #integration-suffixplugin %} #### SUFFIXPLUGIN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_SUFFIXPLUGIN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for suffixplugin. When disabled, spans for suffixplugin operations are not created. {% /collapsible-section %} {% collapsible-section #integration-tedious %} #### TEDIOUS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_TEDIOUS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for tedious. When disabled, spans for tedious operations are not created. {% /collapsible-section %} {% collapsible-section #integration-undici %} #### UNDICI (1) {% icon name="icon-link-wui" /%} `DD_TRACE_UNDICI_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for undici. When disabled, spans for undici operations are not created. {% /collapsible-section %} {% collapsible-section #integration-url %} #### URL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_URL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for url. When disabled, spans for url operations are not created. {% /collapsible-section %} {% collapsible-section #integration-vitest %} #### VITEST (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VITEST_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for vitest. When disabled, spans for vitest operations are not created. {% /collapsible-section %} {% collapsible-section #integration-vitest-runner %} #### VITEST_RUNNER (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VITEST_RUNNER_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for vitest runner. When disabled, spans for vitest runner operations are not created. {% /collapsible-section %} {% collapsible-section #integration-vm %} #### VM (1) {% icon name="icon-link-wui" /%} `DD_TRACE_VM_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for vm. When disabled, spans for vm operations are not created. {% /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**: `v5.83.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` **Since**: `v5.83.0` 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-when %} #### WHEN (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WHEN_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for when. When disabled, spans for when operations are not created. {% /collapsible-section %} {% collapsible-section #integration-winston %} #### WINSTON (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WINSTON_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for winston. When disabled, spans for winston operations are not created. {% /collapsible-section %} {% collapsible-section #integration-workerpool %} #### WORKERPOOL (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WORKERPOOL_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for workerpool. When disabled, spans for workerpool operations are not created. {% /collapsible-section %} {% collapsible-section #integration-ws %} #### WS (1) {% icon name="icon-link-wui" /%} `DD_TRACE_WS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables instrumentation for ws. When disabled, spans for ws operations are not created. {% /collapsible-section %} {% collapsible-section #registry-retired-trace_integrations %} #### 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_TRACE_DD_TRACE_API_ENABLED` {% icon name="icon-link-wui" /%} Removed in v5.88.0. **Since**: `v5.83.0` Enables instrumentation for dd trace api. When disabled, spans for dd trace api operations are not created. {% /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**: `v5.88.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` **Since**: `v5.83.0` 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 %} (6) {% icon name="icon-link-wui" /%} Tracer log output settings: log levels, log file paths, log rotation, and startup diagnostics. `DD_LOG_LEVEL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Sets the Datadog logging level. Valid values are trace, debug, info, warn, error, critical, or off.`DD_TRACE_BEAUTIFUL_LOGS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Pretty-print JSON payloads in tracer debug logs (adds indentation).`DD_TRACE_DEBUG` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.88.0` **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_ENCODING_DEBUG` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables trace-encoding debug diagnostics to troubleshoot serialization and payload formatting issues.`DD_TRACE_EXPERIMENTAL_STATE_TRACKING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables experimental internal tracer state tracking for diagnostics and troubleshooting.`DD_TRACE_LOG_LEVEL` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `debug` **Since**: `v5.88.0` **Aliases**:`DD_LOG_LEVEL`, `OTEL_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. {% /collapsible-section %} {% collapsible-section %} ### Continuous Profiling{% #registry-profiling %} (25) {% icon name="icon-link-wui" /%} Continuous Profiler configuration: enable/disable, upload settings, profiling types, engine options, code hotspots, endpoint profiling, and experimental features. `DD_EXPERIMENTAL_PROFILING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.88.0` **Aliases**:`DD_PROFILING_ENABLED` Enables experimental profiling behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_PROFILING_ASYNC_CONTEXT_FRAME_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables profiling async context frame behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_PROFILING_CODEHOTSPOTS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **Aliases**:`DD_PROFILING_EXPERIMENTAL_CODEHOTSPOTS_ENABLED` Enables or disables code hotspots collection for the continuous profiler. When disabled, profiling data is not linked to tracing context for hotspot attribution.`DD_PROFILING_CPU_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **Aliases**:`DD_PROFILING_EXPERIMENTAL_CPU_ENABLED` If set to `false`, disables the CPU profiling. Defaults to `true`.`DD_PROFILING_DEBUG_SOURCE_MAPS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables profiling source-map debug diagnostics to troubleshoot source-map lookup and symbolization behavior.`DD_PROFILING_DEBUG_UPLOAD_COMPRESSION` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `zstd` **Since**: `v5.83.0` **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**: `boolean` **Default**: `false` **Since**: `v5.83.0` **Aliases**:`DD_EXPERIMENTAL_PROFILING_ENABLED` Enables the continuous profiler, which collects CPU, heap, goroutine, and other runtime profiles and uploads them to Datadog.`DD_PROFILING_ENDPOINT_COLLECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **Aliases**:`DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED` Controls whether spans add a pprof label with the top-level request endpoint so profiles can be grouped by endpoint in the Datadog UI.`DD_PROFILING_EXPERIMENTAL_CODEHOTSPOTS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` **Aliases**:`DD_PROFILING_CODEHOTSPOTS_ENABLED` Prioritize non-experimental env variables and warn about experimental ones`DD_PROFILING_EXPERIMENTAL_CPU_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` **Aliases**:`DD_PROFILING_CPU_ENABLED` If set to `false`, disables the CPU profiling. Defaults to `true`.`DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` **Aliases**:`DD_PROFILING_ENDPOINT_COLLECTION_ENABLED` Enables profiling experimental endpoint collection behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_PROFILING_EXPERIMENTAL_OOM_EXPORT_STRATEGIES` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `process` **Since**: `v5.83.0` Sends a heap profile on OOM with async callback`DD_PROFILING_EXPERIMENTAL_OOM_HEAP_LIMIT_EXTENSION_SIZE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` **Since**: `v5.83.0` Sends a heap profile on OOM with async callback`DD_PROFILING_EXPERIMENTAL_OOM_MAX_HEAP_EXTENSION_COUNT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` **Since**: `v5.83.0` Sends a heap profile on OOM with async callback`DD_PROFILING_EXPERIMENTAL_OOM_MONITORING_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Support OOM heap profiler configuration`DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` **Aliases**:`DD_PROFILING_TIMELINE_ENABLED` - Set environment variable `DD_PROFILING_TIMELINE_ENABLED` to `true` `DD_PROFILING_EXPORTERS` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `agent` **Since**: `v5.83.0` Code hotspots and endpoint tracing works`DD_PROFILING_HEAP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` If set to `true`, enables Live Heap profiling (in Preview). Defaults to `false`.`DD_PROFILING_HEAP_SAMPLING_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `524288` **Since**: `v5.83.0` Sets the heap profiler sampling interval, affecting memory profiling granularity and runtime overhead.`DD_PROFILING_PPROF_PREFIX` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Sets a filename prefix for generated pprof profile files to control profiler output naming.`DD_PROFILING_PROFILERS` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `space,wall` **Since**: `v5.83.0` Support profiler config with DD_PROFILING_PROFILERS`DD_PROFILING_SOURCE_MAP` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Configures source-map resolution used by the profiler to map generated stack frames back to original source locations.`DD_PROFILING_TIMELINE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **Aliases**:`DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED` Enable the timeline profile type **Note**: This supersedes the `DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED` environment variable. (`datadog.profiling.experimental_timeline_enabled` INI setting), If both are set, this one takes precedence. **Language-specific notes:** - **PHP**: This supersedes the `datadog.profiling.experimental_timeline_enabled` INI setting, which was available since `0.89` `DD_PROFILING_UPLOAD_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `60000` **Since**: `v5.88.0` Time in milliseconds between each upload`DD_PROFILING_V8_PROFILER_BUG_WORKAROUND` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Support profiler config with DD_PROFILING_PROFILERS {% /collapsible-section %} {% collapsible-section %} ### Application Security{% #registry-appsec %} (37) {% icon name="icon-link-wui" /%} Application Security configuration: ASM threat detection and blocking, user event tracking, IAST vulnerability detection, API Security schema discovery, and error tracking. `DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `0.5` **Since**: `v5.87.0` Defines the probability of a downstream request body being sampled, or said differently, defines the overall number of requests for which the request and response body should be sampled / analysed.`DD_API_SECURITY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` **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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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**: `v5.87.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` **Default**: `identification` **Since**: `v5.88.0` **Aliases**:`DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING` Specifies which collection mode to use for automated user events.`DD_APPSEC_COLLECT_ALL_HEADERS` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` When enabled, AppSec collects all request headers for security analysis instead of only the default allowlisted subset. Because header values can contain sensitive information, this flag should be used carefully; header redaction and obfuscation settings still apply. The header-collection rules (which headers are always collected vs collected only on certain events) remain in effect unless this flag forces collection of every header`DD_APPSEC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Since**: `v5.88.0` Enable Application Security Management features.`DD_APPSEC_GRAPHQL_BLOCKED_TEMPLATE_JSON` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Path to a local JSON response template that replaces the default backend template when the tracer performs a block action for a GraphQL request. If unset or the file cannot be read the tracer falls back to the built-in default blocking template`DD_APPSEC_HEADER_COLLECTION_REDACTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` When enabled the tracer applies the AppSec header/value redaction policies to any header values it collects. Header redaction uses configured regexps and obfuscation rules to replace sensitive substrings with a stable redaction token; this flag prevents accidental leak of PII in headers collected for AppSec detection or telemetry`DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` 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` **Since**: `v5.88.0` Path to a local JSON template file that will be returned when a request is blocked and the response should be JSON. If unset or invalid, the tracer uses the default blocking HTML template defined by the product RFC. The tracer decides HTML or JSON according to `Accept` header or the block action's parameters.`DD_APPSEC_MAX_COLLECTED_HEADERS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `50` **Since**: `v5.83.0` Caps the number of headers the tracer will store/forward for AppSec purposes to avoid extremely wide span/tag vectors and large payloads. Headers beyond the configured cap are handled according to tracer policy (skipped or only name-collected). This limit protects performance and privacy; use the header collection docs for guidance on safe values.`DD_APPSEC_MAX_STACK_TRACE_DEPTH` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `32` **Since**: `v5.83.0` **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` **Since**: `v5.83.0` **Aliases**:`DD_APPSEC_MAX_STACKTRACES` Limits how many separate stacktraces are captured and attached to an AppSec/IAST event to keep payload sizes reasonable. Evidence stacktraces are useful for triage, but unbounded capture can leak sensitive data and consume excessive bandwidth; this limit balances evidence value and safety. Set to 0 to collect all.`DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `(?i)pass|pw(?:or)?d|secret|(?:api|private|public|access)[_-]?key|token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)|bearer|authorization|jsessionid|phpsessid|asp\.net[_-]sessionid|sid|jwt` **Since**: `v5.88.0` Regular expression used by the AppSec obfuscator to identify parameter keys whose entire value must be redacted. When a key path matches, the parameter is replaced with ``. The default matches common credential names (password, token, authorization, jwt, etc.). Set to an empty string to disable key-based redaction.`DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `(?i)(?:p(?:ass)?w(?:or)?d|pass(?:[_-]?phrase)?|secret(?:[_-]?key)?|(?:(?:api|private|public|access)[_-]?)key(?:[_-]?id)?|(?:(?:auth|access|id|refresh)[_-]?)?token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?|jsessionid|phpsessid|asp\.net(?:[_-]|-)sessionid|sid|jwt)(?:\s*=([^;&]+)|"\s*:\s*("[^"]+"|\d+))|bearer\s+([a-z0-9\._\-]+)|token\s*:\s*([a-z0-9]{13})|gh[opsu]_([0-9a-zA-Z]{36})|ey[I-L][\w=-]+\.(ey[I-L][\w=-]+(?:\.[\w.+\/=-]+)?)|[\-]{5}BEGIN[a-z\s]+PRIVATE\sKEY[\-]{5}([^\-]+)[\-]{5}END[a-z\s]+PRIVATE\sKEY|ssh-rsa\s*([a-z0-9\/\.+]{100,})` **Since**: `v5.88.0` A regex string to redact sensitive data by its value in attack reports.`DD_APPSEC_RASP_COLLECT_REQUEST_BODY` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Controls whether the RASP (runtime exploit-prevention) collectors include the request body when performing detection or making block decisions. Request bodies can contain sensitive data and large payloads, so collection obeys size limits and obfuscation rules.`DD_APPSEC_RASP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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` **Since**: `v5.88.0` Override the default rules file provided. Must be a path to a valid JSON rules file`DD_APPSEC_SCA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Since**: `v5.88.0` 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` **Since**: `v5.83.0` **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` **Since**: `v5.83.0` Controls the maximum amount of AppSec traces, per second.`DD_APPSEC_WAF_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `5000` **Since**: `v5.88.0` Limits the WAF synchronous execution time (in microseconds).`DD_EXPERIMENTAL_APPSEC_STANDALONE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Disable apm tracing with legacy DD_EXPERIMENTAL_APPSEC_STANDALONE_ENABLED`DD_IAST_DB_ROWS_TO_TAINT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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**: `boolean` **Default**: `false` **Since**: `v5.88.0` Enables or disables IAST. Default value is false (disabled).`DD_IAST_MAX_CONCURRENT_REQUESTS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `2` **Since**: `v5.83.0` Maximum number of requests to be analyzed by IAST concurrently. Default value is 2.`DD_IAST_MAX_CONTEXT_OPERATIONS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `2` **Since**: `v5.83.0` Controls how many code vulnerabilities can be detected in the same request`DD_IAST_REDACTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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)?|(?:sur|last)name|user(?:name)?|address|e?mail)` **Since**: `v5.83.0` Specifies a regex that will redact sensitive source names in vulnerability reports.`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,})|[\w\.-]+@[a-zA-Z\d\.-]+\.[a-zA-Z]{2,})` **Since**: `v5.83.0` Specifies a regex that will redact sensitive source values in vulnerability reports.`DD_IAST_REQUEST_SAMPLING` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `30` **Since**: `v5.83.0` Percentage of requests to be analyzed by IAST, between 1 and 100. Default value is 30.`DD_IAST_SECURITY_CONTROLS_CONFIGURATION` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` 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` **Since**: `v5.88.0` **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` **Since**: `v5.88.0` IAST: controls IAST telemetry verbosity (`OFF`, `MANDATORY`, `INFORMATION`, `DEBUG`). When tracer telemetry is disabled, this is forced to `OFF`. Default: `INFORMATION`. {% /collapsible-section %} {% collapsible-section %} ### Dynamic Instrumentation & Debugging{% #registry-debugging %} (8) {% 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**: `true` **Since**: `v5.83.0` Enables code origin for spans behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_CODE_ORIGIN_FOR_SPANS_EXPERIMENTAL_EXIT_SPANS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables code origin for spans experimental exit spans behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT_MS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `15` **Since**: `v5.83.0` Timeout in milliseconds for capturing variable values during snapshot collection.`DD_DYNAMIC_INSTRUMENTATION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` 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` **Since**: `v5.88.0` Path to a local probe definition JSON file. When set, the tracer loads probe definitions from this file at startup instead of subscribing to remote configuration.`DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.83.0` Comma-separated list of additional identifier keywords to redact in captured snapshot data`DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.88.0` Environment variable to exclude identifiers from redaction`DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `1` **Since**: `v5.83.0` Interval in seconds between uploads of probe data. {% /collapsible-section %} {% collapsible-section %} ### CI Visibility{% #registry-civisibility %} (47) {% 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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**: `boolean` **Default**: `false` **Since**: `v5.88.0` Identifies the auto instrumentation provider for CI Visibility. This is used to track which instrumentation method was used (e.g., single-step, manual, etc.).`DD_CIVISIBILITY_DANGEROUSLY_FORCE_COVERAGE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Force-enables CI Visibility code coverage collection for debugging, even when remote settings disable it.`DD_CIVISIBILITY_DANGEROUSLY_FORCE_TEST_SKIPPING` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Force-enables test skipping logic for debugging, even when remote settings disable it.`DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Enables or disables Intelligent Test Runner in CI Visibility. Default Value is false (disabled).`DD_CIVISIBILITY_MANUAL_API_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables CI Visibility manual API mode for reporting test events programmatically without framework auto-instrumentation.`DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `500` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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_TEST_MODULE_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` CI Visibility test module identifier used to correlate spans across worker processes.`DD_CIVISIBILITY_TEST_SESSION_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` CI Visibility test session trace identifier used to correlate spans across worker processes.`DD_CUSTOM_TRACE_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Custom trace ID propagated by the Jenkins Datadog Plugin, used to correlate Jenkins pipeline executions with traces emitted by the application under test.`DD_EXPERIMENTAL_TEST_OPT_GIT_CACHE_DIR` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `${os.tmpdir()}/dd-trace-git-cache` **Since**: `v5.83.0` Directory path used to persist the Test Optimization Git cache between runs.`DD_EXPERIMENTAL_TEST_OPT_GIT_CACHE_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables experimental test opt git cache behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_EXPERIMENTAL_TEST_OPT_SETTINGS_CACHE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.85.0` Enables caching of Test Optimization settings to reduce repeated remote-configuration lookups between runs.`DD_GIT_BRANCH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Overrides the git commit author email reported as CI metadata.`DD_GIT_COMMIT_AUTHOR_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Overrides the git commit author name reported as CI metadata.`DD_GIT_COMMIT_COMMITTER_DATE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Overrides the git commit committer email reported as CI metadata.`DD_GIT_COMMIT_COMMITTER_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Overrides the git commit committer name reported as CI metadata.`DD_GIT_COMMIT_HEAD_SHA` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Overrides the git commit message reported as CI metadata.`DD_GIT_COMMIT_SHA` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Overrides the git commit SHA reported as CI metadata and used for git metadata tagging when enabled.`DD_GIT_FOLDER_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Disables telemetry if inside a jest worker`DD_GIT_PROPERTIES_FILE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Disables telemetry if inside a jest worker`DD_GIT_PULL_REQUEST_BASE_BRANCH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Overrides the Git tag used by CI Visibility for repository and release correlation.`DD_PIPELINE_EXECUTION_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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_PLAYWRIGHT_WORKER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Internal marker (set to `1`) used to detect Playwright worker processes for CI Visibility IPC payload routing.`DD_TEST_FAILED_TEST_REPLAY_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.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_FLEET_CONFIG_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Disable stats if config property is used`DD_TEST_LOCAL_CONFIG_PATH` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Disable stats if config property is used`DD_TEST_MANAGEMENT_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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.`DD_TEST_TIA_KEEP_COV_CONFIG` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.89.0` Allow the user to keep jest's code coverage configuration even if test optimization's test impact analysis is enabled {% /collapsible-section %} {% collapsible-section %} ### Crash Tracking & Diagnostics{% #registry-crashtracking %} (4) {% 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` **Since**: `v5.83.0` 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.`DD_HEAP_SNAPSHOT_COUNT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `0` **Since**: `v5.83.0` Number of heap snapshots to write. Set to 0 to disable.`DD_HEAP_SNAPSHOT_DESTINATION` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Directory path where heap snapshots are written.`DD_HEAP_SNAPSHOT_INTERVAL` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `3600` **Since**: `v5.83.0` Sets the delay between heap snapshots in seconds, affecting snapshot frequency and memory-profiling overhead. The first snapshot is created after an initial full delay. {% /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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Overrides the intake URL used when agentless log submission is enabled.`DD_LOGS_INJECTION` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.88.0` 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**: `v5.83.0` Enables collection and export of logs produced via the OpenTelemetry Logs API. {% /collapsible-section %} {% collapsible-section %} ### Runtime Metrics{% #registry-runtime_metrics %} (6) {% icon name="icon-link-wui" /%} Runtime metrics collection and DogStatsD connection configuration for metric submission. `DD_DOGSTATSD_HOST` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `localhost` **Since**: `v5.83.0` **Aliases**:`DD_DOGSTATSD_HOSTNAME` 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_PORT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `8125` **Since**: `v5.83.0` 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**: `false` **Since**: `v5.83.0` Enables or disables the collection of runtime metrics (such as garbage collection stats, memory usage, and thread counts) for the application.`DD_RUNTIME_METRICS_EVENT_LOOP_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables runtime metrics event loop behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_RUNTIME_METRICS_GC_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` Enables runtime metrics gc behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` **Aliases**:`DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED` When enabled, adds a runtime-id tag to runtime metrics to distinguish individual processes. {% /collapsible-section %} {% collapsible-section %} ### Data Streams Monitoring{% #registry-data_streams %} (1) {% icon name="icon-link-wui" /%} Data Streams Monitoring for tracking end-to-end latency across message queues and streaming pipelines. `DD_DATA_STREAMS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables Data Streams Monitoring (DSM) and its checkpoint propagation. When enabled, the tracer registers the DSM propagator and reports pathway statistics and payloads. {% /collapsible-section %} {% collapsible-section %} ### Instrumentation Telemetry{% #registry-telemetry %} (6) {% icon name="icon-link-wui" /%} Tracer self-reporting telemetry: heartbeat intervals, dependency and log collection, and telemetry forwarder configuration. `DD_TELEMETRY_DEBUG` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables debug mode for instrumentation telemetry. When set, it forces telemetry debug mode on regardless of other configuration.`DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `true` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` 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` **Since**: `v5.88.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` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Controls whether instrumentation telemetry sends internal metrics. {% /collapsible-section %} {% collapsible-section %} ### Remote Configuration{% #registry-remote_config %} (2) {% icon name="icon-link-wui" /%} Remote Configuration for receiving live configuration updates from Datadog. `DD_REMOTE_CONFIG_POLL_INTERVAL_SECONDS` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `5.0` **Since**: `v5.83.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` **Since**: `v5.83.0` **Aliases**:`DD_REMOTE_CONFIG_ENABLED` Enable or disable remote configuration. {% /collapsible-section %} {% collapsible-section %} ### OpenTelemetry Compatibility{% #registry-otel %} (28) {% 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**: `v5.83.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` **Since**: `v5.83.0` Enables the Datadog SDK's OpenTelemetry interoperability for traces.`OTEL_BSP_MAX_EXPORT_BATCH_SIZE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `512` **Since**: `v5.83.0` Sets the maximum number of items exported per OpenTelemetry batch processor flush.`OTEL_BSP_MAX_QUEUE_SIZE` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `2048` **Since**: `v5.83.0` Maximum logs to queue before dropping`OTEL_BSP_SCHEDULE_DELAY` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `5000` **Since**: `v5.83.0` Sets the delay between OpenTelemetry batch processor export cycles, in milliseconds.`OTEL_EXPORTER_OTLP_ENDPOINT` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.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**: `v5.88.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**: `v5.83.0` **Aliases**:`OTEL_EXPORTER_OTLP_ENDPOINT` URL for sending OTLP logs. Takes precedence over `OTEL_EXPORTER_OTLP_ENDPOINT`. Defaults to `http://localhost:4317` for gRPC and `http://localhost:4318/v1/logs` for HTTP.`OTEL_EXPORTER_OTLP_LOGS_HEADERS` {% icon name="icon-link-wui" /%} **Type**: `map` **Since**: `v5.88.0` **Aliases**:`OTEL_EXPORTER_OTLP_HEADERS` A map of headers to apply to all outgoing otlp logs.`OTEL_EXPORTER_OTLP_LOGS_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `http/protobuf` **Since**: `v5.88.0` **Aliases**:`OTEL_EXPORTER_OTLP_PROTOCOL` Specifies the OTLP transport protocol to be used for log data.`OTEL_EXPORTER_OTLP_LOGS_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v5.83.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**: `v5.83.0` **Aliases**:`OTEL_EXPORTER_OTLP_ENDPOINT` If non-empty, used as the OTLP metrics endpoint. Otherwise falls back to `OTEL_EXPORTER_OTLP_ENDPOINT`, then to `http://:4317/4318` based on protocol. For `http/protobuf`, `/v1/metrics` is appended if missing.`OTEL_EXPORTER_OTLP_METRICS_HEADERS` {% icon name="icon-link-wui" /%} **Type**: `map` **Since**: `v5.83.0` Specifies a comma-separated list of key-value pairs to be used as headers on outgoing OTLP metrics requests (for example, `api-key=key,other-config=value`). Takes precedence over the general `OTEL_EXPORTER_OTLP_HEADERS`.`OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `http/protobuf` **Since**: `v5.88.0` **Aliases**:`OTEL_EXPORTER_OTLP_PROTOCOL` Selects the protocol used for OpenTelemetry OTLP metrics export. Only http/protobuf is supported.`OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `delta` **Since**: `v5.83.0` Controls metrics aggregation temporality. Accepted values: `delta` or `cumulative` (case-insensitive); empty/invalid values are treated as `delta`.`OTEL_EXPORTER_OTLP_METRICS_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v5.88.0` **Aliases**:`OTEL_EXPORTER_OTLP_TIMEOUT` Timeout, in milliseconds, for a single outgoing OTLP metrics request. Takes precedence over `OTEL_EXPORTER_OTLP_TIMEOUT`.`OTEL_EXPORTER_OTLP_PROTOCOL` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `http/protobuf` **Since**: `v5.83.0` Specifies the transport protocol to use for all signals unless overridden. **Accepted values**: `grpc`, `http/protobuf`, `http/json`.`OTEL_EXPORTER_OTLP_TIMEOUT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `10000` **Since**: `v5.83.0` Default timeout, in milliseconds, for OTLP export requests. Used as a fallback when a signal-specific timeout is not set.`OTEL_LOG_LEVEL` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Configuration key to set the log level.`OTEL_LOGS_EXPORTER` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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**: `v5.83.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**: `v5.83.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` **Since**: `v5.88.0` OTEL_METRICS_EXPORTER is not used to choose an exporter. It is effectively only honored for none, which forces metrics off. When unset it does not enable metrics on its own it needs DD_METRICS_OTEL_ENABLED set to true to effectively produce metrics`OTEL_PROPAGATORS` {% icon name="icon-link-wui" /%} **Type**: `array` **Since**: `v5.83.0` Configures which propagators are used for extracting and injecting trace context.`OTEL_RESOURCE_ATTRIBUTES` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.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_SERVICE_NAME` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Sets the application's default service name. Alias for `DD_SERVICE` when `DD_SERVICE` is not set.`OTEL_TRACES_SAMPLER` {% icon name="icon-link-wui" /%} **Type**: `string` **Default**: `parentbased_always_on` **Since**: `v5.88.0` Specifies the Sampler used to sample traces by the SDK.`OTEL_TRACES_SAMPLER_ARG` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Since**: `v5.88.0` Configuration key to set an additional argument for the traces sampler. to false. {% /collapsible-section %} {% collapsible-section %} ### Real User Monitoring (RUM){% #registry-rum %} (1) {% icon name="icon-link-wui" /%} Backend Real User Monitoring injection settings: session configuration, privacy level, and resource tracking. `DD_TRACE_EXPERIMENTAL_GET_RUM_DATA_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enables instrumentation for experimental get rum data. When disabled, spans for experimental get rum data operations are not created. {% /collapsible-section %} {% collapsible-section %} ### AI & LLM Observability{% #registry-ai_observability %} (14) {% 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**: `v5.83.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**: `v5.83.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**: `v5.83.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**: `v5.83.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**: `v5.83.0` Timeout used in calls to the AI Guard REST API in milliseconds (default 5000)`DD_LANGCHAIN_SPAN_CHAR_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `128` **Since**: `v5.83.0` Maximum number of characters recorded for langchain span data.`DD_LANGCHAIN_SPAN_PROMPT_COMPLETION_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1` **Since**: `v5.83.0` Controls the sampling rate for capturing LangChain prompt and completion content on spans.`DD_LLMOBS_AGENTLESS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Since**: `v5.83.0` Set to `true` to disable sending data that requires a Datadog Agent.`DD_LLMOBS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Toggle to enable submitting data to LLM Observability`DD_LLMOBS_ML_APP` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.88.0` Sets the default ML app name used for LLM Observability data. This value is required when LLM Observability is enabled.`DD_OPENAI_LOGS_ENABLED` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` Enable collection of prompts and completions as logs. You can adjust the rate of prompts and completions collected using the sample rate configuration described below.`DD_OPENAI_SPAN_CHAR_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `128` **Since**: `v5.83.0` Configure the maximum number of characters for the following data within span tags:`DD_VERTEXAI_SPAN_CHAR_LIMIT` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `128` **Since**: `v5.83.0` Maximum number of characters recorded for vertexai span data.`DD_VERTEXAI_SPAN_PROMPT_COMPLETION_SAMPLE_RATE` {% icon name="icon-link-wui" /%} **Type**: `decimal` **Default**: `1` **Since**: `v5.83.0` Controls the sampling rate for capturing Vertex AI prompt and completion content on spans. {% /collapsible-section %} {% collapsible-section %} ### Instrumentation & Platform{% #registry-instrumentation %} (7) {% icon name="icon-link-wui" /%} Instrumentation setup and platform-specific configuration: auto-injection, third-party library detection, and platform adapters. `DD_AZURE_RESOURCE_GROUP` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Azure Resource Group name reported as cloud metadata for CI Visibility and telemetry correlation.`DD_INJECT_FORCE` {% icon name="icon-link-wui" /%} **Type**: `boolean` **Default**: `false` **Since**: `v5.83.0` 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**: `array` **Since**: `v5.83.0` Enables injection behavior in the tracer. When disabled, related data collection and processing are skipped.`DD_INSTRUMENTATION_CONFIG_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Internal instrumentation configuration identifier attached to telemetry for remote-configuration correlation.`DD_INSTRUMENTATION_INSTALL_ID` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` 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` **Since**: `v5.83.0` Sets the install time included in instrumentation telemetry payloads and headers.`DD_INSTRUMENTATION_INSTALL_TYPE` {% icon name="icon-link-wui" /%} **Type**: `string` **Since**: `v5.83.0` Sets the install type included in instrumentation telemetry payloads and headers. {% collapsible-section #registry-retired-instrumentation %} #### Retired keys (2) {% 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_AAS_DOTNET_EXTENSION_VERSION` {% icon name="icon-link-wui" /%} Removed in v5.88.0. **Type**: `string` **Default**: `unknown` **Since**: `v5.83.0` Holds the running version of the Azure App Services Site Extension. This env var is set in the applicationHost.xdt file.`DD_AZURE_APP_SERVICES` {% icon name="icon-link-wui" /%} Removed in 5.65.0. **Default**: `undefined` Configuration key which is used as a flag to tell us whether we are instrumenting an Azure App Service using the AAS Site Extension. {% /collapsible-section %} {% /collapsible-section %} {% collapsible-section %} ### Miscellaneous{% #registry-misc %} (2) {% 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**: `v5.83.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.`DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS` {% icon name="icon-link-wui" /%} **Type**: `int` **Default**: `30000` **Since**: `v5.84.0` Timeout in milliseconds for OpenFeature provider initialization. If configuration is not received within this time, initialization fails. Can be configured via DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS environment variable. {% /collapsible-section %} (function(){document.querySelectorAll(".registry-copy-link").forEach(function(e){e.addEventListener("click",function(t){t.preventDefault(),t.stopPropagation();const n=window.location.origin+window.location.pathname+e.getAttribute("href");navigator.clipboard.writeText(n).then(function(){e.matches("a")&&(e.classList.add("registry-copy-link--copied"),setTimeout(function(){e.classList.remove("registry-copy-link--copied")},1500))}),history.replaceState(null,"",e.getAttribute("href"))})});function e(){const n=window.location.hash;if(!n)return;const e=document.getElementById(n.substring(1));if(!e)return;let t=e;for(;t;)t.tagName==="DETAILS"&&(t.open=!0),t=t.parentElement;e.tagName==="DETAILS"&&(e.open=!0),setTimeout(function(){e.scrollIntoView({behavior:"smooth",block:"start"})},100)}e(),window.addEventListener("hashchange",e)})() ## Further Reading{% #further-reading %} - [Source code](https://github.com/DataDog/dd-trace-js) - [API documentation](https://datadog.github.io/dd-trace-js) - [Propagating trace context](https://docs.datadoghq.com/tracing/trace_collection/trace_context_propagation.md) - [Explore your services, resources and traces](https://docs.datadoghq.com/tracing/glossary.md) - [Advanced Usage](https://docs.datadoghq.com/tracing.md) - [OpenTelemetry Environment Variable Configurations](https://docs.datadoghq.com/opentelemetry/interoperability/environment_variable_support.md)