Skip to main content

​
Integração com Sentry

A integração do Synkrony com Sentry conecta erros, issues e alerts diretamente ao fluxo de trabalho da sua equipe. Em vez de tratar incidentes de produção fora do planejamento, você transforma cada ocorrência relevante em uma tarefa rastreável dentro do workspace. Na prática, isso reduz o tempo entre detecção, priorização e execução da correção.

​
Quando usar essa integração

A integração com Sentry faz mais sentido quando sua equipe já usa o Sentry para monitorar backend, frontend ou jobs assíncronos e quer organizar a resposta dentro do Synkrony. Casos comuns:
  • Capturar bugs de produção como trabalho real: um erro crítico vira task automaticamente no projeto correto.
  • Evitar perder alertas importantes: o problema sai do feed de monitoramento e entra no kanban da equipe.
  • Dar contexto técnico para quem vai corrigir: stack trace, título do erro e link do Sentry acompanham a task.
  • Fechar o ciclo entre operação e entrega: quando a correção avança no Synkrony, a issue do Sentry também pode ser resolvida automaticamente.
  • Separar incidentes por cliente, produto ou squad: cada projeto do Sentry pode criar tarefas no projeto correspondente do Synkrony.

​
Como funciona

Depois de conectar sua conta do Sentry ao Synkrony, a integração passa a trabalhar em dois sentidos:

​
1. Sentry → Synkrony

Quando uma issue ou um alert relevante é disparado no Sentry, o Synkrony pode:
  • criar uma nova task automaticamente;
  • colocar essa task no projeto interno mapeado;
  • incluir contexto técnico básico, como título, resumo, link do erro e stack trace;
  • exibir o vínculo com o Sentry dentro da task.

​
2. Synkrony → Sentry

Quando a task avança até Done, o Synkrony pode:
  • marcar a issue correspondente como resolvida no Sentry.
Também é possível fazer o caminho inverso:
  • quando uma issue é resolvida no Sentry, a task vinculada pode ser movida automaticamente para Done.

​
O que a integração entrega no dia a dia

​
Tarefas criadas automaticamente

Se a automação estiver ativa, novas issues e alerts do Sentry podem gerar tasks sem intervenção manual. Isso é útil para:
  • bugs críticos de produção;
  • regressões detectadas logo após deploy;
  • alertas de erro recorrente em endpoints, workers ou integrações externas.

​
Contexto técnico dentro da task

As tasks criadas a partir do Sentry podem incluir:
  • título do erro;
  • resumo ou culprit;
  • link para abrir a issue/evento no Sentry;
  • stack trace quando disponível;
  • indicador visual de vínculo com Sentry no card da tarefa.

​
Sincronização de resolução

Você pode automatizar o fechamento em ambos os lados:
  • Resolver issue no Sentry ao mover task para Done
  • Mover task para Done quando a issue for resolvida no Sentry
Esse fluxo é especialmente útil para equipes que querem manter operação e planejamento alinhados sem atualização manual duplicada.

​
Fluxos comuns

​
Fluxo 1: Erro novo em produção vira tarefa

Exemplo:
  1. Um endpoint começa a falhar após um deploy.
  2. O Sentry cria uma issue ou dispara um alert.
  3. O Synkrony recebe esse evento e cria uma task no projeto certo.
  4. A equipe prioriza, corrige e acompanha o trabalho dentro da sprint.
Por que esse fluxo é útil:
  • evita que o bug fique só no monitoramento;
  • coloca o problema no backlog operacional do time;
  • garante rastreabilidade da correção.

​
Fluxo 2: Squad de sustentação separa incidentes por projeto

Exemplo:
  1. Seu workspace tem projetos por cliente ou produto.
  2. Cada projeto do Sentry é vinculado a um projeto interno do Synkrony.
  3. Quando chega um alert, a task já nasce no lugar certo.
Por que esse fluxo é útil:
  • reduz triagem manual;
  • evita criar tarefa no projeto errado;
  • facilita priorização por equipe responsável.

​
Fluxo 3: Task concluída resolve a issue no Sentry

Exemplo:
  1. A equipe corrige o problema e conclui a task.
  2. O Synkrony resolve a issue vinculada no Sentry automaticamente.
Por que esse fluxo é útil:
  • evita esquecer issue aberta depois da correção;
  • mantém métricas do Sentry mais limpas;
  • reduz retrabalho operacional.

​
Fluxo 4: Issue resolvida no Sentry encerra a task

Exemplo:
  1. A issue é resolvida diretamente no Sentry por um fluxo operacional.
  2. O webhook atualiza a task no Synkrony e move para Done.
Por que esse fluxo é útil:
  • bom para times que tratam incidentes primeiro no monitoramento;
  • mantém o kanban sincronizado com o estado real do incidente.

​
Configuração passo a passo

​
1. Acesse as integrações

No Synkrony, vá em: Configurações → Integrações → Sentry

​
2. Conecte sua conta do Sentry

Clique para conectar a integração e concluir a instalação do app do Sentry. Depois da conexão, o Synkrony passa a reconhecer:
  • a instalação do seu workspace no Sentry;
  • os projetos disponíveis;
  • os webhooks necessários para sincronização.

​
3. Vincule projetos do Sentry aos projetos do Synkrony

Esse é o passo mais importante para a automação funcionar corretamente. Você deve definir quais projetos externos do Sentry criam tarefas em quais projetos internos do Synkrony. Exemplo:
  • Projeto Sentry api-backend → Projeto Synkrony Backend
  • Projeto Sentry checkout-web → Projeto Synkrony Frontend Checkout
Sem esse mapeamento, o Synkrony pode receber o evento, mas não saber onde criar a task.

​
4. Ative as automações desejadas

