Skip to content

Document configuring Autodiscovery with the DatadogInstrumentation CRD#37532

Draft
Mathew-Estafanous wants to merge 1 commit into
masterfrom
mathew.estafanous/docs-datadoginstrumentation-crd-autodiscovery
Draft

Document configuring Autodiscovery with the DatadogInstrumentation CRD#37532
Mathew-Estafanous wants to merge 1 commit into
masterfrom
mathew.estafanous/docs-datadoginstrumentation-crd-autodiscovery

Conversation

@Mathew-Estafanous

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Documents the new (beta) capability to configure Autodiscovery checks for Kubernetes workloads through the DatadogInstrumentation custom resource, instead of pod annotations. This lets users enable, update, and roll back integration configuration without editing pod specs or triggering Agent/application rollouts.

Changes:

  • New guide: Configure Autodiscovery with the DatadogInstrumentation CRD (content/en/containers/guide/configure-autodiscovery-with-the-datadoginstrumentation-crd.md). Covers requirements, enabling the controller with the Datadog Operator (opt-in annotation) or Helm (datadog.instrumentationCrd.enabled), the targetRef + spec.config.checks schema with a Redis example, endpoint/cluster checks via Service targets, precedence (annotations > CRD > static), one-resource-per-workload validation, status conditions, and limitations.
  • Cross-references so users discover the CRD wherever annotations are recommended:
    • containers/kubernetes/integrations.md: new "DatadogInstrumentation CRD" config-method tab + updated method list.
    • containers/guide/autodiscovery-examples.md: intro note + further reading.
    • getting_started/containers/autodiscovery.md: note in "Integration templates" + further reading.

Requirements documented: Agent & Cluster Agent v7.81+, Datadog Operator v1.28+, or Helm chart v2.223.0+.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

The feature is in beta. The guide and cross-references are labeled accordingly.

Add a new guide describing how to configure Autodiscovery checks for
Kubernetes workloads through the DatadogInstrumentation custom resource
(beta) instead of pod annotations, and cross-reference it from the
existing Autodiscovery pages.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions github-actions Bot added the Guide Content impacting a guide label Jun 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant