Sentry 企业级数据安全解决方案 - Relay 项目配置

内容整理自官方文档

系列

• 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"]
 }
}