內容整理自官方開發文件
Relay
可以在幾種主要模式之一下執行,如果您正在配置 Relay server
而不是使用預設設定,那麼事先了解這些模式至關重要。
模式儲存在配置檔案中,該檔案包含 relay.mode
欄位。此欄位指定 Relay
執行的模式:managed
、static
或 proxy
。Relay
模式控制 Relay
獲取事件的專案設定的方式。
managed
模式下的 Relay 僅適用於商業和企業計劃。
在 Sentry
中,事件處理根據專案和組織設定進行配置。 一些設定,例如隱私控制,是在組織級別設定的,然後由該組織中的所有專案繼承;每個專案都指定了其他設定。對於 Relay,根據事件傳送到的繼承專案設定處理事件。
通過輪詢 Sentry
定期重新整理 Relay
配置。Sentry
不需要看到你的 Relay
。關於間隔(intervals)
、超時(timeouts)
和重試(retries)
的配置,請參見配置選項。
系列
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
模式,請設定此配置:
relay:
mode: proxy