项目配置
在 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"] } }