Overview

Change Tracking streamlines troubleshooting and incident response by surfacing relevant changes to your service and its dependencies, enabling faster detection and remediation when issues arise.

Change Tracking supports monitoring of a range of modifications to your service and its dependencies including:

• Deployments
• Feature Flags
• Database Modifications
• Schema Changes
• Scale Adjustments
• Kubernetes Adjustments
• Kubernetes Pod Crashes
• Watchdog Alerts

For details on specific types of supported changes and setup requirements, see the Tracked changes section.

Using Change Tracking

Change Tracking is available on several pages in Datadog:

Monitor status page

View and analyze changes from the monitor status page.

Prerequisites

To use change tracking on the Monitor Status Page, ensure the appropriate service has been:

• Specified in the monitor query.
• Selected as part of a group.
• Added as a service tag on the monitor.

To analyze changes from the monitor status page:

1. Go to the monitor status page for the monitor you are analyzing.
2. Locate the change tracking timeline at the top of the page.
   • For monitors with multiple graphs (dictated by the group by in the monitor query), filter to an individual group.
3. Use the timeline together with the event graphs to correlate change events with the alert.
4. Click the change indicator in the timeline to view more details about the change in the side panel.
5. From the side panel, you can investigate more details about the change and take the following actions:
   • View the deployment in your CI/CD system.
   • View the latest commits in your repository.
   • Compare changes between deployments to identify potential issues.
   • Configure additional custom links in the deployment side panel to quickly access other resources relevant to you.

Services

View and analyze changes from the service page.

To analyze changes from the service page:

1. Navigate to the service page you want to investigate.
2. Locate the changes timeline in the Service Summary section.
3. Use the dropdown to view either:
   • Changes limited to the specific service (Changes by Service)
   • Changes to the specific service and dependent services that might impact this service (Changes by Service & Dependencies)
4. Click the change indicator to view detailed information and take remediation actions.

Dashboards

View and analyze changes from any dashboard.

Prerequisites

To see relevant changes within the timeline and as overlays on your dashboard, ensure you have set at least one timeseries widget.

To analyze changes from dashboards:

1. Navigate to your dashboard.
2. Click Show Overlays at the top of the page to enable the change timeline and change overlays on supported widgets.
3. Hover over any change indicator or overlay to view a summary of the change.
4. Click the change indicator or overlay to view detailed information and take remediation actions.

Tracked changes

Change Tracking follows these types of changes across your infrastructure:

Further reading

Additional helpful documentation, links, and articles:

Monitor Status PageDOCUMENTATION DashboardsDOCUMENTATION Service PageDOCUMENTATION Event Management APIDOCUMENTATION Deployment TrackingDOCUMENTATION LaunchDarklyDOCUMENTATION WatchdogDOCUMENTATION Database MonitoringDOCUMENTATION Data Streams MonitoringDOCUMENTATION