Sentry 企业级数据安全解决方案 - Relay 运行模式

内容整理自官方开发文档

Relay 可以在几种主要模式之一下运行，如果您正在配置 Relay server 而不是使用默认设置，那么事先了解这些模式至关重要。

模式存储在配置文件中，该文件包含 relay.mode 字段。此字段指定 Relay 运行的模式：managed、static 或 proxy。Relay 模式控制 Relay 获取事件的项目设置的方式。

managed 模式下的 Relay 仅适用于商业和企业计划。

• https://sentry.io/pricing/

在 Sentry 中，事件处理根据项目和组织设置进行配置。一些设置，例如隐私控制，是在组织级别设置的，然后由该组织中的所有项目继承；每个项目都指定了其他设置。对于 Relay，根据事件发送到的继承项目设置处理事件。

通过轮询 Sentry 定期刷新 Relay 配置。Sentry 不需要看到你的 Relay。关于间隔(intervals)、超时(timeouts)和重试(retries)的配置，请参见配置选项。

• https://docs.sentry.io/product/relay/options/

系列

Sentry 企业级数据安全解决方案 - Relay 入门

Sentry 开发者贡献指南 - SDK 开发(性能监控：Sentry SDK API 演进)

Managed Mode(托管模式)

Managed 是 Relay 的默认模式。由于设置是从 Sentry 获取的，因此在此模式下需要进行身份验证。如果认证失败，Relay 将不接受任何事件。

当 Relay 从您的应用程序接收事件时，它将请求 Sentry 的项目设置来处理事件。如果 Sentry 无法为特定项目提供设置，则该项目的所有数据都将被丢弃。

要激活 managed mode，请设置以下配置：

relay:
  mode: managed

Static Mode(静态模式)

在 static mode 下，必须手动配置项目。在这种模式下，Relay 将仅处理静态配置项目的事件，并拒绝所有其他项目的事件。

当您知道发送事件的项目，并且需要明确地控制允许通过这个 Relay 发送事件的项目时，此模式非常有用。

在 static 模式下，Relay 不向上游注册，因为它不向上游查询信息。处理完已配置项目的事件后，它会将它们与发送原始请求的客户端设置的身份验证信息 (DSN) 一起转发到上游。

要激活 static 模式，请设置以下配置：

relay:
  mode: static

要配置项目，请使用 projects/<PROJECT_ID>.json 格式将文件添加到 Relay 配置文件夹。有关此文件内容的说明， 参考项目配置。

• https://docs.sentry.io/product/relay/projects/

Proxy Mode(代理模式)

Proxy 模式类似于 static 模式，但它转发来自未知项目的事件。在这种模式下，静态配置项目的事件的处理方式与 static 模式相同。未知项目的事件 -- 没有静态配置设置的项目 -- 以最少的处理进行转发（代理）。

速率限制仍然适用于所有项目的 proxy 模式，无论它们是静态配置的还是代理的。

要激活 proxy 模式，请设置此配置：

relay:
  mode: proxy