使用
使用 SDK 手动捕获错误和其他事件。
Sentry 的 SDK 集成到您的运行时环境中,自动报告错误、未捕获的异常和未处理的拒绝,以及其他类型的错误,具体取决于平台。
关键术语:
- 事件 是向 Sentry 发送数据的一个实例。通常,这些数据是一个错误或异常。
- 问题 是一组类似的事件。
- 报告一个事件称为 捕获。 当一个事件被捕获时,它会被发送到 Sentry。
最常见的捕获形式是捕获错误。可以捕获为错误的内容因平台而异。一般来说,如果您有看起来像异常的东西,就可以捕获它。对于某些 SDK,您可以省略 capture_exception
的参数,Sentry 将尝试捕获当前异常。手动向 Sentry 报告错误或消息也非常有用。
在捕获事件时,您还可以记录导致该事件的面包屑。面包屑与事件不同:它们不会在 Sentry 中创建事件,而是会被缓冲,直到下一个事件被发送。了解更多关于面包屑的信息,请参阅我们的 面包屑文档。
在 PHP 中,您可以捕获已捕获的异常或使用 captureLastError
捕获最后一个错误。
Copied
try {
$this->functionFailsForSure();
} catch (\Throwable $exception) {
\Sentry\captureException($exception);
}
另一个常见的操作是捕获纯文本消息。消息是应发送到 Sentry 的文本信息。通常,我们的 SDK 不会自动捕获消息,但您可以手动捕获它们。
消息会在您的问题流中显示为问题,消息内容作为问题名称。
Copied
\Sentry\captureMessage('Something went wrong');