dd-trace 5.99.0 → 5.100.0

package/packages/dd-trace/src/config/supported-configurations.json

@@ -12,8 +12,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "ciVisAgentlessLogSubmissionEnabled"
+        "default": "false"
       }
     ],
     "DD_AGENTLESS_LOG_SUBMISSION_URL": [
@@ -422,8 +421,7 @@
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "appKey"
+        "default": null
       }
     ],
     "DD_AZURE_RESOURCE_GROUP": [
@@ -541,8 +539,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "true",
-        "internalPropertyName": "isManualApiEnabled"
+        "default": "true"
       }
     ],
     "DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS": [
@@ -597,8 +594,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "true",
-        "internalPropertyName": "crashtracking.enabled"
+        "default": "true"
       }
     ],
     "DD_CUSTOM_TRACE_ID": [
@@ -772,8 +768,7 @@
       {
         "implementation": "B",
         "type": "boolean",
-        "default": "true",
-        "internalPropertyName": "propagateProcessTags.enabled"
+        "default": "true"
       }
     ],
     "DD_EXPERIMENTAL_TEST_OPT_SETTINGS_CACHE": [
@@ -928,7 +923,6 @@
         "implementation": "C",
         "type": "string",
         "default": "1-16",
-        "internalPropertyName": "grpc.client.error.statuses",
         "transform": "setGRPCRange"
       }
     ],
@@ -937,7 +931,6 @@
         "implementation": "C",
         "type": "string",
         "default": "2-16",
-        "internalPropertyName": "grpc.server.error.statuses",
         "transform": "setGRPCRange"
       }
     ],
@@ -945,24 +938,21 @@
       {
         "implementation": "A",
         "type": "int",
-        "default": "0",
-        "internalPropertyName": "heapSnapshot.count"
+        "default": "0"
       }
     ],
     "DD_HEAP_SNAPSHOT_DESTINATION": [
       {
         "implementation": "A",
         "type": "string",
-        "default": "",
-        "internalPropertyName": "heapSnapshot.destination"
+        "default": ""
       }
     ],
     "DD_HEAP_SNAPSHOT_INTERVAL": [
       {
         "implementation": "A",
         "type": "int",
-        "default": "3600",
-        "internalPropertyName": "heapSnapshot.interval"
+        "default": "3600"
       }
     ],
     "DD_IAST_DB_ROWS_TO_TAINT": [
@@ -1105,48 +1095,42 @@
       {
         "implementation": "C",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "injectionEnabled"
+        "default": null
       }
     ],
     "DD_INJECT_FORCE": [
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "injectForce"
+        "default": "false"
       }
     ],
     "DD_INSTRUMENTATION_CONFIG_ID": [
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "instrumentation_config_id"
+        "default": null
       }
     ],
     "DD_INSTRUMENTATION_INSTALL_ID": [
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "installSignature.id"
+        "default": null
       }
     ],
     "DD_INSTRUMENTATION_INSTALL_TIME": [
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "installSignature.time"
+        "default": null
       }
     ],
     "DD_INSTRUMENTATION_INSTALL_TYPE": [
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "installSignature.type"
+        "default": null
       }
     ],
     "DD_INSTRUMENTATION_TELEMETRY_ENABLED": [
@@ -1164,8 +1148,7 @@
       {
         "implementation": "A",
         "type": "int",
-        "default": "30000",
-        "internalPropertyName": "profiling.longLivedThreshold"
+        "default": "30000"
       }
     ],
     "DD_INTERNAL_PROFILING_TIMELINE_SAMPLING_ENABLED": [
@@ -1240,8 +1223,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "otelLogsEnabled"
+        "default": "false"
       }
     ],
     "DD_TRACE_LOG_LEVEL": [
@@ -1263,8 +1245,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "otelMetricsEnabled"
+        "default": "false"
       }
     ],
     "DD_MINI_AGENT_PATH": [
@@ -1790,16 +1771,14 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "isKeepingCoverageConfiguration"
+        "default": "false"
       }
     ],
     "DD_TEST_SESSION_NAME": [
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "ciVisibilityTestSessionName"
+        "default": null
       }
     ],
     "DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED": [
@@ -1950,8 +1929,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "true",
-        "internalPropertyName": "trace.aws.addSpanPointers"
+        "default": "true"
       }
     ],
     "DD_TRACE_AWS_SDK_AWS_BATCH_PROPAGATION_ENABLED": [
@@ -2483,8 +2461,7 @@
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "trace.dynamoDb.tablePrimaryKeys"
+        "default": null
       }
     ],
     "DD_TRACE_ELASTICSEARCH_ENABLED": [
@@ -2644,8 +2621,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "true",
-        "internalPropertyName": "gitMetadataEnabled"
+        "default": "true"
       }
     ],
     "DD_TRACE_GOOGLE_CLOUD_PUBSUB_ENABLED": [
@@ -2687,8 +2663,7 @@
       {
         "implementation": "A",
         "type": "array",
-        "default": "",
-        "internalPropertyName": "graphqlErrorExtensions"
+        "default": ""
       }
     ],
     "DD_TRACE_GRAPHQL_TAG_ENABLED": [
@@ -3062,8 +3037,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "memcachedCommandEnabled"
+        "default": "false"
       }
     ],
     "DD_TRACE_MEMCACHED_ENABLED": [
@@ -3185,8 +3159,7 @@
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "trace.nativeSpanEvents"
+        "default": "false"
       }
     ],
     "DD_TRACE_NET_ENABLED": [
@@ -3429,16 +3402,14 @@
         "type": "string",
         "allowed": "continue|restart|ignore",
         "transform": "toLowerCase",
-        "default": "continue",
-        "internalPropertyName": "tracePropagationBehaviorExtract"
+        "default": "continue"
       }
     ],
     "DD_TRACE_PROPAGATION_EXTRACT_FIRST": [
       {
         "implementation": "A",
         "type": "boolean",
-        "default": "false",
-        "internalPropertyName": "tracePropagationExtractFirst"
+        "default": "false"
       }
     ],
     "DD_TRACE_PROPAGATION_STYLE": [
@@ -3678,7 +3649,6 @@
       {
         "implementation": "A",
         "type": "int",
-        "internalPropertyName": "spanLeakDebug",
         "default": "0"
       }
     ],