Na tela da integração, você pode configurar:
  • Criar tarefas no workspace
  • Marcar task como Done quando a issue for resolvida
  • Resolver issue no Sentry ao mover tasks para Done
  • Adicionar task à sprint atual

​
5. Faça um teste controlado

Antes de depender do fluxo em produção, faça um teste com:
  • uma issue real do Sentry;
  • ou um alert de teste enviado a partir do Sentry.
Depois valide:
  • se a task foi criada no projeto esperado;
  • se o link com o Sentry apareceu na task;
  • se a descrição veio com contexto suficiente;
  • se as automações de resolução funcionam como esperado.

​
Como configurar o alert no Sentry

Para que o Synkrony receba eventos úteis, o caminho mais indicado é configurar um Issue Alert no projeto correto dentro do Sentry. Pela documentação oficial do Sentry, um issue alert dispara quando um novo evento é recebido e a regra atende às condições configuradas. Essas regras combinam:
  • triggers: quando o alert deve disparar;
  • filters: quais eventos devem ser considerados;
  • actions: o que o Sentry deve fazer quando a regra for atendida.
Fonte oficial:

​
Configuração recomendada

Se o objetivo é transformar erros relevantes em tasks no Synkrony, comece com uma regra simples e previsível:
  • selecione o projeto do Sentry que está vinculado ao projeto interno do Synkrony;
  • crie um Issue Alert;
  • use um trigger equivalente a novo erro / first seen;
  • adicione filtros para reduzir ruído, como ambiente production;
  • defina frequência para evitar notificações repetidas demais.

​
Exemplo de regra inicial

Uma configuração segura para começar:
  • Trigger: quando uma nova issue é criada;
  • Filtro: ambiente igual a production;
  • Filtro opcional: apenas eventos com nível error;
  • Frequência: uma vez a cada alguns minutos para a mesma issue.
Esse modelo é bom porque captura problemas novos sem transformar qualquer evento repetido em excesso de trabalho.

​
Quando usar alert mais agressivo

Se sua equipe usa o Synkrony como fila operacional de incidentes, você pode criar regras mais fortes, por exemplo:
  • issue reapareceu depois de resolvida;
  • issue aconteceu mais de X vezes em Y minutos;
  • issue afetou muitos usuários em pouco tempo.
Esse tipo de regra costuma ser melhor para:
  • regressões após deploy;
  • integrações externas instáveis;
  • endpoints críticos de checkout, login ou pagamento.

​
Boas práticas de configuração no Sentry

  • comece com poucos projetos e poucas regras;
  • priorize production antes de incluir staging;
  • evite regra ampla demais para não criar tasks em excesso;
  • revise alertas recorrentes que não geram ação real;
  • alinhe cada regra com um projeto já mapeado no Synkrony.

​
Como testar a configuração

Depois de criar a regra no Sentry:
  1. gere um erro real ou use o envio de teste do alert no próprio Sentry;
  2. confirme que o webhook chega ao Synkrony;
  3. valide se a task foi criada no projeto esperado;
  4. confira se o card da task mostra o vínculo com o Sentry.
Se o evento chegar e a task não for criada, normalmente o problema está em um destes pontos:
  • automação de criação de task desativada;
  • projeto do Sentry sem vínculo com projeto interno;
  • regra do alert configurada para um projeto diferente do mapeado.

​
Boas práticas

  • Mapeie projetos com cuidado: isso evita tasks em filas erradas.
  • Ative automação só onde faz sentido: nem todo alert merece virar task automaticamente.
  • Comece por um projeto piloto: valide o fluxo antes de expandir para toda a operação.
  • Use o Sentry para detecção e o Synkrony para execução: essa separação deixa o processo mais claro.
  • Revise regras de alert no Sentry: alertas muito amplos podem gerar ruído e excesso de tarefas.

​
Perguntas frequentes

A integração cria tasks a partir de issues ou de alerts? Os dois. Dependendo do tipo de evento recebido pelo app do Sentry, o Synkrony pode aproveitar tanto issues quanto alerts como origem da task. Preciso mapear projetos para funcionar? Sim. O Synkrony precisa saber em qual projeto interno cada evento do Sentry deve cair. A task criada mostra o link para o Sentry? Sim. O vínculo com o Sentry aparece na task para facilitar investigação e acompanhamento. Posso resolver a issue no Sentry quando concluir a task? Sim, desde que a automação correspondente esteja habilitada. Posso fazer o contrário e encerrar a task quando a issue for resolvida no Sentry? Sim. Esse comportamento também pode ser ativado na configuração da integração. Vale a pena para times pequenos? Sim, especialmente quando o mesmo time cuida de produto e sustentação. A integração reduz esquecimento e organiza melhor a fila de correções.

​
Troubleshooting

​
O evento chegou do Sentry, mas nenhuma task foi criada

Verifique estes pontos:
  • a integração está conectada e ativa;
  • a automação de criação de task está habilitada;
  • o projeto do Sentry está vinculado a um projeto do Synkrony;
  • o evento recebido pertence a um projeto mapeado;
  • a issue ou alert recebido contém identificação suficiente para vinculação.

​
A task foi criada, mas caiu no projeto errado

Revise o mapeamento entre projeto externo do Sentry e projeto interno do Synkrony.

​
A task foi concluída, mas a issue não foi resolvida no Sentry

Confirme se a opção de resolver issue ao mover task para Done está habilitada.

​
A issue foi resolvida no Sentry, mas a task não foi para Done

Confirme se a automação de mover task para Done quando a issue é resolvida está habilitada.

​
Resumo

A integração com Sentry é ideal para equipes que querem tratar incidentes como trabalho estruturado, e não como alerta solto em ferramenta de monitoramento. Você detecta no Sentry, prioriza no Synkrony e executa a correção no mesmo fluxo usado pelo restante do time.