Skip to content

Conversation

@zhuminyi
Copy link
Contributor

@zhuminyi zhuminyi commented Dec 22, 2025

What does this PR do?

This PR documents the check_tag_cardinality parameter support in Kubernetes Autodiscovery annotations. Specifically:

  1. Updates the "Per-check tag configuration" section in /getting_started/integrations/ to include a tabbed view showing both configuration file and Kubernetes annotation methods
  2. Adds an "Advanced annotation parameters" section in /containers/kubernetes/integrations/ documenting the check_tag_cardinality annotation
  3. Adds an info callout clarifying that check_tag_cardinality only affects integration check metrics, not DogStatsD metrics

Motivation

The Datadog Agent supports setting tag cardinality (check_tag_cardinality) on a per-check basis through both configuration files and Kubernetes Autodiscovery annotations. However, the public documentation only covered the config file usage and did not mention the Autodiscovery annotation support.

This PR closes that documentation gap by showing users how to use the annotation:
ad.datadoghq.com/<CONTAINER_NAME>.check_tag_cardinality: "<low|orchestrator|high>"

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@zhuminyi zhuminyi force-pushed the zhuminyi/CONTP-1096 branch from 2433611 to 6036e3d Compare December 22, 2025 15:48
@zhuminyi zhuminyi changed the title Add check_tag_cardinality [CONTP-1096] Document check_tag_cardinality in Kubernetes Autodiscovery annotations Dec 22, 2025
@github-actions
Copy link
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants