From 47e8ed6371b3dd9b3238103cd88998d3b7469142 Mon Sep 17 00:00:00 2001
From: Stuart McCulloch <stuart.mcculloch@datadoghq.com>
Date: Fri, 23 Jan 2026 22:11:55 +0000
Subject: [PATCH] Support DD_TRACE_LOG_LEVEL

---
 .../src/main/java/datadog/trace/bootstrap/Agent.java       | 7 +++++--
 .../main/java/datadog/trace/api/config/GeneralConfig.java  | 1 +
 internal-api/src/main/java/datadog/trace/api/Config.java   | 3 ++-
 metadata/supported-configurations.json                     | 6 +++---
 4 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/dd-java-agent/agent-bootstrap/src/main/java/datadog/trace/bootstrap/Agent.java b/dd-java-agent/agent-bootstrap/src/main/java/datadog/trace/bootstrap/Agent.java
index f19a034fd12..25a83c93308 100644
--- a/dd-java-agent/agent-bootstrap/src/main/java/datadog/trace/bootstrap/Agent.java
+++ b/dd-java-agent/agent-bootstrap/src/main/java/datadog/trace/bootstrap/Agent.java
@@ -1481,9 +1481,12 @@ private static void configureLogger() {
     if (isDebugMode()) {
       logLevel = "DEBUG";
     } else {
-      logLevel = ddGetProperty("dd.log.level");
+      logLevel = ddGetProperty("dd.trace.log.level");
       if (null == logLevel) {
-        logLevel = EnvironmentVariables.get("OTEL_LOG_LEVEL");
+        logLevel = ddGetProperty("dd.log.level");
+        if (null == logLevel) {
+          logLevel = EnvironmentVariables.get("OTEL_LOG_LEVEL");
+        }
       }
     }
 
diff --git a/dd-trace-api/src/main/java/datadog/trace/api/config/GeneralConfig.java b/dd-trace-api/src/main/java/datadog/trace/api/config/GeneralConfig.java
index 8b6ed02380c..60e94418f09 100644
--- a/dd-trace-api/src/main/java/datadog/trace/api/config/GeneralConfig.java
+++ b/dd-trace-api/src/main/java/datadog/trace/api/config/GeneralConfig.java
@@ -35,6 +35,7 @@ public final class GeneralConfig {
       "experimental.propagate.process.tags.enabled";
 
   public static final String LOG_LEVEL = "log.level";
+  public static final String TRACE_LOG_LEVEL = "trace.log.level";
   public static final String TRACE_DEBUG = "trace.debug";
   public static final String TRACE_TRIAGE = "trace.triage";
   public static final String TRIAGE_REPORT_TRIGGER = "triage.report.trigger";
diff --git a/internal-api/src/main/java/datadog/trace/api/Config.java b/internal-api/src/main/java/datadog/trace/api/Config.java
index 07699f7e6b2..6c106ee1d33 100644
--- a/internal-api/src/main/java/datadog/trace/api/Config.java
+++ b/internal-api/src/main/java/datadog/trace/api/Config.java
@@ -403,6 +403,7 @@
 import static datadog.trace.api.config.GeneralConfig.TRACER_METRICS_MAX_AGGREGATES;
 import static datadog.trace.api.config.GeneralConfig.TRACER_METRICS_MAX_PENDING;
 import static datadog.trace.api.config.GeneralConfig.TRACE_DEBUG;
+import static datadog.trace.api.config.GeneralConfig.TRACE_LOG_LEVEL;
 import static datadog.trace.api.config.GeneralConfig.TRACE_STATS_COMPUTATION_ENABLED;
 import static datadog.trace.api.config.GeneralConfig.TRACE_TAGS;
 import static datadog.trace.api.config.GeneralConfig.TRACE_TRIAGE;
@@ -2718,7 +2719,7 @@ PROFILING_DATADOG_PROFILER_ENABLED, isDatadogProfilerSafeInCurrentEnvironment())
 
     servletAsyncTimeoutError = configProvider.getBoolean(SERVLET_ASYNC_TIMEOUT_ERROR, true);
 
-    logLevel = configProvider.getString(LOG_LEVEL);
+    logLevel = configProvider.getString(TRACE_LOG_LEVEL, null, LOG_LEVEL);
     debugEnabled = configProvider.getBoolean(TRACE_DEBUG, false);
     triageEnabled = configProvider.getBoolean(TRACE_TRIAGE, instrumenterConfig.isTriageEnabled());
     triageReportTrigger = configProvider.getString(TRIAGE_REPORT_TRIGGER);
diff --git a/metadata/supported-configurations.json b/metadata/supported-configurations.json
index bdba0282da7..597dd3edf2c 100644
--- a/metadata/supported-configurations.json
+++ b/metadata/supported-configurations.json
@@ -2209,12 +2209,12 @@
         "aliases": ["DD_LOGS_INJECTION"]
       }
     ],
-    "DD_LOG_LEVEL": [
+    "DD_TRACE_LOG_LEVEL": [
       {
-        "version": "B",
+        "version": "A",
         "type": "string",
         "default": null,
-        "aliases": []
+        "aliases": ["DD_LOG_LEVEL"]
       }
     ],
     "DD_LOG_FORMAT_JSON": [