Single-View AI Investigation
Overview
Single-View AI Investigation runs an agentic root-cause analysis on a single RUM view. When you find a session with poor performance, such as a page or screen that loaded slowly or threw errors, click Investigate with AI. Datadog’s RUM agent inspects all the data attached to that view: errors, slow network requests, main-thread blocking, backend traces, CPU profiles, and device context.
Instead of manually combing through RUM events to figure out whether the cause was a slow API call, a heavy client-side computation, or a CDN issue, you get a ranked list of findings grouped by root-cause category: App Performance, Server Side, Third Party, and Environment. From there, you can follow up through a chat interface or save the results to a Notebook to share with your team.
Data analyzed
To investigate a view, Datadog’s RUM agent inspects the data Datadog has collected for that view and accesses correlated telemetry when it’s available:
- The view event and its sub-events: resources, long tasks, errors, and user actions.
- Aggregated performance signals across the view, including auto-detected problems such as uncompressed resources, excessive script evaluation, and bandwidth inefficiencies.
- Device and environment context captured by the SDK (browser or operating system, geography, connection type, and other RUM attributes).
- APM traces, when the view’s resources are correlated with backend traces. The agent uses the trace data to attribute server-side delays to specific spans and services. For more information, see Correlate RUM with APM Traces.
- Profiling data, when RUM profiling correlation is enabled for the application. The agent uses CPU profiles to attribute App Performance findings to specific functions in your code.
The richer the data available for the view, the more precise the analysis. Correlating RUM with APM and enabling profiling helps the agent investigate beyond the client-side timeline.
Launch an investigation
Open a RUM view side panel.
Click the Investigate with AI button.
Note: The button can take up to 15 minutes to become available after a view ends.
The investigation runs and streams results into the side panel as they become available, so you can start reading the first findings before the analysis is complete.
Sources of root causes
Datadog’s RUM agent looks at four sources to identify the root causes of poor performance on a view:
| Source | What is examined |
|---|
| App Performance | Client-side issues, such as main-thread contention, code execution, and rendering delays. |
| Server Side | Backend latency and server-side errors that affected the view. |
| Third Party | Performance impact from third-party scripts and libraries loaded by the application. |
| Environment | Network and infrastructure conditions that affected the user’s experience. |
Read the results
Each finding is shown as a card with a title, a description of the issue, a severity level, and links to the affected events. Multiple findings appear ranked by impact so you can focus on the highest-impact issues first.
A lightweight chat interface lets you follow up on the analysis: ask for more detail on a specific finding, request additional context, or explore related symptoms.
Save investigations to a Notebook to share with your team for future reference.
Further reading
Additional helpful documentation, links, and articles: