截图

了解在错误发生时如何截取屏幕截图。Sentry 将截图与原始事件配对,为您提供更多问题的洞察。

当用户遇到错误、异常或崩溃时,Sentry 可以自动截取屏幕截图并将其作为 附件 包含在内。

此功能仅适用于具有用户界面的 SDK,例如移动和桌面应用程序的 SDK。它还受限于是否可以截取屏幕截图。例如,在某些环境中(如原生 iOS),截取屏幕截图需要 UI 线程,而在崩溃时该线程通常不可用。另一个例子是,如果事件发生在屏幕加载之前,则可能无法获取截图。因此,此功能本质上是一个尽力而为的解决方案。

由于截图可能包含 个人身份信息 (PII),这是一个选择性启用的功能。你可以按照以下方法启用截图:

Copied
import * as Sentry from "@sentry/react-native";

Sentry.init({
  dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
  attachScreenshot: true,
});

attachScreenshot 启用并且捕获到错误事件时,截图会从原生 SDK 通过桥接传递到 React Native。这可能会对低端设备的性能产生负面影响,但 React Native 新架构将提高传输性能,因为数据不会被序列化。

如果有可用的截图,当你从 问题 页面点击特定问题时,你会看到截图的缩略图。

截图缩略图

一旦你点击了特定问题的事件 ID,你可以在“附件”选项卡中查看所有附件的概览以及相关事件。

截图列表示例