Skip to content

[docs for ai] Add configuration reference docs to AGENTS.md #8201

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lucaspimentel merged 2 commits into from
Feb 13, 2026
Merged

[docs for ai] Add configuration reference docs to AGENTS.md #8201

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0b9c45
Add tracer config docs to AGENTS.md for AI reference
lucaspimentel Feb 13, 2026
d247859
Add JSON config reference and config key guide to AGENTS.md
lucaspimentel Feb 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -396,6 +396,15 @@ 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`** — 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

@lucaspimentel lucaspimentel Feb 13, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of these (like adding a new config or Azure Functions details) could be converted into skills that don't require calling explicitly with a slash command (disable-model-invocation: false) to reduce the size of this file.

I'll look into that later.

- **`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

- Do not commit secrets; prefer env vars (`DD_*`). `.env` should not contain credentials.
Expand Down
Loading