Relay
可以在几种主要模式之一下运行,如果您正在配置 Relay server
而不是使用默认设置,那么事先了解这些模式至关重要。
模式存储在配置文件中,该文件包含 relay.mode
字段。此字段指定 Relay
运行的模式:managed
、static
或 proxy
。Relay
模式控制 Relay
获取事件的项目设置的方式。
managed
模式下的 Relay 仅适用于商业和企业计划。
在 Sentry
中,事件处理根据项目和组织设置进行配置。一些设置,例如隐私控制,是在组织级别设置的,然后由该组织中的所有项目继承;每个项目都指定了其他设置。对于 Relay,根据事件发送到的继承项目设置处理事件。
通过轮询 Sentry
定期刷新 Relay
配置。Sentry
不需要看到你的 Relay
。关于间隔(intervals)
、超时(timeouts)
和重试(retries)
的配置,请参见配置选项。
系列
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 配置文件夹。有关此文件内容的说明, 参考项目配置。
Proxy Mode(代理模式)
Proxy
模式类似于 static
模式,但它转发来自未知项目的事件。在这种模式下,静态配置项目的事件的处理方式与 static
模式相同。未知项目的事件 -- 没有静态配置设置的项目 -- 以最少的处理进行转发(代理)。
速率限制仍然适用于所有项目的
proxy
模式,无论它们是静态配置的还是代理的。
要激活 proxy
模式,请设置此配置: