RUM: document Timeseries preview for the iOS and Android SDKs

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
 

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/
+[6]: /real_user_monitoring/application_monitoring/browser/advanced_configuration/
+[7]: /real_user_monitoring/application_monitoring/mobile_vitals/#performance-timeseries