dynatrace/dt-obs-frontends
Real User Monitoring (RUM) on Dynatrace — web and mobile frontends. Core Web Vitals, user sessions, page performance, mobile crashes, frontend errors, and frontend-backend linking. Query via `user.events`, `user.sessions`, and `dt.frontend.*` metrics. Does NOT cover synthetic monitoring (HTTP/browser/network checks) — that's a separate domain.
npx skills add https://github.com/Dynatrace/dynatrace-for-ai --skill dt-obs-frontends
Monitor web and mobile frontends using Real User Monitoring with DQL.
Targets the New RUM Experience only — do not use classic RUM data.
Concepts and data model: https://docs.dynatrace.com/docs/observe/digital-experience/new-rum-experience/concepts
Three data sources, each for a different question:
| Source | Use for | Granularity |
|--------|---------|-------------|
| timeseries dt.frontend.* | Trends, dashboards, alerting | Aggregated metric |
| fetch user.events | Root cause, individual page views / requests / clicks / errors | Per-event |
| fetch user.sessions | Bounce rate, session duration, session-level aggregates | Per-session |
Rule of thumb: start with metrics for the shape of the problem, drill into events for the why. Use sessions when the question is about user journeys, not individual interactions.
Full event model: https://docs.dynatrace.com/docs/semantic-dictionary/model/rum/user-events
DQL language reference (functions, syntax, operators): https://docs.dynatrace.com/docs/platform/grail/dynatrace-query-language
Key dt.frontend.* metrics (all support dimensions: frontend.name, device.type, geo.country.iso_code, browser.name, os.name, dt.rum.user_type, dt.smartscape.frontend):
dt.frontend.web.page.largest_contentful_paint / dt.frontend.web.page.interaction_to_next_paint / dt.frontend.web.page.cumulative_layout_shift / dt.frontend.web.page.first_input_delay — Core Web Vitalsdt.frontend.web.navigation.time_to_first_byte / dt.frontend.web.navigation.dom_interactive / dt.frontend.web.navigation.load_event_end — Navigation timingdt.frontend.error.count — Error countsdt.frontend.request.count / dt.frontend.request.duration — Request volume and latencydt.frontend.user_action.count / dt.frontend.user_action.duration — User action volume and durationdt.frontend.session.active.estimated_count / dt.frontend.user.active.estimated_count — Active sessions and users (cardinality metrics; use countDistinct() aggregation)All sources (user.events + user.sessions):
frontend.name — frontend identifier (preferred for all filtering); array on user.sessions (session can span multiple frontends). dt.smartscape.frontend is the Smartscape entity reference — use it to access entity attributes such as tags or linked services, not for name-based filtering. Avoid querying Smartscape to resolve a name to an entity ID and then joining with user.events — always filter on frontend.name directly.dt.rum.user_type — real_user, synthetic, robotdt.rum.application.type — web or mobiledt.rum.session.id, dt.rum.instance.idos.name, geo.country.iso_code, client.ispclient.ip — client IP address *(sensitive field — hidden by default; see Field Permissions below)*user.events — web only:
browser.name, browser.version, device.typeuser.events — mobile only:
device.model.identifier, device.manufacturer, app.short_versionCommon characteristic filters (scope user.events to a specific event type — use as | filter characteristics.has_X):
characteristics.has_page_summary — page loads (web)characteristics.has_view_summary — views (SPA + mobile screens)characteristics.has_navigation — navigation eventscharacteristics.has_user_action — user actionscharacteristics.has_error — all errorsFull characteristics reference: references/characteristics.md
Some fields are sensitive and belong to the builtin-sensitive-user-events-and-sessions fieldset. They are hidden by default on both user.events and user.sessions — users without access see null, and queries that filter or group by these fields silently return no results.
Sensitive fields used in this skill:
client.ip — client IP addressuser.identifier — real user identityGrant access with the following policy statement:
ALLOW storage:fieldsets:read WHERE storage:fieldset-name="builtin-sensitive-user-events-and-sessions"
Reference: Field permissions
Most investigations follow this layered approach regardless of the specific problem domain (errors, performance, background activity, etc.):
1. Identify the frontend
Start by grouping by: {frontend.name} to find which application is affected. Filter by dt.rum.application.type (web or mobile) if you need to split web from mobile analysis upfront.
2. Find the affected page or view
Both fields are available on all events (not scoped to a specific characteristic):
page.name — the page URL normalised to a Dynatrace entity name; web onlyview.name — the SPA route or mobile screen name; available on web and mobileBoth can be present on the same event. For web SPAs, page.name reflects the top-level document while view.name reflects the current route — grouping by view.name gives finer granularity. For mobile, use view.name only.
Additional narrowing dimensions
| Dimension | Field | Platform | When to use |
|-----------|-------|----------|-------------|
| Specific request / endpoint | url.domain, url.path | web + mobile | Performance or error pattern on a specific API call |
| Individual user session | dt.rum.session.id | web + mobile | Reproduce a specific user's journey; connects to session replay |
| Device form factor | device.type | web only | Desktop vs mobile browser vs tablet pattern |
| Browser compatibility | browser.name, browser.version | web only | Issue only on certain browsers |
| App version | app.short_version | mobile only | Regression introduced in a specific app release |
| Geography | geo.country.iso_code | web + mobile | Regional infrastructure or CDN issue |
| Synthetic vs real traffic | dt.rum.user_type | web + mobile | Exclude synthetic monitors before user-facing analysis |
Each workflow maps to one or more references. Load the reference when you start the workflow, not upfront.
| Workflow | Reference |
|----------|-----------|
| Event characteristics — types, filters, event_type derivation | references/characteristics.md |
| Web Vitals (LCP, FCP, FID, INP, CLS) | references/web-vitals.md |
| Session, bounce, engagement analysis | references/user-sessions.md |
| User actions — interaction lifecycle, completion reasons, timeouts | references/user-actions.md |
| Errors, exceptions, frontend-backend linking | references/error-tracking.md |
| CSP violations — security policy enforcement and blocked resources | references/csp-violations.md |
| Mobile app starts, crashes, ANR, native signals | references/mobile-monitoring.md |
| Request latency, long tasks, JS profiling, geo performance | references/web-performance-analysis.md |
| Visibility changes — tab switching, background time, engagement quality | references/visibility-changes.md |
| Slow page load — backend vs render vs network vs JS triage | references/slow-page-load-playbook.md |
| Diagnosing zero results, anomalies, ambiguous data | references/troubleshooting.md |
*Web vitals thresholds (LCP, INP, CLS, FCP, TTFB): https://web.dev/articles/vitals*
Use this skill for real-user web and mobile frontend telemetry — Core Web Vitals, sessions, clicks, errors, crashes, request latency from the browser/app, and frontend-backend linking.
Use a different skill for:
dt-obs-syntheticdt-obs-services, dt-obs-tracingdt-obs-hostsdt-obs-logsdt-obs-problemsTake dynatrace/dt-obs-frontends from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.