--- title: Getting Started with RUM Deployment Tracking description: >- Learn how to set up RUM to capture new releases, track your deployments, and analyze the performance in Datadog breadcrumbs: >- Docs > RUM & Session Replay > Real User Monitoring & Session Replay Guides > Getting Started with RUM Deployment Tracking --- # Getting Started with RUM Deployment Tracking ## Overview{% #overview %} As teams iterate quickly and deploy code, it can be difficult to find the exact change that caused a spike in errors or slower page load times. RUM Deployment Tracking enables you to identify when a recent deployment or release is causing performance issues within your application and help you identify the source of the problem. ## Setup{% #setup %} You can use the `version` tag to monitor deployments and service behavior in support of your software deployment strategy. To get started with RUM Deployment tracking you must add RUM versions to your application. ### Browser RUM{% #browser-rum %} {% tab title="npm" %} ```javascript import { datadogRum } from '@datadog/browser-rum'; // Initialize Datadog Browser SDK datadogRum.init({ ... version: '1.0.0', ... }); ``` {% /tab %} {% tab title="CDN async" %} ```javascript window.DD_RUM.onReady(function() { window.DD_RUM.init({ ... version: '1.0.0', ... }) }) ``` {% /tab %} {% tab title="CDN sync" %} ```javascript window.DD_RUM && window.DD_RUM.init({ ... version: '1.0.0', ... }) ``` {% /tab %} ### Mobile RUM{% #mobile-rum %} #### Android RUM{% #android-rum %} The version tag is captured automatically from the application's manifest. #### iOS RUM{% #ios-rum %} The version tag is captured automatically from the application's `info.plist`. ## Analyze your deployment performance in RUM{% #analyze-your-deployment-performance-in-rum %} {% tab title="Browser RUM" %} ### Using version tags on the Application Overview page{% #using-version-tags-on-the-application-overview-page %} An application configured with version tags has a **Deployment Tracking** section on the Application Overview page. The **Deployment Tracking** section shows all versions of the application and services that were active during the selected time interval. This enables you to roll back release candidates as soon as you notice an issue so you can avoid negative user experiences. These out of the box graphs are aggregated across versions, making it easier to identify problems in your application before they turn into serious issues. You will see: - P75 Loading Time by Version - Total User Sessions by Version - Error Rate by Version In the table below these widgets, you will see: - The version names deployed for the application and its services over the timeframe. - Number of user session for that version - Average errors per view - P75 Loading Time - P75 for Core Web Vitals These widgets can be exported to dashboards and monitors. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-rum-app-overview-deployment-tracking.fe5282b9023e61dd7d1c90347aab2fa8.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-rum-app-overview-deployment-tracking.fe5282b9023e61dd7d1c90347aab2fa8.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Browser Deployment Tracking in RUM Application Overview" /%} ### Deployment Comparison{% #deployment-comparison %} Click on any version row in the **List of Versions**\* table to open a version comparison page, allowing you to compare two versions of the same service. By default, the selected version is compared to all previous versions. You can change the selection to compare any two versions within the past 30 days. Similar to the graphs on the **Application Overview** page, the **User Sessions**, **Core Web Vitals**, and **Errors** graphs show an overview of a deployment rollout or spikes in error rates. On this page, the graphs highlight the selected versions for comparison and display all other versions in gray for additional context. As you are monitoring your release, this helps you to compare the performance of code deployments against existing live code to verify that new code is performing properly, and that no new errors have surfaced in between versions. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-comparison.0ea3d30f4ca77ec048de005c95f7720d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-comparison.0ea3d30f4ca77ec048de005c95f7720d.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Browser Deployment Tracking Comparison" /%} The **Issues** tab lists differences in errors detected for each of the two versions, highlighting: - Error Count by Version - % of Views with Errors by Version - Error Tracking issues {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-comparison-error.69f4142a8be557e7ad2101e2225ed302.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-comparison-error.69f4142a8be557e7ad2101e2225ed302.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Browser Deployment Tracking Comparison Errors" /%} ### Explore the RUM deployment tracking powerpacks{% #explore-the-rum-deployment-tracking-powerpacks %} You can add deployment tracking for your RUM services to dashboards using the powerpacks menu on a dashboard and searching for the "Deployment Version Tracking" powerpack. You can then iterate and add any other widgets to your dashboards to help your teams release new features safely. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-powerpack.bacf7389014ea4a000c71386d615f5ea.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/browser-deployment-tracking-powerpack.bacf7389014ea4a000c71386d615f5ea.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Browser Deployment Tracking Powerpack" /%} {% /tab %} {% tab title="Mobile RUM" %} ### Using version tags on the Application Overview page{% #using-version-tags-on-the-application-overview-page %} An application configured with version tags has a **Deployment Tracking** section on the Application Overview page. The **Deployment Tracking** section shows all versions of the application and services that were active during the selected time interval. This enables you to quickly roll back release candidates as soon as you spot an issue so you can avoid negative user experiences. These out of the box graphs are aggregated across versions, making it easier to identify problems in your application before they turn into serious issues. You will see: - Average Application Start Time by Version - Total User Sessions by Version - Error Rate by Version In the table below these widgets, you will see: - The version names deployed for the application and its services over the timeframe. - Number of app launches for that version - Error Rate - Crash Rate - P90 Application Start Time These widgets can be exported to dashboards and monitors. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-rum-app-overview-deployment-tracking.e5ee8b87f70be03be3706f7f1ec6e4c9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-rum-app-overview-deployment-tracking.e5ee8b87f70be03be3706f7f1ec6e4c9.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Mobile Deployment Tracking in RUM Application Overview" /%} ### Deployment comparison{% #deployment-comparison %} Click on any version row in the **List of Versions** table to open a version comparison page, allowing you to compare two versions of the same service. By default, the selected version is compared to all previous versions. You can change the selection to compare any two versions within the past 30 days. Similar to the graphs on the **Application Overview** page, the **User Sessions**, **Mobile Vitals**, and **Errors** graphs show an overview of a deployment rollout or spikes in error rates. On this page, the graphs highlight the selected versions for comparison and display all other versions in gray for additional context. As you are monitoring your release, this makes it easy for you to compare the performance of code deployments against existing live code to verify that new code is performing properly and that no new errors have surfaced in between versions. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-comparison.54b785245eefd873212f04aa6423e25e.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-comparison.54b785245eefd873212f04aa6423e25e.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Mobile Deployment Tracking Comparison" /%} The **Issues** tab lists differences in errors detected for each of the two versions, highlighting: - Error Count by Version - % of Views with Errors by Version - Error Tracking issues {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-comparison-error.6d51f54cbab90ab6bcbaaba987f77950.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-comparison-error.6d51f54cbab90ab6bcbaaba987f77950.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Mobile Deployment Tracking Comparison Errors" /%} ### Explore the RUM Deployment Tracking Powerpacks{% #explore-the-rum-deployment-tracking-powerpacks %} You can add deployment tracking for your RUM services to dashboards using the powerpacks menu on a dashboard and searching for the "Deployment Version Tracking" powerpack. You can then iterate and add any other widgets to your dashboards to help your teams release new features safely. {% image source="https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-powerpack.eae4c4ea71382fbf248a055e1d3bdfa3.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/guide/setup-rum-deployment-tracking/mobile-deployment-tracking-powerpack.eae4c4ea71382fbf248a055e1d3bdfa3.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Browser Deployment Tracking Powerpack" /%} {% /tab %} ## Further Reading{% #further-reading %} - [Visualize your RUM data in the RUM Explorer](https://docs.datadoghq.com/real_user_monitoring/explorer) - [Use Version tags within Datadog APM to monitor deployments](https://docs.datadoghq.com/tracing/version_tracking) - [Troubleshoot faulty frontend deployments with Deployment Tracking in RUM](https://www.datadoghq.com/blog/datadog-rum-deployment-tracking)