dd-trace 6.15.0 → 6.17.0

package/packages/dd-trace/src/plugins/database.js

@@ -3,6 +3,7 @@
 const { LRUCache } = require('../../../../vendor/dist/lru-cache')
 const { PEER_SERVICE_KEY, PEER_SERVICE_SOURCE_KEY } = require('../constants')
 const propagationHash = require('../propagation-hash')
+const { truncateString } = require('../util')
 const StoragePlugin = require('./storage')
 
 // Unreserved RFC 3986 set that `encodeURIComponent` leaves untouched (a conservative subset:
@@ -46,7 +47,6 @@ class DatabasePlugin extends StoragePlugin {
    * @param {string} serviceName
    * @param {import('../../../..').Span} span
    * @param {object} peerData
-   * @returns {string}
    */
   #createDBMPropagationCommentService (serviceName, span, peerData) {
     const spanTags = span.context().getTags()
@@ -70,7 +70,6 @@ class DatabasePlugin extends StoragePlugin {
   /**
    * @param {string} tracerService
    * @param {object} peerData
-   * @returns {string}
    */
   #getDbmServiceName (tracerService, peerData) {
     if (this._tracerConfig.spanComputePeerService) {
@@ -123,7 +122,6 @@ class DatabasePlugin extends StoragePlugin {
    * @param {string} query
    * @param {string} serviceName
    * @param {boolean} disableFullMode
-   * @returns {string}
    */
   injectDbmQuery (span, query, serviceName, disableFullMode = false) {
     const dbmTraceComment = this.createDbmComment(span, serviceName, disableFullMode)
@@ -139,7 +137,6 @@ class DatabasePlugin extends StoragePlugin {
 
   /**
    * @param {string} query
-   * @returns {string}
    */
   maybeTruncate (query) {
     const maxLength = typeof this.config.truncate === 'number'
@@ -147,7 +144,7 @@ class DatabasePlugin extends StoragePlugin {
       : 5000 // same as what the agent does
 
     if (this.config.truncate && query && query.length > maxLength) {
-      query = `${query.slice(0, maxLength - 3)}...`
+      query = truncateString(query, maxLength, '...')
     }
 
     return query
@@ -156,7 +153,6 @@ class DatabasePlugin extends StoragePlugin {
 
 /**
  * @param {string | number | undefined | null} value
- * @returns {string}
  */
 function encode (value) {
   if (!value) return ''

package/packages/dd-trace/src/plugins/index.js

@@ -10,6 +10,12 @@ const plugins = {
   get '@azure/functions' () { return require('../../../datadog-plugin-azure-functions/src') },
   get '@modelcontextprotocol/sdk' () { return require('../../../datadog-plugin-modelcontextprotocol-sdk/src') },
   get '@aws/durable-execution-sdk-js' () { return require('../../../datadog-plugin-aws-durable-execution-sdk-js/src') },
+  get '@supabase/auth-js' () { return require('../../../datadog-plugin-supabase/src') },
+  get '@supabase/functions-js' () { return require('../../../datadog-plugin-supabase/src') },
+  get '@supabase/postgrest-js' () { return require('../../../datadog-plugin-supabase/src') },
+  get '@supabase/realtime-js' () { return require('../../../datadog-plugin-supabase/src') },
+  get '@supabase/storage-js' () { return require('../../../datadog-plugin-supabase/src') },
+  get '@supabase/supabase-js' () { return require('../../../datadog-plugin-supabase/src') },
   get 'durable-functions' () { return require('../../../datadog-plugin-azure-durable-functions/src') },
   get '@azure/service-bus' () { return require('../../../datadog-plugin-azure-service-bus/src') },
   get '@cucumber/cucumber' () { return require('../../../datadog-plugin-cucumber/src') },
@@ -19,6 +25,7 @@ const plugins = {
   get '@google-cloud/pubsub' () { return require('../../../datadog-plugin-google-cloud-pubsub/src') },
   get '@google-cloud/vertexai' () { return require('../../../datadog-plugin-google-cloud-vertexai/src') },
   get '@google/genai' () { return require('../../../datadog-plugin-google-genai/src') },
+  get '@graphql-tools/executor' () { return require('../../../datadog-plugin-graphql/src') },
   get '@grpc/grpc-js' () { return require('../../../datadog-plugin-grpc/src') },
   get '@hapi/hapi' () { return require('../../../datadog-plugin-hapi/src') },
   get '@happy-dom/jest-environment' () { return require('../../../datadog-plugin-jest/src') },
@@ -120,6 +127,7 @@ const plugins = {
   get pino () { return require('../../../datadog-plugin-pino/src') },
   get 'pino-pretty' () { return require('../../../datadog-plugin-pino/src') },
   get playwright () { return require('../../../datadog-plugin-playwright/src') },
+  get postgres () { return require('../../../datadog-plugin-postgres/src') },
   get protobufjs () { return require('../../../datadog-plugin-protobufjs/src') },
   get redis () { return require('../../../datadog-plugin-redis/src') },
   get restify () { return require('../../../datadog-plugin-restify/src') },

package/packages/dd-trace/src/plugins/plugin.js

@@ -100,7 +100,6 @@ module.exports = class Plugin {
    *
    * @param {object} span The span to bind as current.
    * @param {object=} store Optional existing store to extend; if omitted, uses current store.
-   * @returns {void}
    */
   enter (span, store) {
     store ||= legacyStorage.getStore()
@@ -112,7 +111,6 @@ module.exports = class Plugin {
    *
    * @param {string} channelName Diagnostic channel name.
    * @param {(message: unknown, name: string) => unknown} handler Handler invoked on messages.
-   * @returns {void}
    */
   addSub (channelName, handler) {
     const wrappedHandler = (message, name) => {
@@ -132,7 +130,6 @@ module.exports = class Plugin {
    *
    * @param {string} channelName Diagnostic channel name.
    * @param {(data: unknown) => object} transform Transform to compute the bound store.
-   * @returns {void}
    */
   addBind (channelName, transform) {
     this._bindings.push(new StoreBinding(channelName, transform))
@@ -142,7 +139,6 @@ module.exports = class Plugin {
    * Attach an error to the current active span (if any).
    *
    * @param {unknown} error Error object or sentinel value.
-   * @returns {void}
    */
   addError (error) {
     const store = legacyStorage.getStore()

package/packages/dd-trace/src/plugins/tracing.js

@@ -29,6 +29,7 @@ class TracingPlugin extends Plugin {
    * @param {string} [opts.type]
    * @param {string} [opts.id]
    * @param {string} [opts.kind]
+   * @param {object} [opts.pluginConfig]
    * @returns {{ name: string, source: string | undefined }}
    */
   serviceName (opts = {}) {
@@ -46,7 +47,6 @@ class TracingPlugin extends Plugin {
    * @param {string} [opts.type]
    * @param {string} [opts.id]
    * @param {string} [opts.kind]
-   * @returns {string}
    */
   operationName (opts = {}) {
     const {

package/packages/dd-trace/src/plugins/util/git.js

@@ -95,10 +95,8 @@ function isDirectory (path) {
 }
 
 function isGitAvailable () {
-  const isWindows = os.platform() === 'win32'
-  const command = isWindows ? 'where' : 'which'
   try {
-    cachedExec(command, ['git'])
+    cachedExec('git', ['--version'])
     return true
   } catch {
     incrementCountMetric(TELEMETRY_GIT_COMMAND_ERRORS, { command: 'check_git', exitCode: 'missing' })

package/packages/dd-trace/src/plugins/util/http-otel-semantics.js

@@ -104,7 +104,6 @@ function toHttpScheme (scheme) {
  * `REDACTED@host`. Returns the URL unchanged when no userinfo is present.
  *
  * @param {string} url
- * @returns {string}
  */
 function redactUrlCredentials (url) {
   const schemeEnd = url.indexOf('://')

package/packages/dd-trace/src/plugins/util/llm.js

@@ -29,7 +29,6 @@ function normalize (text, limit = 128) {
  *
  * @param {Sampler} sampler
  * @param {import('../../../../..').Span|import('../../../../..').SpanContext} span
- * @returns {boolean} `true` if the prompt completion should be sampled, otherwise `false`.
  */
 function isPromptCompletionSampled (sampler, span) {
   return sampler.isSampled(span)
@@ -52,7 +51,6 @@ module.exports = function makeUtilities (integrationName, tracerConfig) {
      * Determines whether a prompt completion should be sampled based on the configured sampling rate.
      *
      * @param {import('../../../../..').Span|import('../../../../..').SpanContext} span
-     * @returns {boolean} `true` if the prompt completion should be sampled, otherwise `false`.
      */
     isPromptCompletionSampled: (span) => isPromptCompletionSampled(sampler, span),
   }

package/packages/dd-trace/src/plugins/util/status-validator.js

@@ -83,7 +83,6 @@ function getStatusValidator (config, optionName, defaultRanges, defaultValidator
 
   /**
    * @param {number} code
-   * @returns {boolean}
    */
   function isValidStatusCode (code) {
     return errorStatusCodes[code] !== 1

package/packages/dd-trace/src/plugins/util/test.js

@@ -102,6 +102,7 @@ const TEST_STATUS = 'test.status'
 const TEST_FINAL_STATUS = 'test.final_status'
 const TEST_PARAMETERS = 'test.parameters'
 const TEST_SKIP_REASON = 'test.skip_reason'
+const TEST_SESSION_EMPTY_REASON = 'test.session.empty_reason'
 const TEST_IS_RUM_ACTIVE = 'test.is_rum_active'
 const TEST_CODE_OWNERS = 'test.codeowners'
 const TEST_SOURCE_FILE = 'test.source.file'
@@ -445,7 +446,6 @@ function addTestOptimizationRequest (requestPromises, responseNames, responseNam
  *
  * @param {string} testSuite
  * @param {string|undefined} testSuiteExecutionId
- * @returns {string}
  */
 function getTestSuiteExecutionKey (testSuite, testSuiteExecutionId) {
   return testSuiteExecutionId ? `${testSuite}\0${testSuiteExecutionId}` : testSuite
@@ -471,9 +471,11 @@ module.exports = {
   TEST_FINAL_STATUS,
   TEST_PARAMETERS,
   TEST_SKIP_REASON,
+  TEST_SESSION_EMPTY_REASON,
   TEST_IS_RUM_ACTIVE,
   setRumTestCorrelation,
   setRumTestTags,
+  setExpectedEmptyTestSessionTags,
   TEST_SOURCE_FILE,
   TEST_FAILURE_SCREENSHOT_UPLOADED,
   TEST_FAILURE_SCREENSHOT_UPLOAD_ERROR,
@@ -868,7 +870,6 @@ function finishAllTraceSpans (span) {
  * @param {import('../../opentracing/span')} testSpan
  * @param {boolean|undefined} isRumActive
  * @param {string} [browserVersion]
- * @returns {void}
  */
 function setRumTestTags (testSpan, isRumActive, browserVersion) {
   if (isRumActive) {
@@ -879,6 +880,24 @@ function setRumTestTags (testSpan, isRumActive, browserVersion) {
   }
 }
 
+/**
+ * Marks a successful test session that intentionally executed no tests.
+ *
+ * @param {import('../../opentracing/span')} testSessionSpan
+ * @param {import('../../opentracing/span')|undefined} testModuleSpan
+ * @param {string} skipReason
+ * @param {string} emptyReason
+ */
+function setExpectedEmptyTestSessionTags (testSessionSpan, testModuleSpan, skipReason, emptyReason) {
+  for (const span of [testSessionSpan, testModuleSpan]) {
+    if (!span) continue
+
+    span.setTag(TEST_STATUS, 'skip')
+    span.setTag(TEST_SKIP_REASON, skipReason)
+    span.setTag(TEST_SESSION_EMPTY_REASON, emptyReason)
+  }
+}
+
 /**
  * @param {RumTestCorrelationContext} context
  * @param {import('../../opentracing/span')|undefined} activeSpan
@@ -942,7 +961,6 @@ function getTestCommonTags (name, suite, version, testFramework) {
  *
  * @param {string | undefined} testSuiteAbsolutePath
  * @param {string} sourceRoot
- * @returns {string}
  */
 function getTestSuitePath (testSuiteAbsolutePath, sourceRoot) {
   if (!testSuiteAbsolutePath) {
@@ -1069,7 +1087,6 @@ const codeOwnersPerEntries = new WeakMap()
 
 /**
  * @param {string} character
- * @returns {string}
  */
 function escapeRegexCharacter (character) {
   return character.replaceAll(/[|\\{}()[\]^$+*?.]/g, String.raw`\$&`)
@@ -1077,7 +1094,6 @@ function escapeRegexCharacter (character) {
 
 /**
  * @param {string} pattern
- * @returns {boolean}
  */
 function hasUnescapedWildcard (pattern) {
   for (let i = 0; i < pattern.length; i++) {
@@ -1093,7 +1109,6 @@ function hasUnescapedWildcard (pattern) {
 
 /**
  * @param {string} pattern
- * @returns {string}
  */
 function codeOwnersPatternToRegexSource (pattern) {
   let source = ''
@@ -1135,7 +1150,10 @@ function getCodeOwnersPatternRegex (pattern) {
   }
 
   const directoryOnly = pattern.endsWith('/')
-  const normalizedPattern = pattern.replace(/^\/+/, '').replace(/\/+$/, '')
+  let normalizedPattern = pattern.replace(/^\/+/, '')
+  let normalizedPatternEnd = normalizedPattern.length
+  while (normalizedPatternEnd > 0 && normalizedPattern[normalizedPatternEnd - 1] === '/') normalizedPatternEnd--
+  normalizedPattern = normalizedPattern.slice(0, normalizedPatternEnd)
   const anchored = pattern.startsWith('/') || normalizedPattern.includes('/')
 
   if (!normalizedPattern) {
@@ -1169,7 +1187,6 @@ function setCodeOwnersPatternRegex (entry) {
  *
  * @param {RegExp|null} regex
  * @param {string} filename
- * @returns {boolean}
  */
 function isCodeOwnersPatternMatch (regex, filename) {
   if (!regex || !filename) {
@@ -1548,7 +1565,6 @@ function applySkippedCoverageToFileCoverage (fileCoverage, skippedBitmap) {
  * @param {object} coverage
  * @param {object} skippedCoverage
  * @param {string} [rootDir]
- * @returns {boolean}
  */
 function applySkippedCoverageToCoverage (coverage, skippedCoverage, rootDir) {
   const skippedCoverageByFilename = getSkippedCoverageByFilename(skippedCoverage)
@@ -1613,7 +1629,6 @@ function fromCoverageMapToCoverage (coverageMap) {
 
 /**
  * @param {number} code
- * @returns {boolean}
  */
 function isAsciiDigit (code) {
   return code >= 0x30 && code <= 0x39
@@ -2039,7 +2054,6 @@ function getModifiedFilesFromDiff (diff) {
  *
  * @param {string | undefined} testSuite
  * @param {string} testName
- * @returns {string}
  */
 function getTestOptimizationIdentity (testSuite, testName) {
   return JSON.stringify([testSuite, testName])
@@ -2050,7 +2064,6 @@ function getTestOptimizationIdentity (testSuite, testName) {
  *
  * @param {string | undefined} testSuite
  * @param {string} testName
- * @returns {string}
  */
 function formatTestOptimizationName (testSuite, testName) {
   return testSuite ? `${testSuite} › ${testName}` : testName
@@ -2060,7 +2073,6 @@ function formatTestOptimizationName (testSuite, testName) {
  * Replaces characters that could make one test occupy multiple CI log lines.
  *
  * @param {string} value
- * @returns {string}
  */
 function sanitizeTestOptimizationName (value) {
   return stripVTControlCharacters(value)
@@ -2074,7 +2086,6 @@ function sanitizeTestOptimizationName (value) {
  *
  * @param {string} value
  * @param {number} maxLength
- * @returns {string}
  */
 function truncateTestOptimizationNameStart (value, maxLength) {
   if (value.length <= maxLength) return value
@@ -2090,7 +2101,6 @@ function truncateTestOptimizationNameStart (value, maxLength) {
  *
  * @param {string} value
  * @param {number} maxLength
- * @returns {string}
  */
 function truncateTestOptimizationNameMiddle (value, maxLength) {
   if (value.length <= maxLength) return value
@@ -2109,7 +2119,6 @@ function truncateTestOptimizationNameMiddle (value, maxLength) {
  *
  * @param {string | undefined} testSuite
  * @param {string} testName
- * @returns {string}
  */
 function formatTestOptimizationDisplayName (testSuite, testName) {
   const sanitizedSuite = testSuite ? sanitizeTestOptimizationName(testSuite) : ''
@@ -2133,7 +2142,6 @@ function formatTestOptimizationDisplayName (testSuite, testName) {
  * Renders a bounded bullet list for Test Optimization summaries.
  *
  * @param {Array<{ text: string, suffix?: string }>} items
- * @returns {string}
  */
 function formatTestOptimizationList (items) {
   const shown = items.slice(0, MAX_TEST_OPTIMIZATION_SUMMARY_ITEMS)
@@ -2296,7 +2304,6 @@ function collectAttemptToFixExecutionFromTraceSpan (span, attemptToFixExecutions
  *
  * @param {{ meta?: Record<string, string> }} span
  * @param {TestManagementExecutions} executions
- * @returns {void}
  */
 function collectTestManagementExecutionFromTraceSpan (span, executions) {
   const meta = span.meta
@@ -2402,7 +2409,6 @@ function addAttemptToFixResultLine (lines, result) {
  *
  * @param {AttemptToFixExecutions} attemptToFixExecutions
  * @param {boolean} [includeTestNames]
- * @returns {string}
  */
 function formatAttemptToFixSummary (attemptToFixExecutions, includeTestNames = true) {
   if (attemptToFixExecutions.size === 0) return ''
@@ -2455,7 +2461,6 @@ function formatAttemptToFixSummary (attemptToFixExecutions, includeTestNames = t
  *
  * @param {TestManagementExecutions} executions
  * @param {boolean} [includeTestNames]
- * @returns {string}
  */
 function formatTestManagementSummary (executions, includeTestNames = true) {
   if (executions.size === 0) return ''
@@ -2506,7 +2511,6 @@ function formatTestManagementSummary (executions, includeTestNames = true) {
  * Formats the dynamic-name warning section of the Test Optimization summary.
  *
  * @param {Set<string>} newTestsWithDynamicNames
- * @returns {string}
  */
 function formatDynamicNamesSummary (newTestsWithDynamicNames) {
   if (newTestsWithDynamicNames.size === 0) return ''

package/packages/dd-trace/src/plugins/util/url.js

@@ -19,7 +19,6 @@ const SPECIAL_CHARACTER_SEGMENT = /[%&'()*+,:=@]/
 /**
  * Extract full URL from HTTP request
  * @param {import('http').IncomingMessage} req
- * @returns {string} Full URL
  */
 function extractURL (req) {
   const headers = req.headers
@@ -42,7 +41,6 @@ function getProtocol (req) {
  *
  * @param {object} config
  * @param {string} url
- * @returns {string} obfuscated URL
  */
 function obfuscateQs (config, url) {
   const { queryStringObfuscation } = config
@@ -114,7 +112,6 @@ function getQsObfuscator (config) {
  * @param {string} base `scheme://host[:port]`
  * @param {string} [pathname] raw request path, may include `?query`
  * @param {string} strippedUrl `base` + query-stripped path (used when there is no query)
- * @returns {string}
  */
 function buildClientHttpUrl (config, base, pathname, strippedUrl) {
   if (pathname?.includes('?')) {
@@ -133,7 +130,6 @@ function buildClientHttpUrl (config, base, pathname, strippedUrl) {
  * - Cross tracers compatibility
  *
  * @param {string} url
- * @returns {string} Url path
  */
 function extractPathFromUrl (url) {
   if (!url) return '/'
@@ -146,7 +142,6 @@ function extractPathFromUrl (url) {
  * Calculate http.endpoint from URL path
  *
  * @param {string} url
- * @returns {string} The normalized endpoint
  */
 function calculateHttpEndpoint (url) {
   const path = extractPathFromUrl(url)

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

@@ -86,7 +86,6 @@ class PrioritySampler {
 
   /**
    * @param {DatadogSpan} span
-   * @returns {boolean} True if the trace should be sampled based on priority.
    */
   isSampled (span) {
     const priority = this._getPriorityFromAuto(span)
@@ -99,7 +98,6 @@ class PrioritySampler {
    *
    * @param {DatadogSpan} span
    * @param {boolean} [auto] - Whether to use automatic sampling if no manual tags are present.
-   * @returns {void}
    */
   sample (span, auto = true) {
     if (!span) return
@@ -131,7 +129,6 @@ class PrioritySampler {
    * Updates agent-provided sampling rates keyed by `service:,env:`.
    *
    * @param {Record<string, number>} rates
-   * @returns {void}
    */
   update (rates) {
     const samplers = {}
@@ -151,7 +148,6 @@ class PrioritySampler {
    * Validates that a sampling priority value is one of the allowed constants.
    *
    * @param {SamplingPriority|undefined} samplingPriority
-   * @returns {boolean}
    */
   validate (samplingPriority) {
     switch (samplingPriority) {
@@ -277,7 +273,6 @@ class PrioritySampler {
    * records the effective rate on the trace.
    *
    * @param {DatadogSpanContext} context
-   * @returns {boolean}
    */
   _isSampledByRateLimit (context) {
     // TODO: Change underscored properties to private ones.
@@ -316,7 +311,6 @@ class PrioritySampler {
    * Tags the trace with a decision maker when priority is keep, or removes it otherwise.
    *
    * @param {DatadogSpan} span
-   * @returns {void}
    */
   #addDecisionMaker (span) {
     const context = span.context()

package/packages/dd-trace/src/process-tags/index.js

@@ -16,7 +16,6 @@ const ENTRYPOINT_PATH = require.main?.filename || ''
  * Sanitize a process tag value
  *
  * @param {string} value
- * @returns {string}
  */
 function sanitize (value) {
   return String(value)

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

@@ -1,42 +1,139 @@
 'use strict'
 
-const { profiler } = require('./profiling')
+const dc = require('dc-polyfill')
 
-globalThis[Symbol.for('dd-trace')].beforeExitHandlers.add(() => { profiler.stop() })
+const log = require('./log')
 
-module.exports = {
-  /**
-   * @param {import('./config/config-base')} config - Tracer configuration
-   */
-  start (config) {
+const configUpdateChannel = dc.channel('datadog:config:update')
+
+/** @type {import('./profiling/ssi-heuristics').SSIHeuristics | undefined} */
+let activeSSIHeuristics
+
+/** @type {import('./profiling') | undefined} */
+let profilingModule
+
+function getProfilingModule () {
+  profilingModule ??= require('./profiling')
+  return profilingModule
+}
+
+// The profiling engine can stop itself (e.g. a collection error) without going through stop(), so
+// read its state directly rather than caching a flag that could drift out of sync. Checking
+// `profilingModule` first avoids forcing the profiling engine (and its native crashtracker binding)
+// to load just to read this.
+function isStarted () {
+  return profilingModule !== undefined && profilingModule.profiler.enabled
+}
+
+/** @type {typeof import('./profiling/ssi-heuristics') | undefined} */
+let ssiHeuristicsModule
+
+function getSSIHeuristicsModule () {
+  ssiHeuristicsModule ??= require('./profiling/ssi-heuristics')
+  return ssiHeuristicsModule
+}
+
+function disableSSIHeuristics () {
+  if (!activeSSIHeuristics) return
+  activeSSIHeuristics.disable()
+  activeSSIHeuristics = undefined
+}
+
+/**
+ * @param {import('./config/config-base')} config - Tracer configuration
+ */
+function start (config) {
+  try {
     // Forward the full tracer config to the profiling layer.
     // Profiling code is responsible for deriving the specific options it needs.
-    return profiler.start(config)
-  },
-
-  stop () {
-    profiler.stop()
-  },
-
-  /**
-   * Declares the set of custom label keys that will be used with
-   * `runWithLabels`.
-   *
-   * @param {Iterable<string>} keys - Custom label key names
-   */
-  setCustomLabelKeys: (keys) => {
-    profiler.setCustomLabelKeys(keys)
-  },
-
-  /**
-   * Runs a function with custom profiling labels attached to wall profiler samples.
-   *
-   * @param {Record<string, string | number>} labels - Custom labels to attach
-   * @param {function(): T} fn - Function to execute with the labels
-   * @returns {T} The return value of fn
-   * @template T
-   */
-  runWithLabels: (labels, fn) => {
-    return profiler.runWithLabels(labels, fn)
-  },
+    return getProfilingModule().profiler.start(config)
+  } catch (error) {
+    log.error(
+      'Error starting profiler. For troubleshooting tips, see <https://dtdg.co/nodejs-profiler-troubleshooting>',
+      error
+    )
+    return false
+  }
+}
+
+function stop () {
+  // A stop command for a profiler that has never been loaded is already satisfied. Once loaded,
+  // always forward it so the profiling layer can also cancel a restart queued during shutdown.
+  if (profilingModule === undefined) return
+
+  try {
+    profilingModule.profiler.stop()
+  } catch (error) {
+    log.error(
+      'Error stopping profiler. For troubleshooting tips, see <https://dtdg.co/nodejs-profiler-troubleshooting>',
+      error
+    )
+  }
+}
+
+/**
+ * Declares the set of custom label keys that will be used with
+ * `runWithLabels`.
+ *
+ * @param {Iterable<string>} keys - Custom label key names
+ */
+function setCustomLabelKeys (keys) {
+  getProfilingModule().profiler.setCustomLabelKeys(keys)
 }
+
+/**
+ * Runs a function with custom profiling labels attached to wall profiler samples.
+ *
+ * @param {Record<string, string | number>} labels - Custom labels to attach
+ * @param {function(): T} fn - Function to execute with the labels
+ * @returns {T} The return value of fn
+ * @template T
+ */
+function runWithLabels (labels, fn) {
+  return getProfilingModule().profiler.runWithLabels(labels, fn)
+}
+
+configUpdateChannel.subscribe((config) => {
+  const enabled = config.profiling.DD_PROFILING_ENABLED
+  if (enabled === 'true') {
+    // A non-auto value means the SSI heuristics no longer get a say; disable them so a trigger that
+    // fires after this publish can't start the profiler behind this decision's back.
+    disableSSIHeuristics()
+    // Leave an already-running profiler alone; otherwise an unrelated remote-config publish
+    // (e.g. an unrelated sampling-rate change) would restart it on every update.
+    if (!isStarted()) start(config)
+  } else if (enabled === 'false') {
+    disableSSIHeuristics()
+    stop()
+  } else if (enabled === 'auto') {
+    if (!isStarted() && !activeSSIHeuristics) {
+      // 'auto' defers the start decision to SSI heuristics. A running profiler already reflects a
+      // decision that was made (by SSI or a prior unconditional enablement), so leave it alone
+      // rather than stopping and re-enabling it on every subsequent config publication. Also guard
+      // against creating another active instance; each SSIHeuristics instance owns listeners and a
+      // timer until the heuristic makes its decision or is explicitly disabled.
+      const { SSIHeuristics } = getSSIHeuristicsModule()
+      const heuristics = new SSIHeuristics(config)
+      activeSSIHeuristics = heuristics
+      heuristics.start()
+      heuristics.onTriggered(() => {
+        // Explicit true/false publishes disable the heuristics, so reaching this callback guarantees
+        // the latest valid published value is still 'auto'.
+        if (!isStarted()) start(config)
+        // The heuristic has made its decision, so release all of its listeners and timer before
+        // dropping the module-level reference. This does not stop the profiler that was just
+        // started; it only tears down the completed heuristic.
+        heuristics.disable()
+        if (activeSSIHeuristics === heuristics) activeSSIHeuristics = undefined
+      })
+    }
+  } else {
+    // Invalid config should preserve the last valid profiling decision, not accidentally behave
+    // like 'auto' or crash the customer application.
+    log.warn('Unexpected DD_PROFILING_ENABLED value: %o', enabled)
+  }
+})
+
+globalThis[Symbol.for('dd-trace')].beforeExitHandlers.add(stop)
+
+module.exports = { isStarted, start, stop, setCustomLabelKeys, runWithLabels }

package/packages/dd-trace/src/profiling/exporters/event_serializer.js

@@ -15,7 +15,6 @@ const processTags = require('../../process-tags')
  * profile event.
  *
  * @param {string} [enabled] - config.profiling.DD_PROFILING_ENABLED ('true' | 'false' | 'auto')
- * @returns {string}
  */
 function getActivation (enabled) {
   if (enabled === 'auto') return 'auto'