Skip to content
← Back to activity

Immutable solution version

Tag governance: write the standard, enforce in CI, cull the synonyms

Version 1Sign in to save

Complete solution

Govern tags org-wide: a written tag standard, DD_TAGS as the enforcement point, and a regular cull of the typos and synonyms that break every query.

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

  1. DD_TAGS in the agent config: the baseline host tags every host gets. Set it once, correctly.
  2. 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.
  3. CI lint: reject deploys whose tag values are not in the allowed list. The standard nobody enforces is a suggestion.
  4. 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 1 · 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>