From a0b9c45ade112857d36d5da9c69aad93c8244298 Mon Sep 17 00:00:00 2001 From: Lucas Pimentel Date: Fri, 13 Feb 2026 10:08:26 -0500 Subject: [PATCH 1/2] Add tracer config docs to AGENTS.md for AI reference --- AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 49219d52feaa..c290772c19f1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -396,6 +396,11 @@ The tracer runs in-process with customer applications and must have minimal perf - `docs/development/CI/TroubleshootingCIFailures.md` — Investigating build/test failures in Azure DevOps - `docs/development/CI/RunSmokeTestsLocally.md` — Running smoke tests locally +## Configuration + +📖 **Load when**: Need reference for tracer configuration settings and environment variables +- **`tracer/src/Datadog.Trace/Configuration/supported-configurations-docs.yaml`** — Complete reference of all `DD_*` environment variables with descriptions and default values + ## Security & Configuration - Do not commit secrets; prefer env vars (`DD_*`). `.env` should not contain credentials. From d24785926d434e41057461f25702904e62884a44 Mon Sep 17 00:00:00 2001 From: Lucas Pimentel Date: Fri, 13 Feb 2026 11:57:50 -0500 Subject: [PATCH 2/2] Add JSON config reference and config key guide to AGENTS.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🤖 Co-Authored-By: Claude Code --- AGENTS.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index c290772c19f1..8ae903656d67 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -399,7 +399,11 @@ The tracer runs in-process with customer applications and must have minimal perf ## Configuration 📖 **Load when**: Need reference for tracer configuration settings and environment variables -- **`tracer/src/Datadog.Trace/Configuration/supported-configurations-docs.yaml`** — Complete reference of all `DD_*` environment variables with descriptions and default values +- **`tracer/src/Datadog.Trace/Configuration/supported-configurations-docs.yaml`** — Human-readable descriptions and default values for all `DD_*` environment variables +- **`tracer/src/Datadog.Trace/Configuration/supported-configurations.json`** — Machine-readable config metadata: product categorization, key aliases, and deprecations (consumed by source generators) + +📖 **Load when**: Adding a new `DD_*` configuration key or modifying the configuration system +- **`docs/development/Configuration/AddingConfigurationKeys.md`** — Step-by-step guide for adding config keys: JSON/YAML definitions, source generators, aliases, telemetry normalization, and related analyzers ## Security & Configuration