Skip to main content
iOS RUM SDK automatically generates events with relevant metrics and attributes. Each RUM event includes default attributes (such as view.url, device.type, geo.country) as well as event-specific metrics and attributes (such as view.time_spent, resource.method).

App startup metrics

During app startup, the iOS SDK automatically records app startup time and creates corresponding views.
Startup time measures the time interval from process start to the first applicationDidBecomeActive notification.

View monitoring

In iOS apps, views are automatically created when users visit different screens. Views start recording when users open a screen and stop when the view is no longer visible.
View Lifecycle Management:
  • Views don’t end immediately when stopped, but remain in inactive state for a period
  • If a new view starts during this period, the previous view will completely end
  • If no new view starts, the previous view will resume to active state
Background Behavior:
  • When app enters background, SDK retains the last active view and monitors background events
  • Background time is not counted toward the active view’s time_spent metric
  • If user returns to app immediately, SDK resumes the original time_spent measurement

Default attributes

iOS RUM SDK automatically attaches default attributes to all events, helping you understand user devices, network status, and app context.
The following device-related attributes are automatically attached to all events:
The following OS-related attributes are automatically attached to all events:
The following network-related attributes are automatically attached to resource and error events:
The following attributes relate to IP address geo-location:
Geo-location information is inferred by Flashcat backend based on client IP address. Precise GPS location is not collected on the client.
You can enable user tracking on all RUM events to correlate user sessions and simplify troubleshooting.
User attributes are optional but we recommend providing at least one. See Track user sessions.
Only the standard user fields above are supported. Other user attributes are not supported. If needed, configure them under context.

Event-specific attributes

Different event types have specific attributes and metrics.
Network errors carry information about the failed HTTP request in these additional attributes:
When the app crashes, these additional attributes are collected:

Data storage and security

Local storage

Before data is uploaded to Flashduty, it is stored in plaintext in the app sandbox’s cache directory (Library/Caches). This directory is protected by the iOS app sandbox, so other apps on the device cannot read it.
Security Notes:
  • If device is jailbroken, stored data may become readable
  • Sensitive data should not be included in RUM events, or should be obfuscated or filtered through Event Mapper before sending

Data management

To keep disk usage in check, the SDK manages local data automatically: Data collected while the user is offline is kept and uploaded once the network is back, so no monitoring data is lost.

SDK Integration

Learn how to integrate the iOS SDK

Advanced Configuration

Configure custom attributes, sampling, and event filtering

Insights

View and analyze collected RUM data