Skip to content

[DOCS-14069] Add tag enrichment documentation#36268

Open
domalessi wants to merge 7 commits intomasterfrom
domalessi/docs-14069-tag-enrichment
Open

[DOCS-14069] Add tag enrichment documentation#36268
domalessi wants to merge 7 commits intomasterfrom
domalessi/docs-14069-tag-enrichment

Conversation

@domalessi
Copy link
Copy Markdown
Contributor

@domalessi domalessi commented Apr 24, 2026

What does this PR do? What is the motivation?

Fixes DOCS-14069

Adds a new page documenting the Tag Enrichment feature (currently in Preview), which lets users enrich APM span telemetry with team and system tags sourced from Software Catalog entity metadata — without changing tracer configuration or redeploying code.

The page covers:

  • Default tag enrichment rules
  • Custom tag enrichment rules
  • Adding a rule from a service page
  • Tag enrichment behavior (impacted telemetry, historical data, rule processing order, interaction with remapping rules)

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

@domalessi @claude
[DOCS-14069] Add tag enrichment documentation
9f70c2f 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@domalessi domalessi requested a review from a team as a code owner April 24, 2026 17:49
@domalessi domalessi added the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 24, 2026
@domalessi @claude
[DOCS-14069] Add tag enrichment to left nav
be79a1d 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@domalessi
Copy link
Copy Markdown
Contributor Author

domalessi commented Apr 24, 2026

Editorial review card: https://datadoghq.atlassian.net/browse/DOCS-14173

@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Apr 24, 2026
domalessi
domalessi commented Apr 24, 2026
View reviewed changes
Comment thread content/en/tracing/services/tag_enrichment.md Outdated

## Prerequisites

You must have admin permissions to create tag enrichment rules.
Copy link
Copy Markdown
Contributor Author

@domalessi domalessi Apr 24, 2026

Choose a reason for hiding this comment

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

@marianafrangos Can we be more specific/prescriptive here? Do we mean 'Datadog Admin Role' when you say 'admin'?

Copy link
Copy Markdown
Contributor

@marianafrangos marianafrangos Apr 24, 2026

Choose a reason for hiding this comment

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

Yes, I meant Datadog Admin Role

@domalessi domalessi added the editorial review Waiting on a more in-depth review label Apr 24, 2026
@domalessi @claude
[DOCS-14069] Link Tag Enrichment nav path to in-app URL
978edbd 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 24, 2026

Preview links (active after the build_preview check completes)

New or renamed files

domalessi
domalessi commented Apr 24, 2026
View reviewed changes
Comment thread content/en/tracing/services/tag_enrichment.md

### Add a tag enrichment rule from a service page

On any service page that is missing a `team` or `system` tag, click **Add Tags** on the top banner to enrich telemetry for that service.
Copy link
Copy Markdown
Contributor Author

@domalessi domalessi Apr 24, 2026

Choose a reason for hiding this comment

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

@marianafrangos I'm having a hard time finding this in the UI. Can you point me in the right direction or take a screenshot for me?

Copy link
Copy Markdown
Contributor

@marianafrangos marianafrangos Apr 24, 2026

Choose a reason for hiding this comment

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

This will be rolled out early next week. I'm fine with removing it from the doc until then (or whatever is best practice)

Copy link
Copy Markdown
Contributor Author

@domalessi domalessi Apr 24, 2026

Choose a reason for hiding this comment

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

Let's leave this in, since this doc won't be merged until next week anyway. Let me know when the UI is ready, and I'll add a screenshot here!

@domalessi @claude
[DOCS-14069] Add screenshots and fix enrichment timing copy
2554205 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Apr 24, 2026
domalessi and others added 2 commits April 24, 2026 16:36
@domalessi @claude
[DOCS-14069] Specify Datadog Admin Role in prerequisites
bc8824f 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@domalessi @claude
[DOCS-14069] Rewrite overview for plain language
34419e0 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
domalessi
domalessi commented Apr 24, 2026
View reviewed changes
Comment thread content/en/tracing/services/tag_enrichment.md Outdated
@domalessi
Copy link
Copy Markdown
Contributor Author

domalessi commented Apr 24, 2026

Editorial review ticket: https://datadoghq.atlassian.net/browse/DOCS-14173

@domalessi domalessi removed the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@marianafrangos marianafrangos marianafrangos approved these changes

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review Images Images are added/removed with this PR

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@domalessi @marianafrangos