Configure the Splunk iOS RUM instrumentation 🔗
You can configure the iOS RUM agent from the Splunk OpenTelemetry Instrumentation for iOS to add custom attributes, adapt the instrumentation to your environment and application, customize sampling, and more.
To configure the iOS RUM agent, pass the settings as arguments when initializating the SplunkRum
module. The following example shows how to configure the RUM token, beacon URL, and environment name:
import SplunkOtel
//..
SplunkRum.initialize(beaconUrl: "https://rum-ingest.<realm>.signalfx.com/v1/rum",
rumAuth: "<rum-token>",
options: SplunkRumOptions(environment:"<environment-name>"))
@import SplunkOtel;
//Create an options object to store the settings
SplunkRumOptions *options = [[SplunkRumOptions alloc] init];
options.environment = @"<environment-name>";
[SplunkRum initializeWithBeaconUrl:@"https://rum-ingest.<realm>.signalfx.com/v1/rum" rumAuth: @"<rum-token>" options: options];
General settings 🔗
Use the following settings to configure the iOS RUM agent:
Option |
Description |
---|---|
|
Ingest URL to which the agent sends collected telemetry. The URL must contain your realm in Splunk Observability Cloud. For example, |
|
RUM token that authorizes the agent to send telemetry data to Splunk Observability Cloud. To generate a RUM access token, see Generate your RUM access token in Observability Cloud. |
|
Sets additional attributes added to all spans. Attributes are defined as an array of comma-separated key-value pairs. For example: |
|
Environment for all the spans produced by the application. For example, |
|
Regular expression pattern that matches URLs you want to ignore when reporting HTTP activity. |
|
Closure of type |
|
Percentage of sessions to sample. Expressed as a proportion in the range |
|
If set to |
|
Activates caching of exported spans. All spans are written to local storage and deleted after a successful export. The default value is |
|
Threshold, in megabytes, from which spans start to be dropped from the disk cache. The oldest spans are dropped first. Only applicable when disk caching is activated. The default value is |
|
Activates the slow rendering detection feature. The default value is |
|
Optional setting that tags as slow all frames that took more than the specified time, in milliseconds. The default value is |
|
Optional setting that tags as frozen all frames that took more than the specified time, in milliseconds. The default value is |
|
Activates debug logging. The default value is |
Instrumentation settings 🔗
Use the following settings to activate or deactivate the collection of specific data:
Option |
Description |
---|---|
|
Activates the creation of spans for |
|
Activates the creation of spans for changes to the screen name. |
|
Activates the creation of spans for network activities. |