使用

使用 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');