From 8605055329849f5902fdfec8d08e449cb4265e73 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Barbora=20Pla=C5=A1ovsk=C3=A1?= <54357674+barboraplasovska@users.noreply.github.com> Date: Fri, 21 Aug 2026 10:45:49 +0200 Subject: [PATCH] RUM-17208 Document resource.local_cache_hit for iOS RUM SDK (#39202) * RUM-17208 Document resource.local_cache_hit for iOS RUM SDK * RUM-17208 Note local cache hit signal in iOS network tracking config * Apply suggestions from code review Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com> --------- Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com> --- hugo/layouts/shortcodes/mdoc/en/sdk/advanced_config/ios.mdoc.md | 2 ++ hugo/layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md | 1 + 2 files changed, 3 insertions(+) diff --git a/hugo/layouts/shortcodes/mdoc/en/sdk/advanced_config/ios.mdoc.md b/hugo/layouts/shortcodes/mdoc/en/sdk/advanced_config/ios.mdoc.md index 3408f37e865..92095626183 100644 --- a/hugo/layouts/shortcodes/mdoc/en/sdk/advanced_config/ios.mdoc.md +++ b/hugo/layouts/shortcodes/mdoc/en/sdk/advanced_config/ios.mdoc.md @@ -691,6 +691,7 @@ NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConf - Without `URLSessionInstrumentation`, network requests are still tracked. Enabling it provides detailed timing breakdown for performance analysis. - In registered-delegate mode (`URLSessionInstrumentation.enableDurationBreakdown`), the `data` parameter passed to `resourceAttributesProvider` is subject to constraints. See below for full details. - To filter out specific requests from being tracked, use the `resourceEventMapper` in `RUM.Configuration` (see [Modify or drop RUM events](#modify-or-drop-rum-events)). +- When a resource is served from the device's local cache, it is reported with `resource.local_cache_hit: true` (see [Resource attributes][10]). This signal is available only in registered-delegate instrumentation mode, not when using automatic instrumentation with completion-handler swizzling. {% alert level="info" %} Be mindful of delegate retention. @@ -1195,3 +1196,4 @@ Calling this method disables the SDK and all active features, such as RUM. To re [7]: https://www.ntppool.org/en/ [8]: /real_user_monitoring/error_tracking/mobile/ios/#add-app-hang-reporting [9]: /real_user_monitoring/application_monitoring/ios/setup +[10]: /real_user_monitoring/application_monitoring/ios/data_collected/#resource-attributes diff --git a/hugo/layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md b/hugo/layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md index 98065588bae..153cf883d35 100644 --- a/hugo/layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md +++ b/hugo/layouts/shortcodes/mdoc/en/sdk/data_collected/ios.mdoc.md @@ -206,6 +206,7 @@ The following attributes are collected for each view after collection is enabled | `resource.duration` | number | Entire time spent loading the resource. | | `resource.first_byte.duration` | number (ns) | Time spent waiting for the first byte of response to be received (responseStart - requestStart). | | `resource.id` | string | Unique identifier of the resource. | +| `resource.local_cache_hit` | Boolean | Whether the resource was served from the device's local cache. Sent only when `true`; absent otherwise. | | `resource.method` | string | The HTTP method (for example, `POST`, `GET`, `PATCH`, or `DELETE`). | | `resource.provider.name` | string | The resource provider name. Default is `unknown`. | | `resource.provider.domain` | string | The resource provider domain. |