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

内容整理自官方开发文档

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

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


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


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

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


系列


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

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