@@ -3831,8 +3801,7 @@
       {
         "implementation": "A",
         "type": "int",
-        "default": "512",
-        "internalPropertyName": "tagsHeaderMaxLength"
+        "default": "512"
       }
     ],
     "DD_VERSION": [
@@ -3872,7 +3841,6 @@
       {
         "implementation": "A",
         "type": "int",
-        "internalPropertyName": "otelMaxExportBatchSize",
         "default": "512",
         "allowed": "[1-9]\\d*"
       }
@@ -3881,7 +3849,6 @@
       {
         "implementation": "A",
         "type": "int",
-        "internalPropertyName": "otelMaxQueueSize",
         "default": "2048",
         "allowed": "[1-9]\\d*"
       }
@@ -3890,7 +3857,6 @@
       {
         "implementation": "A",
         "type": "int",
-        "internalPropertyName": "otelBatchTimeout",
         "default": "5000",
         "allowed": "[1-9]\\d*"
       }
@@ -3951,8 +3917,7 @@
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "otelLogsUrl"
+        "default": null
       }
     ],
     "OTEL_EXPORTER_OTLP_LOGS_HEADERS": [
@@ -3970,7 +3935,6 @@
         "implementation": "D",
         "type": "string",
         "default": "http/protobuf",
-        "internalPropertyName": "otelLogsProtocol",
         "aliases": [
           "OTEL_EXPORTER_OTLP_PROTOCOL"
         ]
@@ -3980,7 +3944,6 @@
       {
         "implementation": "A",
         "type": "int",
-        "internalPropertyName": "otelLogsTimeout",
         "default": "10000",
         "allowed": "[1-9]\\d*",
         "aliases": [
@@ -3992,8 +3955,7 @@
       {
         "implementation": "A",
         "type": "string",
-        "default": null,
-        "internalPropertyName": "otelMetricsUrl"
+        "default": null
       }
     ],
     "OTEL_EXPORTER_OTLP_METRICS_HEADERS": [
@@ -4011,7 +3973,6 @@
         "implementation": "B",
         "type": "string",
         "default": "http/protobuf",
-        "internalPropertyName": "otelMetricsProtocol",
         "aliases": [
           "OTEL_EXPORTER_OTLP_PROTOCOL"
         ]
@@ -4023,7 +3984,6 @@
         "type": "string",
         "allowed": "Delta|Cumulative|LowMemory",
         "transform": "toUpperCase",
-        "internalPropertyName": "otelMetricsTemporalityPreference",
         "default": "delta"
       }
     ],
@@ -4032,7 +3992,6 @@
         "implementation": "B",
         "type": "int",
         "allowed": "[1-9]\\d*",
-        "internalPropertyName": "otelMetricsTimeout",
         "default": "10000",
         "aliases": [
           "OTEL_EXPORTER_OTLP_TIMEOUT"
@@ -4043,8 +4002,7 @@
       {
         "implementation": "A",
         "type": "string",
-        "default": "http/protobuf",
-        "internalPropertyName": "otelProtocol"
+        "default": "http/protobuf"
       }
     ],
     "OTEL_EXPORTER_OTLP_TIMEOUT": [
@@ -4052,7 +4010,6 @@
         "implementation": "A",
         "type": "int",
         "allowed": "[1-9]\\d*",
-        "internalPropertyName": "otelTimeout",
         "default": "10000"
       }
     ],
