sampleRate配置错误事件的采样率,范围为0.0到1.0。默认值为1.0,表示发送了100%的错误事件。如果设置为0.1,则仅发送10%的错误事件。事件是随机选择的。maxBreadcrumbs这个变量控制应该捕获的面包屑总数。默认值为100。attachStack
配置错误事件的采样率,范围为 0.0
到 1.0
。默认值为 1.0
,表示发送了 100%
的错误事件。如果设置为 0.1
,则仅发送 10%
的错误事件。事件是随机选择的。
这个变量控制应该捕获的面包屑总数。默认值为 100
。
当启用时,堆栈跟踪将自动附加到所有记录的消息。堆栈跟踪总是附加到异常;然而,当设置此选项时,堆栈跟踪也会与消息一起发送。例如,该选项意味着堆栈跟踪显示在所有日志消息的旁边。
该选项默认为 off
。
Sentry
中的分组对于有和没有堆栈跟踪的事件是不同的。因此,当您为某些事件启用或禁用此 flag
时,您将获得新组。
与不应该发送到 Sentry
的错误 URL
相匹配的字符串或正则表达式模式列表。默认情况下,将发送所有错误。这是一个 “contains(包含)” 匹配整个文件 URL。因此,如果你添加 foo.com
,它也会匹配 https://bar.com/myfile/foo.com
。默认情况下,将发送所有错误。
匹配错误 URL
的字符串列表或正则表达式模式的遗留别名,这些错误 URL
应该专门发送给 Sentry
。默认情况下,将发送所有错误。这是一个 “contains(包含)” 匹配整个文件 URL。因此,如果您将 foo.com
添加到它,它也将匹配 https://bar.com/myfile/foo.com
。默认情况下,所有错误将被发送。
设置为 true
时,SDK
将向 Sentry
发送 session
事件。这在所有浏览器 SDK
中都受支持,每个页面加载和页面导航都向 Sentry
发出一个 session
。在移动 SDK
中,当应用进入后台超过 30
秒时,会话结束。
要设置为初始作用域的数据。初始作用域可以定义为对象或回调函数,如下所示。
对象:
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
debug: true,
initialScope: {
tags: {"my-tag": "my value"},
user: {id: 42, email: "john.doe@example.com"},
}
});
回调函数:
Sentry.init({
dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",
debug: true,
initialScope: scope => {
scope.setTags({ a: 'b' });
return scope;
},
});
单个值在被截断之前可以具有的最大字符数(默认为 250
)。
Sentry SDK
将任何上下文数据标准化到给定的深度。任何包含结构比这更深的数据的 key
都将使用其类型([Object]
或 [Array]
)进行修剪和标记,而不会进一步遍历树。默认情况下,步行执行 3
级深度。
对于许多平台,SDK 集成可以与之一起配置。在一些平台上,这是 init()
调用的一部分,而在另一些平台上,则应用不同的模式。
在某些 SDK 中,在库初始化时通过此参数配置集成。
更多:
这可以用来禁用默认添加的集成。当设置为 false
时,不会添加默认的集成。
这些选项可用于以各种方式 hook SDK
,以定制事件的报告。
使用 SDK-specific
事件对象调用此函数,可以返回修改后的事件对象或不返回任何内容,以跳过报告事件。例如,这可以用于在发送前手动剥离 PII
。
在将面包屑添加到作用域之前,使用 SDK
特定的面包屑(SDK-specific breadcrumb
)对象调用此函数。当该函数未返回任何内容时,将删除 breadcrumb
。要传递 breadcrumb
,请返回第一个参数,其中包含 breadcrumb
对象。回调通常会获得第二个参数(称为“hint”
),该参数包含创建 breadcrumb
的原始对象,以进一步自定义面包屑的外观。
Transports
被用来发送事件到 Sentry
。可以在某种程度上对传输进行定制,以更好地支持高度特定的部署。
切换出用于发送事件的 transport
。如何运作取决于 SDK
。例如,它可以用于捕获事件以进行单元测试,或通过需要代理身份验证的更复杂的设置发送事件。
0
到 1
之间的数字,控制给定事务发送到 Sentry
的概率百分比。(0
表示 0%
,1
表示 100%
)同样适用于应用程序中创建的所有事务。必须定义这个或 tracesSampler
以启用跟踪。
一个函数负责确定一个给定的事务将被发送到 Sentry
的概率百分比。它将自动被传递有关事务和创建它的上下文的信息,并且必须返回一个介于 0
(被发送的概率为 0%
)和 1
(被发送的概率为 100%
) 之间的数字。还可以用于过滤事务,对不需要的事务返回 0
。必须定义这个或 tracesSampleRate
来启用跟踪。
Sentry
的所有 SDK
都提供集成,可扩展 SDK
的功能。
默认情况下启用系统集成以集成到标准库或解释器本身。它们被记录在案,因此您既可以了解它们的作用,也可以在它们引起问题时禁用它们。
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!