Immutable solution version
Tag governance: write the standard, enforce in CI, cull the synonyms
Complete solution
Shows how to fix tag governance: write the standard, enforce in CI, cull the synonyms. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
Quarterly: list all tag values in use, find the synonyms and typos, fix the emitters, and watch the old values age out. DDTAGS in the agent config: the baseline host tags every host gets. Tracer env vars (DD\ENV, DD\SERVICE, DD\VERSION): the app-level tags. Common finds: env:prod vs env:production, service:api vs service:API, a deploy that tagged version:latest (a version tag that never changes is a lie).
When to use
You are seeing this: Every Datadog query is a tag query. Use this skill when you run into "Tag governance: write the standard, enforce in CI, cull the synonyms".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.
Tag governance: the standard, the enforcement, the cull
Every Datadog query is a tag query. Tag chaos (env vs environment, prod vs production, team-checkout vs checkout-team) silently breaks dashboards, monitors, and SLOs. Governance is a written standard plus enforcement.
The standard
Write it down, one page: the mandatory tags (service, env, version, team), the allowed values for each (prod, staging, dev: pick spellings, no synonyms), the case convention, and the forbidden patterns (no IDs, no timestamps, no free text). One page, linked from onboarding, enforced in review.
Enforcement points
- DD_TAGS in the agent config: the baseline host tags every host gets. Set it once, correctly.
- Tracer env vars (
DD_ENV,DD_SERVICE,DD_VERSION): the app-level tags. Bake them into the deploy pipeline so no service ships without them. - CI lint: reject deploys whose tag values are not in the allowed list. The standard nobody enforces is a suggestion.
- Terraform: tag arguments on every Datadog resource, from the same variable set.
The cull
Quarterly: list all tag values in use, find the synonyms and typos, fix the emitters, and watch the old values age out. Common finds: env:prod vs env:production, service:api vs service:API, a deploy that tagged version:latest (a version tag that never changes is a lie).
Verify
A fresh deploy of any service shows exactly the standard tags with allowed values. The tag-value list has no synonyms. A monitor filtering env:prod catches every production service, and you proved it by checking the outliers, not by assuming.
Evidence
The unified service tagging docs define the standard tags (service, env, version) used across metrics, traces, and logs; DD_TAGS sets host tags in the Agent config. Verified against live docs 2026-09-26.
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_ckiUrWRy_NruQaTmpEAOWg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Tag governance: write the standard, enforce in CI, cull the synonyms <span>— Vectle</span></a>