Conectar Sentry ou GlitchTip

Sentry e GlitchTip usam o mesmo protocolo do SDK do Sentry. A configuração do lado do Elido é a mesma para ambos — a única diferença é o DSN que você cola.

Este guia cobre duas direções: canalizar alertas do Elido para o seu rastreador de erros (para que problemas de abuso, TLS ou API apareçam como issues para triagem), e usar o Elido junto com sua configuração existente do Sentry se você já hospeda o GlitchTip.

Por que conectá-los

O Elido emite eventos operacionais que são úteis como issues do Sentry:

• abuse.flagged — nosso scanner marcou uma URL de destino como malware/phishing.
• domain.tls_renewed (variante de falha) — o Caddy não conseguiu renovar um certificado TLS.
• webhook.delivery_failed — seu próprio endpoint de webhook parou de responder.
• link.clicked.aggregated (variante de anomalia) — pico repentino de tráfego 10× em um único link.

Provavelmente você não vai querer todos como issues — escolha os que precisam de resposta humana.

Adicionar a integração

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Cole seu DSN do Sentry. DSNs do GlitchTip usam o mesmo formato e funcionam no mesmo campo.
3. Escolha os tipos de evento para encaminhar. O padrão é apenas abuse.flagged e falhas de renovação TLS.
4. Clique em Send test event. Você deve ver um "issue de teste" no seu projeto Sentry em 10 segundos.
5. Save.

A integração roda no lado do servidor. Não carregamos o SDK do navegador Sentry no seu dashboard — seu DSN nunca chega ao navegador do visitante.

Como o issue aparece

Cada evento encaminhado se torna um issue formatado no estilo Sentry com:

• event_id = ID do evento Elido (para deduplicação).
• level = error para abuso e falhas TLS, warning para falhas de entrega de webhook, info para anomalias de pico.
• fingerprint = ID do workspace + tipo de evento + ID do recurso relevante, para que reenvios do mesmo issue sejam agrupados corretamente no Sentry.
• extra = payload completo do evento Elido.
• tags = workspace, event_kind, mais a tag específica do recurso (link_slug, domain, etc.).

Notas sobre GlitchTip

O GlitchTip implementa a API de ingestão de eventos do Sentry, mas não o conjunto completo de recursos do Sentry. A integração apenas envia eventos pelo endpoint de ingestão, então qualquer recurso nesse escopo (agrupamento de issues, fingerprints, pesquisa, alertas) também funciona no GlitchTip. Traces de desempenho, replays e profiling não funcionam, mas o Elido não envia esses dados de qualquer forma.

Desabilitar

Clique em Disconnect na página de integração. O DSN é apagado e nenhum evento adicional é enviado. Seus issues existentes no Sentry não são excluídos — eles permanecem no seu projeto Sentry.

Limites

• 1 destino Sentry por workspace. Se precisar distribuir para vários projetos Sentry, use webhooks e um pequeno proxy.
• Respeitamos o limite de taxa padrão de 50/s por projeto do Sentry. Anomalias de pico são amostradas antes do envio para ficar abaixo do limite.

Solução de problemas

O evento de teste chega mas os eventos reais não. Verifique se selecionou os tipos de evento corretos nas configurações de integração. A seleção padrão é conservadora.

Os eventos chegam mas tags estão vazias. O Sentry às vezes trunca valores de tags com mais de 200 caracteres (slugs, domínios) — eles aparecem como unknown. Esse é um limite do Sentry, não nosso.

O endpoint de ingestão do GlitchTip rejeita com 429. Sua instância do GlitchTip está fazendo rate limiting. Aumente o limite por projeto no admin do GlitchTip, ou filtre os tipos de evento que você precisa.

O DSN foi rotacionado e agora recebemos 401. Atualize o DSN na página de integração. Não há detecção automática para rotação de DSN.