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/
https://docs.sentry.io/product/relay/projects/
Proxy Mode(代理模式)
Proxy 模式类似于 static 模式,但它转发来自未知项目的事件。在这种模式下,静态配置项目的事件的处理方式与 static 模式相同。未知项目的事件 -- 没有静态配置设置的项目 -- 以最少的处理进行转发(代理)。
速率限制仍然适用于所有项目的 proxy 模式,无论它们是静态配置的还是代理的。
要激活 proxy 模式,请设置此配置:
- relay:
- mode: proxy