Sentry设置范围和中心

捕获事件并将其发送到Sentry时，SDK会将该事件数据与当前范围中的额外信息合并。 SDK通常会在框架集成中自动为您管理范围，您无需考虑它们。 但是，您应该知道范围是什么以及如何使用它来获得优势。

一、什么是范围，什么是中心

您可以将中心视为我们的SDK用于将事件路由到Sentry的中心点。当您调用init（）时，将创建一个中心，并在其上创建一个客户端和一个空白范围。然后该中心与当前线程相关联，并在内部保存一堆示波器。

范围将包含应与事件一起发送的有用信息。例如，上下文或面包屑存储在范围内。推送范围时，它会继承父范围内的所有数据，并在弹出时恢复所有修改。

默认的SDK集成将智能地推送和弹出范围。例如，Web框架集成将创建和销毁路由或控制器周围的范围。

二、范围和中心如何工作

当您开始使用SDK时，会自动为您创建范围和中心。除非您正在编写集成或者您想要创建或销毁范围，否则您不太可能直接与该中心进行交互。另一方面，范围更加面向用户。您可以在任何时间点调用configure-scope来修改存储在作用域上的数据。例如，这用于修改上下文。

当您在内部调用诸如capture_event之类的全局函数时，Sentry会发现当前中心并要求它捕获事件。然后，内部中心将事件与最高范围的数据合并。

三、配置范围

使用作用域时最有用的操作是configure-scope函数。它可用于重新配置当前范围。例如，这可以用于添加自定义标签或通知哨兵当前经过身份验证的用户。

Sentry.configureScope((scope) => {
  scope.setTag("my-tag", "my value");
  scope.setUser({
    id: 42,
    email: "john.doe@example.com"
  });
});

要了解与范围相关的有用信息，请参阅Sentry设置上下文的文章。

四、本地范围

我们还支持一次性推送和配置范围。这通常称为范围或推送范围，如果您只想发送一个特定事件的数据，这也非常有用。在以下示例中，我们使用该函数将级别和标记仅附加到一个特定错误：

Sentry.withScope(scope => {
  scope.setTag("my-tag", "my value");
  scope.setLevel('warning');
  Sentry.captureException(new Error('my error'));
});

虽然这个示例看起来与configure-scope类似，但它非常不同，在configure-scope实际更改当前活动作用域的意义上，对configure-scope的所有后续调用都将保留更改。

另一方面，使用with-scope会创建当前作用域的克隆，并且在函数调用完成之前将保持隔离状态。因此，您可以在那里设置您不希望在其他地方的上下文信息，或者通过在作用域上调用clear来创建不附加任何上下文信息，而“全局”作用域保持不变。