内容整理自官方文档
系列
- 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
项目配置是一种可扩展格式,主要由可选字段组成。最低配置 必须 包含以下字段:
代码语言:javascript复制{
"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"]
}
}