Datadog v2 — Breaking Changes Checklist

7 items total3 critical~1 hour for a typical integration

Before You Upgrade

0/1

API v2 introduces changes to authentication methods. Ensure your integration uses the correct credentials.

Migrate from deprecated authentication tokens to API keys.Criticaleasy

The legacy authentication tokens are no longer supported in v2. You must use API keys for all requests.

⚠ Requests will be unauthorized and fail.

0/4

Several API endpoints and their request/response payloads have been modified in v2. Review these changes carefully.

Update metric submission payloads to conform to v2 schema.Criticalmedium

The format and required fields for submitting metrics have changed. Incorrect payloads will be rejected.

⚠ Metric data will not be ingested, leading to gaps in monitoring.

Modify log submission payloads to match v2 requirements.Highmedium

Log attributes and structure have been updated. Ensure your logs are formatted correctly for v2 ingestion.

⚠ Logs may not be indexed or searchable correctly.

Adapt trace submission payloads for v2 compatibility.Highmedium

Changes in trace span attributes and payload structure require updates to your tracing instrumentation.

⚠ Traces might be incomplete or not associated with the correct services.

Adjust how tags are handled in API requests and responses.Mediumeasy

Tagging conventions and API interactions for tags have been refined in v2.

⚠ Inconsistent or incorrect tagging may affect search and alerting.

0/2

Thorough testing is crucial after applying changes to ensure full functionality.

Execute integration tests against the v2 API endpoints.Criticaleasy

Validate all integration points that interact with the Datadog API to ensure they function as expected with v2.

⚠ Undiscovered issues could lead to production outages or data loss.

Monitor data ingestion and performance post-upgrade.Higheasy

Actively observe metrics, logs, and traces to confirm they are being received and processed correctly by Datadog.

⚠ Delayed detection of data ingestion failures.

Deprecatr AI monitors 150+ providers, maps changes to your codebase, and delivers migration checklists before your team hits a breaking change.