O Relay pode operar em diferentes modos. Compreender essas modalidades é fundamental ao configurar um servidor Relay, especialmente se você estiver saindo das configurações padrão. A configuração do modo é definida no arquivo de configuração através do campo relay.mode, que aceita os valores managed, static ou proxy. O modo selecionado determina como o Relay obtém as configurações de projeto para os eventos que recebe.

No Sentry, o processamento de eventos é governado por configurações no nível do projeto e da orgenização. Algumas configurações, como controles de privacidade, são definidas na organização e herdadas por todos os seus projetos. Cada projeto pode ter configurações adicionais específicas. O Relay processa os eventos com base nas configurações heraddas do projeto ao qual o evento é destinado.

Para manter suas configurações atualizadas, o Relay consulta periodicamente o Sentry. O Sentry não precisa ter visibilidade direta do seu Relay. Detalhes sobre intervalos de consulta, tempos limite e retentativas podem ser encontrados nas opções de configuração.

Modo Gerenciado (Managed Mode)

O modo managed é o padrão para o Relay. Como as configurações são obtidas do Sentry, a autenticação é um requisito neste modo. Se a autenticação falhar, o Relay rejeitará todos os eventos. Ao receber um evento de uma aplicação, o Relay solicita ao Sentry as configurações do projeto para processamento. Se o Sentry não puder fornecer as configurações para um projeto específico, todos os dados desse projeto serão descartados.

Para habilitar o modo managed, configure o seguinte:

relay:
  mode: managed

Modo Estático (Static Mode)

No modo static, os projetos devem ser configurados manualmente. O Relay processará apenas eventos de projetos explicitamente listados na configuração estática, rejeitando todos os outros. Este modo é útil quando você sabe exatamente quais projetos enviarão eventos e deseja controle granular sobre quais projetos são permitidos.

No modo static, o Relay não se registra com o Sentry, pois não consulta informações dele. Após processar os eventos dos projetos configurados, ele os encaminha para o Sentry junto com as informações de autenticação (DSN) definidas pelo cliente que originou a requisição.

Para ativar o modo static, use a seguinte configuração:

relay:
  mode: static

A configuração dos projetos é feita adicionando arquivos no formato projects/<PROJECT_ID>.json à pasta de configuração do Relay. Consulte a configuração de projetos para detalhes sobre o conteúdo desses arquivos.

Modo Proxy (Proxy Mode)

O modo proxy é semelhante ao modo static, mas com a capacidade de encaminhar eventos de projetos não conhecidos. Eventos de projetos configurados estaticamente são tratados como no modo static. Eventos de projetos sem configuração estática são encaminhados com o mínimo de processamento (atuando como um proxy).

As restrições de taxa (rate limiting) ainda se aplicam a todos os projetos no modo proxy, independentemente de serem configurados estaticamente ou encaminhados.

Para ativar o modo proxy, configure o seguinte:

relay:
  mode: proxy