diff --git a/hugo/content/en/real_user_monitoring/application_monitoring/mobile_vitals/_index.md b/hugo/content/en/real_user_monitoring/application_monitoring/mobile_vitals/_index.md index 8e3f4e5ac29..fbd6bbd48bc 100644 --- a/hugo/content/en/real_user_monitoring/application_monitoring/mobile_vitals/_index.md +++ b/hugo/content/en/real_user_monitoring/application_monitoring/mobile_vitals/_index.md @@ -1,6 +1,6 @@ --- title: Mobile Vitals -description: "Monitor key mobile performance metrics including startup times, frame rates, and resource usage across Android, iOS, Flutter, and React Native." +description: "Monitor key mobile performance metrics including startup times, frame rates, resource usage, and performance timeseries across Android, iOS, Flutter, and React Native." aliases: - /real_user_monitoring/android/mobile_vitals - /real_user_monitoring/ios/mobile_vitals @@ -19,6 +19,9 @@ further_reading: - link: https://github.com/DataDog/dd-sdk-reactnative tag: "Source Code" text: Source code for dd-sdk-reactnative +- link: /real_user_monitoring/explorer/events/#performance-timeseries + tag: Documentation + text: Explore the performance timeseries panel - link: /real_user_monitoring tag: Documentation text: Explore Datadog RUM @@ -158,10 +161,32 @@ The following telemetry provide insight into your mobile application's performan {{< /tabs >}} +## Performance timeseries + +{{< callout url="https://www.datadoghq.com/product-preview/rum-timeseries/" btn_hidden="false" header="Join the Preview!">}} +Performance timeseries is in Preview, and collection is off by default. To enable it, join the Preview. Datadog sends setup instructions to participating customers. +{{< /callout >}} + +Performance timeseries is available on the iOS and Android SDKs. + +Standard mobile vitals report memory utilization averaged over the lifetime of the view. Performance timeseries captures memory and CPU usage every second for the length of the session, and displays the results on an interactive graph in the session, view, and operation [side panels][3]. + +{{< img src="real_user_monitoring/mobile_vitals/timeseries-panel.png" alt="The Performance Timeseries section of a RUM side panel, showing an interactive Memory and CPU graph over the length of a session" style="width:100%;" >}} + +After collection is enabled, timeseries are captured for all sessions. + +Two series are collected: + +- **CPU usage**: the percentage of the device's total CPU capacity across all cores consumed by your application. This differs from the CPU ticks per second reported for a view. +- **Memory**: the same value the SDK already collects for view memory vitals. See [view memory collection on iOS][4] and [on Android][5]. + ## Further Reading {{< partial name="whats-next/whats-next.html" >}} [1]: https://developer.android.com/topic/performance/vitals [2]: https://developer.apple.com/documentation/metrickit +[3]: /real_user_monitoring/explorer/events/#performance-timeseries +[4]: /real_user_monitoring/application_monitoring/ios/data_collected/#view-memory-collection +[5]: /real_user_monitoring/application_monitoring/android/data_collected/#view-memory-collection diff --git a/hugo/content/en/real_user_monitoring/explorer/events.md b/hugo/content/en/real_user_monitoring/explorer/events.md index e07ce09a143..344262113e2 100644 --- a/hugo/content/en/real_user_monitoring/explorer/events.md +++ b/hugo/content/en/real_user_monitoring/explorer/events.md @@ -1,10 +1,13 @@ --- title: Events Side Panel -description: "View detailed information about individual RUM events including context, waterfalls, and performance data in the side panel." +description: "View detailed information about individual RUM events including context, waterfalls, performance timeseries, and performance data in the side panel." further_reading: - link: "/real_user_monitoring/explorer/search/" tag: "Documentation" text: "Search for your events" +- link: "/real_user_monitoring/application_monitoring/mobile_vitals/#performance-timeseries" + tag: "Documentation" + text: "Mobile Vitals and performance timeseries" --- ## Overview @@ -58,6 +61,20 @@ Click on events in the waterfall to access related data: - {{< ui >}}Resources{{< /ui >}}: View connected backend traces. - {{< ui >}}Long Animation Frames{{< /ui >}}: Access associated profiles for performance analysis. +## Performance timeseries + +{{< callout url="https://www.datadoghq.com/product-preview/rum-timeseries/" btn_hidden="false" header="Join the Preview!">}} +Performance timeseries is in Preview, and collection is off by default. To enable it, join the Preview. Datadog sends setup instructions to participating customers. +{{< /callout >}} + +{{< img src="real_user_monitoring/mobile_vitals/timeseries-panel.png" alt="The Performance Timeseries section of a RUM side panel, showing an interactive Memory and CPU graph over the length of a session" style="width:100%;" >}} + +For sessions from the iOS and Android SDKs, the {{< ui >}}Performance Timeseries{{< /ui >}} section displays a {{< ui >}}Memory & CPU{{< /ui >}} graph of your application's resource usage, captured every second across the session. It is available on the session, view, and operation side panels. + +The graph covers the full session. When you open it from a view or an operation, markers show where that view or operation starts and ends, so you can read its resource usage against everything that ran around it. Periods when the application was in the background are shaded. + +For what each series measures, see [Mobile Vitals][7]. + ## Additional tabs Use the other tabs to explore related data: @@ -95,4 +112,5 @@ Use the other tabs to explore related data: [3]: /real_user_monitoring/application_monitoring/browser/monitoring_page_performance/#event-timings-and-core-web-vitals [4]: /real_user_monitoring/application_monitoring/browser/monitoring_page_performance/#track-additional-performance-timings [5]: /real_user_monitoring/rum_without_limits/retention_filters -[6]: /real_user_monitoring/application_monitoring/browser/advanced_configuration/ \ No newline at end of file +[6]: /real_user_monitoring/application_monitoring/browser/advanced_configuration/ +[7]: /real_user_monitoring/application_monitoring/mobile_vitals/#performance-timeseries diff --git a/hugo/static/images/real_user_monitoring/mobile_vitals/timeseries-panel.png b/hugo/static/images/real_user_monitoring/mobile_vitals/timeseries-panel.png new file mode 100644 index 00000000000..fdd46dd9ba4 Binary files /dev/null and b/hugo/static/images/real_user_monitoring/mobile_vitals/timeseries-panel.png differ