feat: update docs for profiling v2 (#13197)

* feat(profiling[cocoa]): update docs for profiling v2

* add example of manual profiling

* improve table view example

* Update docs/platforms/apple/common/profiling/index.mdx

Co-authored-by: Shannon Anahata <[email protected]>

* Update docs/platforms/apple/common/profiling/index.mdx

Co-authored-by: Shannon Anahata <[email protected]>

* Update docs/platforms/apple/common/profiling/index.mdx

Co-authored-by: Shannon Anahata <[email protected]>

* Apply suggestions from code review

Co-authored-by: Shannon Anahata <[email protected]>

* pr feedback

* more feedback

---------

Co-authored-by: Shannon Anahata <[email protected]>

Author: armcknight

docs/platforms/apple/common/index.mdx

@@ -87,7 +87,7 @@ To capture all errors, initialize the SDK as soon as possible, such as in your `
 
 <PlatformSection notSupported={["apple.tvos", "apple.watchos", "apple.visionos"]}>
 
-```swift {tabTitle:Swift} {"onboardingOptions": {"performance": "13-16", "profiling": "18-28"}}
+```swift {tabTitle:Swift} {"onboardingOptions": {"performance": "13-16", "profiling": "17-21"}}
 import Sentry
 
 func application(_ application: UIApplication,
@@ -101,27 +101,21 @@ func application(_ application: UIApplication,
         // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
         options.sendDefaultPii = true
 
-        // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
+        // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
-        options.tracesSampleRate = 1.0
+        options.tracesSampleRate = 1
+        
+        options.configureProfiling = {
+            $0.lifecycle = .trace
+            $0.sessionSampleRate = 1
+        }
     }
 
-    // Manually call startProfiler and stopProfiler to profile any code that runs in between.
-    SentrySDK.startProfiler()
-
-    //
-    // ...anything here will be profiled...
-    //
-
-    // Calls to stopProfiler are optional - if you don't stop the profiler, it will keep profiling
-    // your application until the process exits, the app goes to the background, or stopProfiling is called.
-    SentrySDK.stopProfiler()
-
     return true
 }
 ```
 
-```objc {tabTitle:Objective-C} {"onboardingOptions": {"performance": "12-15", "profiling": "17-27"}}
+```objc {tabTitle:Objective-C} {"onboardingOptions": {"performance": "12-15", "profiling": "16-20"}}
 @import Sentry;
 
 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
@@ -136,25 +130,19 @@ func application(_ application: UIApplication,
 
         // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
-        options.tracesSampleRate = @1.0;
+        options.tracesSampleRate = @1.f;
+        
+        options.configureProfiling = ^(SentryProfileOptions *profiling) {
+            profiling.lifecycle = SentryProfileLifecycleTrace;
+            profiling.sessionSampleRate = 1.f;
+        };
     }];
 
-    // Manually call startProfiler and stopProfiler to profile any code that runs in between.
-    [SentrySDK startProfiler];
-
-    //
-    // ...anything here will be profiled...
-    //
-
-    // Calls to stopProfiler are optional - if you don't stop the profiler, it will keep profiling
-    // your application until the process exits, the app goes to the background, or stopProfiling is called.
-    [SentrySDK stopProfiler];
-
     return YES;
 }
 ```
 
-```swift {tabTitle:SwiftUI with App conformer} {"onboardingOptions": {"performance": "13-16", "profiling": "18-28"}}
+```swift {tabTitle:SwiftUI with App conformer} {"onboardingOptions": {"performance": "13-16", "profiling": "17-21"}}
 import Sentry
 
 @main
@@ -168,29 +156,23 @@ struct SwiftUIApp: App {
             // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
             options.sendDefaultPii = true
 
-            // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
+            // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
-            options.tracesSampleRate = 1.0
+            options.tracesSampleRate = 1
+        
+            options.configureProfiling = {
+                $0.lifecycle = .trace
+                $0.sessionSampleRate = 1
+            }
         }
-
-        // Manually call startProfiler and stopProfiler to profile any code that runs in between.
-        SentrySDK.startProfiler()
-
-        //
-        // ...anything here will be profiled...
-        //
-
-        // Calls to stopProfiler are optional - if you don't stop the profiler, it will keep profiling
-        // your application until the process exits, the app goes to the background, or stopProfiling is called.
-        SentrySDK.stopProfiler()
     }
 }
 ```
 </PlatformSection>
 
 <PlatformSection notSupported={["apple.ios", "apple.macos"]}>
 
-```swift {tabTitle:Swift} {"onboardingOptions": {"performance": "13-16"}}
+```swift {tabTitle:Swift} {"onboardingOptions": {"performance": "13-16", "profiling": "17-21"}}
 import Sentry
 
 func application(_ application: UIApplication,
@@ -204,16 +186,21 @@ func application(_ application: UIApplication,
         // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
         options.sendDefaultPii = true
 
-        // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
+        // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
-        options.tracesSampleRate = 1.0
+        options.tracesSampleRate = 1
+        
+        options.configureProfiling = {
+            $0.lifecycle = .trace
+            $0.sessionSampleRate = 1
+        }
     }
 
     return true
 }
 ```
 
-```objc {tabTitle:Objective-C} {"onboardingOptions": {"performance": "12-15"}}
+```objc {tabTitle:Objective-C} {"onboardingOptions": {"performance": "12-15", "profiling": "16-20"}}
 @import Sentry;
 
 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
@@ -228,14 +215,19 @@ func application(_ application: UIApplication,
 
         // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
-        options.tracesSampleRate = @1.0;
+        options.tracesSampleRate = @1.f;
+        
+        options.configureProfiling = ^(SentryProfileOptions *profiling) {
+            profiling.lifecycle = SentryProfileLifecycleTrace;
+            profiling.sessionSampleRate = 1.f;
+        };
     }];
 
     return YES;
 }
 ```
 
-```swift {tabTitle:SwiftUI with App conformer} {"onboardingOptions": {"performance": "13-16"}}
+```swift {tabTitle:SwiftUI with App conformer} {"onboardingOptions": {"performance": "13-16", "profiling": "17-21"}}
 import Sentry
 
 @main
@@ -249,9 +241,14 @@ struct SwiftUIApp: App {
             // For more information, visit: https://docs.sentry.io/platforms/apple/data-management/data-collected/
             options.sendDefaultPii = true
 
-            // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
+            // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
-            options.tracesSampleRate = 1.0
+            options.tracesSampleRate = 1
+        
+            options.configureProfiling = {
+                $0.lifecycle = .trace
+                $0.sessionSampleRate = 1
+            }
         }
     }
 }