上传文件
了解如何将调试信息文件上传到 Sentry。
向 Sentry 提供调试信息文件最直接的方法是使用 sentry-cli
进行上传。根据你的工作流程,你可能希望在构建管道中或在部署和发布应用程序时进行上传:
有关所有可用选项和更多信息,请参阅 上传调试信息。
应在部署或发布应用程序之前上传调试文件,以便处理崩溃报告。对于手动测试,在发送第一个原生崩溃或错误事件之前,使用 sentry-cli debug-files upload --wait
。
如果你上传了一个之前在崩溃报告中被 Sentry 报告为缺失的文件,Sentry 可能需要最多一小时才能开始在新的崩溃报告中使用该文件。现有的事件和问题不会再次处理。
在 Sentry 中,你上传的文件与项目关联。你可以在 项目设置 > 调试文件 中查看和管理上传的文件。该页面显示调试文件的重要属性:
- 调试标识符。如果调试信息分布在多个文件中,可能会有多个条目共享相同的标识符。
- 调试文件的名称。Sentry 在使用
sentry-cli
上传文件时使用文件系统上的名称。 - 文件的架构和类型。这可以用于区分可执行文件和调试伴随文件,如果它们的调试标识符和名称匹配。
- 这些文件中包含的调试信息。这可能包括
unwind
、debug
、symtab
和sources
。 - 元数据,如文件大小和上传时间。
如果多个项目需要相同的文件,则需要重新上传。Sentry 不会访问其他项目中存储的调试文件来符号化崩溃报告。