Skip to content

Commit 8306246

Browse files
feat(apple): Update Automatic Instrumentation (#3959)
Updated Screenshots and added HTTP instrumentation and slow and frozen frames. Co-authored-by: Fiona <[email protected]>
1 parent e66494c commit 8306246

File tree

4 files changed

+23
-1
lines changed

4 files changed

+23
-1
lines changed
Loading

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

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,29 @@ The SDK uses the process start time as the beginning of the app start and the [`
3737

3838
![App Start Transaction](app-start-transaction.png)
3939

40-
You can opt out of UIViewController and App Start Instrumentation using options:
40+
41+
## Slow and Frozen Frames
42+
43+
This feature is available for iOS, tvOS, and Mac Catalyst.
44+
45+
Unresponsive UI, animation hitches, or just jank annoy users and degrade the user experience. Two measurements to track this unwanted experience are slow frames and frozen frames. A smoothly running app should try to avoid both. That's why the SDK adds these two measurements for the transactions you capture.
46+
47+
- **Slow frames** are captured by the SDK when the app needs more than 16.67 ms for a frame. Typically, a phone or tablet renders with 60 frames per second (fps), though the frame rate can be higher, especially as 120 fps displays become popular. With 60 fps, every frame has 16.67 ms to render; slower than that, and the app has slow frames.
48+
- **Frozen frames** are UI frames that take longer than 700 ms.
49+
50+
The detail view of the transaction displays the slow, frozen, and total frames:
51+
52+
![Slow and Frozen Frames](slow-frozen-frames.png)
53+
54+
## HTTP Instrumentation
55+
56+
The SentrySDK adds spans for outgoing HTTP requests to ongoing transactions that are bound to the Scope.
57+
The SDK attaches auto-generated transactions automatically to the Scope if there is no other transaction bound.
58+
When starting a transaction, you can use bindToScope to indicate whether the SDK should bind the new transaction to the Scope or not.
59+
60+
## Opt Out
61+
62+
You can opt out of UIViewController, App Start, Slow and Frozen Frames, and HTTP Instrumentation using options:
4163

4264
```swift {tabTitle:Swift}
4365
import Sentry
Loading
Loading

0 commit comments

Comments
 (0)