使用

使用 SDK 手动捕获错误和其他事件。

Sentry 的 SDK 钩入您的运行时环境,并自动报告错误、未捕获的异常、未处理的拒绝以及其他类型的错误,具体取决于平台。

关键术语:

  • 事件 是一次向 Sentry 发送数据的操作。通常,这些数据是错误或异常。
  • 问题 是类似事件的分组。
  • 事件的报告称为 捕获。 当事件被捕获时,它将发送到 Sentry。

最常见的捕获形式是捕获错误。可以捕获为错误的内容因平台而异。通常,如果您有类似异常的内容,可以捕获它。对于某些 SDK,您可以省略 capture_exception 的参数,Sentry 将尝试捕获当前异常。这对于手动报告错误或消息到 Sentry 也很有用。

在捕获事件时,您还可以记录导致该事件的面包屑。面包屑与事件不同:它们不会在 Sentry 中创建事件,而是会缓冲直到下一个事件发送。有关面包屑的更多信息,请参阅我们的面包屑文档

在 Python 中,您可以捕获一个已捕获的异常或当前存储在 sys.exc_info() 中的异常,而不传递参数:

Copied
from sentry_sdk import capture_exception

try:
    a_potentially_failing_function()
except Exception as e:
    # Alternatively the argument can be omitted
    capture_exception(e)

另一个常见的操作是捕获纯消息。消息是应发送到 Sentry 的文本信息。通常,我们的 SDK 不会自动捕获消息,但您可以手动捕获它们。

消息会显示在您的问题流中,消息本身作为问题名称。

Copied
from sentry_sdk import capture_message

capture_message('Something went wrong')