@@ -4079,7 +4036,6 @@
         "implementation": "A",
         "type": "int",
         "allowed": "[1-9]\\d*",
-        "internalPropertyName": "otelMetricsExportInterval",
         "default": "10000"
       }
     ],
@@ -4088,7 +4044,6 @@
         "implementation": "A",
         "type": "int",
         "allowed": "[1-9]\\d*",
-        "internalPropertyName": "otelMetricsExportTimeout",
         "default": "7500"
       }
     ],

package/packages/dd-trace/src/debugger/config.js

@@ -9,7 +9,7 @@ module.exports = function getDebuggerConfig (config, inputPath) {
     hostname: config.hostname,
     logLevel: config.logLevel,
     port: config.port,
-    propagateProcessTags: config.propagateProcessTags,
+    propagateProcessTags: { enabled: config.DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED },
     repositoryUrl: config.repositoryUrl,
     runtimeId: config.tags['runtime-id'],
     service: config.service,

package/packages/dd-trace/src/dogstatsd.js

@@ -266,6 +266,8 @@ class MetricsAggregationClient {
     this._captureTree(this._gauges, (node, name, tags) => {
       this._client.gauge(name, node.value, tags)
     })
+
+    this._gauges.clear()
   }
 
   _captureCounters () {
@@ -278,12 +280,7 @@ class MetricsAggregationClient {
 
   _captureHistograms () {
     this._captureTree(this._histograms, (node, name, tags) => {
-      let stats = node.value
-
-      // Stats can contain garbage data when a value was never recorded.
-      if (stats.count === 0) {
-        stats = { max: 0, min: 0, sum: 0, avg: 0, median: 0, p95: 0, count: 0 }
-      }
+      const stats = node.value
 
       this._client.gauge(`${name}.min`, stats.min, tags)
       this._client.gauge(`${name}.max`, stats.max, tags)
@@ -293,9 +290,9 @@ class MetricsAggregationClient {
       this._client.increment(`${name}.count`, stats.count, tags)
       this._client.gauge(`${name}.median`, stats.median, tags)
       this._client.gauge(`${name}.95percentile`, stats.p95, tags)
-
-      node.value.reset()
     })
+
+    this._histograms.clear()
   }
 
   _captureTree (tree, fn) {

package/packages/dd-trace/src/encode/0.4.js

@@ -11,7 +11,7 @@ function formatSpan (span, config) {
   span = normalizeSpan(truncateSpan(span, false))
   if (span.span_events) {
     // ensure span events are encoded as tags if agent doesn't support native top level span events
-    if (config.trace.nativeSpanEvents) {
+    if (config.DD_TRACE_NATIVE_SPAN_EVENTS) {
       formatSpanEvents(span)
     } else {
       span.meta.events = JSON.stringify(span.span_events)

package/packages/dd-trace/src/encode/tags-processors.js

@@ -34,18 +34,18 @@ function truncateSpan (span, shouldTruncateResourceName = true) {
   if (shouldTruncateResourceName && span.resource && span.resource.length > MAX_RESOURCE_NAME_LENGTH) {
     span.resource = `${span.resource.slice(0, MAX_RESOURCE_NAME_LENGTH)}...`
   }
-  for (let metaKey in span.meta) {
+  for (let metaKey of Object.keys(span.meta)) {
     const val = span.meta[metaKey]
     if (metaKey.length > MAX_META_KEY_LENGTH) {
       delete span.meta[metaKey]
       metaKey = `${metaKey.slice(0, MAX_META_KEY_LENGTH)}...`
-      span.metrics[metaKey] = val
+      span.meta[metaKey] = val
     }
     if (val && val.length > MAX_META_VALUE_LENGTH) {
       span.meta[metaKey] = `${val.slice(0, MAX_META_VALUE_LENGTH)}...`
     }
   }
-  for (let metricsKey in span.metrics) {
+  for (let metricsKey of Object.keys(span.metrics)) {
     const val = span.metrics[metricsKey]
     if (metricsKey.length > MAX_METRIC_KEY_LENGTH) {
       delete span.metrics[metricsKey]

package/packages/dd-trace/src/exporter.js

@@ -29,7 +29,7 @@ module.exports = function getExporter (name) {
         fs.existsSync(constants.DATADOG_LAMBDA_EXTENSION_PATH) ||
         fs.existsSync(constants.DATADOG_MINI_AGENT_PATH)
       )
-      return require(inAWSLambda && !usingAgent ? './exporters/log' : './exporters/agent')
+      return inAWSLambda && !usingAgent ? require('./exporters/log') : require('./exporters/agent')
     }
   }
 }

package/packages/dd-trace/src/git_metadata_tagger.js

@@ -8,7 +8,7 @@ class GitMetadataTagger {
   }
 
   tagGitMetadata (spanContext) {
-    if (this._config.gitMetadataEnabled) {
+    if (this._config.DD_TRACE_GIT_METADATA_ENABLED) {
       // These tags are added only to the local root span
       spanContext._trace.tags[SCI_COMMIT_SHA] = this._config.commitSHA
       spanContext._trace.tags[SCI_REPOSITORY_URL] = this._config.repositoryUrl

package/packages/dd-trace/src/heap_snapshots.js

@@ -8,11 +8,11 @@ const { threadId } = require('worker_threads')
 const log = require('./log')
 
 async function scheduleSnapshot (config, total) {
-  if (total > config.heapSnapshot.count) return
+  if (total > config.DD_HEAP_SNAPSHOT_COUNT) return
 
-  await setTimeout(config.heapSnapshot.interval * 1000, null, { ref: false })
+  await setTimeout(config.DD_HEAP_SNAPSHOT_INTERVAL * 1000, null, { ref: false })
   await clearMemory()
-  writeHeapSnapshot(getName(config.heapSnapshot.destination))
+  writeHeapSnapshot(getName(config.DD_HEAP_SNAPSHOT_DESTINATION))
   await scheduleSnapshot(config, total + 1)
 }
 
@@ -49,7 +49,7 @@ module.exports = {
    * @param {import('./config/config-base')} config - Tracer configuration
    */
   async start (config) {
-    const destination = config.heapSnapshot.destination
+    const destination = config.DD_HEAP_SNAPSHOT_DESTINATION
 
     try {
       await scheduleSnapshot(config, 1)

package/packages/dd-trace/src/llmobs/constants/tags.js

@@ -16,6 +16,9 @@ module.exports = {
   NAME: '_ml_obs.name',
   TRACE_ID: '_ml_obs.trace_id',
   PROPAGATED_TRACE_ID_KEY: '_dd.p.llmobs_trace_id',
+  LLMOBS_TRACE_ID_BRIDGE_KEY: 'llmobs_trace_id',
+  LLMOBS_PARENT_ID_BRIDGE_KEY: 'llmobs_parent_id',
+  LLMOBS_SUBMITTED_TAG_KEY: '_dd.llmobs.submitted',
   ROOT_PARENT_ID: 'undefined',
   DEFAULT_PROMPT_NAME: 'unnamed-prompt',
   INTERNAL_CONTEXT_VARIABLE_KEYS: '_dd_context_variable_keys',

package/packages/dd-trace/src/llmobs/sdk.js

@@ -7,7 +7,13 @@ const tracerVersion = require('../../../../package.json').version
 const logger = require('../log')
 const { getValueFromEnvSources } = require('../config/helper')
 const Span = require('../opentracing/span')
-const { SPAN_KIND, OUTPUT_VALUE, INPUT_VALUE } = require('./constants/tags')
+const {
+  SPAN_KIND,
+  OUTPUT_VALUE,
+  INPUT_VALUE,
+  LLMOBS_TRACE_ID_BRIDGE_KEY,
+  LLMOBS_PARENT_ID_BRIDGE_KEY,
+} = require('./constants/tags')
 const {
   getFunctionArguments,
   validateKind,
@@ -533,6 +539,20 @@ class LLMObs extends NoopLLMObs {
         ...options,
         parent: parentStore?.span,
       })
+
+      // Bridge tags read by the dd-go LLMObs trace-indexer to correlate OTel
+      // gen_ai.* spans with SDK LLMObs spans. Written once per local trace,
+      // on the first successful SDK LLMObs span registration. The shared
+      // _trace.tags bag is serialized to the first span in every flushed
+      // chunk's meta, so partial flush is covered automatically without a
+      // separate flush-time processor. Writing only after registerLLMObsSpan
+      // succeeds avoids poisoning _trace.tags with bridge tags pointing at a
+      // span that will never produce an LLMObs event.
+      const traceTags = span?.context?.()._trace?.tags
+      if (this.enabled && traceTags && !traceTags[LLMOBS_TRACE_ID_BRIDGE_KEY]) {
+        traceTags[LLMOBS_TRACE_ID_BRIDGE_KEY] = span.context().toTraceId(true)
+        traceTags[LLMOBS_PARENT_ID_BRIDGE_KEY] = span.context().toSpanId()
+      }
     }
 
     try {

package/packages/dd-trace/src/llmobs/span_processor.js

@@ -30,6 +30,7 @@ const {
   INPUT_PROMPT,
   ROUTING_API_KEY,
   ROUTING_SITE,
+  LLMOBS_SUBMITTED_TAG_KEY,
 } = require('./constants/tags')
 const { UNSERIALIZABLE_VALUE_TEXT } = require('./constants/text')
 const telemetry = require('./telemetry')
@@ -87,7 +88,19 @@ class LLMObsSpanProcessor {
         site: mlObsTags[ROUTING_SITE],
       }
 
-      this.#writer.append(formattedEvent, routing)
+      const enqueued = this.#writer.append(formattedEvent, routing)
+
+      // Marker read by the dd-go LLMObs trace-indexer: when reparenting OTel
+      // gen_ai.* spans, the parent-chain walk stops at any span carrying this
+      // tag, preserving this span as the immediate LLMObs parent. Set only
+      // when the writer actually buffered the event — format may have dropped
+      // it (user processor returned null), thrown, or the writer may have
+      // dropped it silently when its buffer is full. Leaving this tag off in
+      // those cases avoids dd-go reparenting OTel children under a span that
+      // has no corresponding LLMObs event.
+      if (enqueued) {
+        span.context()._tags[LLMOBS_SUBMITTED_TAG_KEY] = '1'
+      }
     } catch (e) {
       // this should be a rare case
       // we protect against unserializable properties in the format function, and in

package/packages/dd-trace/src/llmobs/writers/base.js

@@ -87,19 +87,25 @@ class BaseLLMObsWriter {
     return buffer
   }
 
+  /**
+   * @returns {boolean} `true` if the event was buffered, `false` if it was dropped
+   * (e.g. the per-routing buffer was full). Callers that depend on the event
+   * actually being submitted should check this value.
+   */
   append (event, routing, byteLength) {
     const buffer = this._getBuffer(routing)
 
     if (buffer.events.length >= buffer.limit) {
       logger.warn(`${this.constructor.name} event buffer full (limit is ${buffer.limit}), dropping event`)
       telemetry.recordDroppedPayload(1, this._eventType, 'buffer_full')
-      return
+      return false
     }
 
     const eventSize = byteLength || Buffer.byteLength(JSON.stringify(event))
 
     buffer.size += eventSize
     buffer.events.push(event)
+    return true
   }
 
   flush () {

package/packages/dd-trace/src/llmobs/writers/spans.js

@@ -45,7 +45,7 @@ class LLMObsSpanWriter extends BaseWriter {
       this.flush()
     }
 
-    super.append(event, routing, processedEventSizeBytes)
+    return super.append(event, routing, processedEventSizeBytes)
   }
 
   makePayload (events) {

package/packages/dd-trace/src/openfeature/eval-metrics-hook.js

@@ -30,7 +30,7 @@ const COUNTER_UNIT = '{evaluation}'
  * If counter creation fails (e.g. the OTel API is not yet available), the call
  * is silently skipped and retried on the next `finally()` invocation.
  *
- * When `config.otelMetricsEnabled` is false, `finally()` is always a no-op.
+ * When `config.DD_METRICS_OTEL_ENABLED` is false, `finally()` is always a no-op.
  */
 class EvalMetricsHook {
   #enabled = false
@@ -40,7 +40,7 @@ class EvalMetricsHook {
    * @param {import('../config')} config - Tracer configuration object
    */
   constructor (config) {
-    this.#enabled = config.otelMetricsEnabled === true
+    this.#enabled = config.DD_METRICS_OTEL_ENABLED === true
   }
 
   /**