feat(apple): Add docs on Core Data APM (#4815)

Co-authored-by: Bruno Garcia <[email protected]>
Co-authored-by: Philipp Hofmann <[email protected]>
Co-authored-by: Isabel <[email protected]>

Author: 4 people

src/platforms/apple/common/configuration/swizzling.mdx

@@ -10,6 +10,7 @@ __macOS__
 - <PlatformLink to="/enriching-events/breadcrumbs/">Breadcrumbs for touch events</PlatformLink>
 - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#http-instrumentation">Auto instrumentation for HTTP requests</PlatformLink>
 - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#file-io-instrumentation">Auto instrumentation for File I/O operations</PlatformLink>
+- <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#core-data-instrumentation">Auto instrumentation for Core Data operations</PlatformLink>
 - <PlatformLink to="/performance/connect-services/">Automatically added sentry-trace header to HTTP requests for distributed tracing</PlatformLink>
 
 
@@ -19,6 +20,7 @@ __iOS, tvOS and Catalyst__
 - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#uiviewcontroller-instrumentation">Auto instrumentation for UIViewControllers</PlatformLink>
 - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#http-instrumentation">Auto instrumentation for HTTP requests</PlatformLink>
 - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#file-io-instrumentation">Auto instrumentation for File I/O operations</PlatformLink>
+- <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#core-data-instrumentation">Auto instrumentation for Core Data operations</PlatformLink>
 - <PlatformLink to="/performance/connect-services/">Automatically added sentry-trace header to HTTP requests for distributed tracing</PlatformLink>
 
 Since Cocoa 7.5.0, you can opt out of swizzling using options. When you disable swizzling, the SDK disables the features above:

src/platforms/apple/common/performance/instrumentation/automatic-instrumentation.mdx

@@ -132,6 +132,35 @@ SentrySDK.start { options in
 [NSString]: https://developer.apple.com/documentation/foundation/nsstring
 [NSBundle]: https://developer.apple.com/documentation/foundation/nsbundle
 
+## Core Data Instrumentation
+
+<Alert level="info" title="Important">
+
+This is an experimental feature and requires an opt-in. Experimental features are still a work-in-progress and may have bugs. We recognize the irony.
+
+</Alert>
+
+The Sentry SDK adds spans for Core Data operations to ongoing transactions bound to the scope. Currently, the SDK supports fetch and save operations with [NSManagedObjectContext](https://developer.apple.com/documentation/coredata/nsmanagedobjectcontext).
+To enable file I/O instrumentation:
+
+```swift {tabTitle:Swift}
+import Sentry
+
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.enableCoreDataTracking = true
+}
+```
+
+```objc {tabTitle:Objective-C}
+@import Sentry;
+
+[SentrySDK startWithConfigureOptions:^(SentryOptions *options) {
+    options.dsn = @"___PUBLIC_DSN___";
+    options.enableCoreDataTracking = YES;
+}];
+```
+
 ## Opt Out
 
 You can opt out of UIViewController, App Start, Slow and Frozen Frames, and HTTP Instrumentation using options: