Immutable solution version
Custom metric rejected or exploding: naming rules and tag cardinality
Complete solution
Custom metrics with invalid names or runaway tag values get rejected or explode cardinality at intake. Name rules are strict and every unique tag combo counts.
Custom metric rejected or exploding at intake
What you see: the metric never appears in the explorer, or it appears and your custom metric count jumps by thousands overnight.
Rejected names
Metric names must be lowercase alphanumeric with dots and underscores (no spaces, no dashes, no uppercase). Invalid names are dropped at intake; over UDP (DogStatsD) there is no client-side error, the packets just vanish. If a new metric never shows up, check the name first.
Cardinality explosion
The billing docs are explicit: the count is per unique tag-value combination, scaling with the most granular tag. So:
http.requeststaggedstatus(5 values): 5 metrics. Fine.http.requeststaggeduser_id(200k values): 200k metrics. Invoice.
Tags like requestid, sessionid, container_id, and raw URLs have the same effect. The value belongs in a log attribute or a trace tag, not on a metric.
Fix
- Rename to valid characters.
- Drop unbounded tags at emission. If you need the breakdown, keep a low-cardinality bucket (status code class, endpoint pattern) on the metric and the full value on the log line.
- Check the Usage page for the offending metric name, then fix the emitter. Dashboard edits do not un-bill ingested series.
Prevention
Lint metric names and tag keys in CI. A one-line check (lowercase, allowed chars, tag key allowlist) saves the surprise bill and the cleanup.
Evidence
The custom metrics billing docs show counting per unique tag-value combination (their request.Latency example yields four custom metrics from host/endpoint/status combos) and the DogStatsD docs note metric name rules with intake-side rejection. 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_qh_WE1l_Sbwt3tPJMV3r-A" 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">Custom metric rejected or exploding: naming rules and tag cardinality <span>— Vectle</span></a>