内容整理自官方文档
系列
- Sentry 企业级数据安全解决方案 - Relay 入门
- Sentry 企业级数据安全解决方案 - Relay 运行模式
- Sentry 企业级数据安全解决方案 - Relay 配置选项
- Sentry 企业级数据安全解决方案 - Relay 监控 & 指标收集
项目配置
在 static
或 proxy
模式下运行 Relay
时,您可以在文件系统上配置项目设置。Static
项目配置位于 Relay
配置目录的 projects
子目录下,默认位于 .relay/projects
。
托管(managed)
模式下的Relay
仅适用于商业和企业计划。https://sentry.io/pricing/
要配置项目,请在该位置添加名为 <PROJECT_ID>.json
的文件:
.relay/
└── projects/
├── 17.json
├── 21.json
└── 42.json
项目配置是一种可扩展格式,主要由可选字段组成。最低配置 必须 包含以下字段:
{
"slug": "my-project",
"publicKeys": [
{
"publicKey": "<DSN_KEY>",
"isEnabled": true
}
],
"config": {
"allowedDomains": ["*"]
}
}
公钥 (
<DSN_KEY>
) 是项目DSN
的密钥,与用于Relay
注册的Relay
公钥无关。
基本选项
slug
项目的简称,显示在
Sentry
中。Relay
当前需要此值才能接受事件。{ "slug": "my-project" }
disabled
项目是否被禁用。如果设置为
true
,则Relay
将丢弃发送到此项目的所有事件。{ "disabled": false }
publicKeys
已知公钥(
DSN
中的公钥)的列表以及是否应接受使用该密钥的事件。{ "publicKeys": [ { "publicKey": "12345abcdb1e4c123490ecec89c1f199", "isEnabled": true } ] }
您可以通过进入
Sentry > Project Settings > Client Keys (DSN)
来获取密钥。公钥可以从DSN
中提取。 在这个DSN
中,例如https://12345abcdb1e4c123490ecec89c1f199@o1.ingest.sentry.io/2244
,key
是12345abcdb1e4c123490ecec89c1f199
。
一个项目可能包含多个公钥,但只会处理使用已启用项目密钥的消息。同样,可以使用isEnabled
flag
禁用key
。
config.allowedDomains
配置
Sentry
应接受事件的Origin
或Referer
URL。这对应于Sentry UI
中的Allowed Domains
设置。
空列表拒绝所有来源。使用默认的["*"]
以允许所有来源。{ "config": { "allowedDomains": ["mycompany.com"] } }