InboundFilters
允许您根据异常的类型、消息或 URL 忽略特定错误。(默认启用)
Import name: Sentry.inboundFiltersIntegration
此集成默认启用。如果您想修改默认集成,请阅读此文档。
此集成允许您根据异常的类型、消息或 URL 忽略特定错误。
默认情况下,它会忽略以 Script error
或 Javascript error: Script error
开头的错误。
要配置此集成,请直接使用 ignoreErrors
、ignoreTransactions
、denyUrls
和 allowUrls
SDK 选项。例如:
Sentry.init({
ignoreErrors: ["ignore-this-error"],
});
请记住,这些选项应传递给根 Sentry.init
调用,而不是集成!
Type: (string|RegExp)[]
一个字符串或正则表达式模式的列表,用于匹配不应发送到 Sentry 的错误消息。匹配这些字符串或正则表达式的消息在发送到 Sentry 之前将被过滤掉。使用字符串时,部分匹配也会被过滤掉,因此如果需要精确匹配,请使用正则表达式。默认情况下,所有错误都会发送。
Type: (string|RegExp)[]
一个字符串或正则表达式模式的列表,用于匹配不应发送到 Sentry 的事务名称。匹配这些字符串或正则表达式的事务在发送到 Sentry 之前将被过滤掉。使用字符串时,部分匹配也会被过滤掉,因此如果需要精确匹配,请使用正则表达式。默认情况下,典型的 API 健康检查请求所涉及的事务会被过滤掉。
Type: (string|RegExp)[]
一个字符串或正则表达式模式的数组,用于匹配创建错误的脚本的 URL。 只有在这些 URL 上创建的错误才会发送到 Sentry。 如果您使用此选项,只有当顶级堆栈帧文件 URL 包含或匹配 allowUrls
数组中的至少一个条目时,错误才会被发送到 Sentry。 数组中的所有字符串条目将通过 stackFrameUrl.contains(entry)
进行匹配,而所有正则表达式条目将通过 stackFrameUrl.match(entry)
进行匹配。
例如,如果您将 'foo.com'
添加到数组中,那么在 https://bar.com/myfile/foo.com
上创建的错误将被捕获,因为 URL 会通过“包含”逻辑进行匹配,并且 URL 的最后一段包含 foo.com
。
这种匹配逻辑适用于捕获的异常,而不适用于原始消息事件。默认情况下,所有错误都会发送。
如果您的脚本是从 cdn.example.com
加载的,而您的网站是 example.com
,您可以将 allowUrls
设置为以下内容,以仅捕获在这些位置的脚本中创建的错误:
Sentry.init({
allowUrls: [/https?:\/\/((cdn|www)\.)?example\.com/],
});
Type: (string|RegExp)[]
一个字符串或正则表达式模式的数组,用于匹配创建错误的脚本的 URL。 在这些 URL 上创建的错误不会发送到 Sentry。 如果您使用此选项,当顶级堆栈帧文件 URL 包含或匹配 denyUrls
数组中的至少一个条目时,错误将不会被发送到 Sentry。 数组中的所有字符串条目将通过 stackFrameUrl.contains(entry)
进行匹配,而所有正则表达式条目将通过 stackFrameUrl.match(entry)
进行匹配。
这种匹配逻辑适用于捕获的异常,而不适用于原始消息事件。默认情况下,所有错误都会发送。