Saltar para o conteúdo principal
Conecte sua organização do Sentry ao Orkestral e seus erros de produção deixam de viver em uma aba separada. Você vê issues ao vivo dentro do app, abre qualquer uma delas para inspecionar o stack trace e os breadcrumbs, e entrega tudo isso à sua equipe de agentes com um único clique. Com as automações ligadas, novos erros viram trabalho dos agentes por conta própria, sem nenhum clique. Esta página cobre as três partes da integração: conectar o Sentry, navegar e ler issues, e as regras de automação que transformam erros em trabalho enquanto você dorme.

Conectar

Vincule sua organização do Sentry uma vez a partir de Integrações.

Navegar e analisar

Leia issues com contexto completo e envie qualquer uma a um agente.

Automatizar

Regras que propõem ou iniciam trabalho automaticamente quando os erros correspondem.

​
Como funciona

O Orkestral conversa com a API do Sentry da sua organização. Uma vez conectado, ele puxa suas issues mais recentes (até 50 por vez) e as exibe na página Sentry na barra lateral. Cada issue mantém seus metadados reais: nível, projeto, contagem de ocorrências, usuários afetados, primeira e última ocorrência, e um permalink de volta ao Sentry. Quando você analisa uma issue, o Orkestral empacota o contexto do erro (título, culpado, exceção, stack trace, breadcrumbs, requisição, tags) e abre uma sessão de chat com sua equipe. O orquestrador CEO lê esse contexto, planeja e delega ao especialista certo. Modelos premium planejam; o FORGE local executa mudanças de código com custo de API de $0. As automações aplicam a mesma ideia sem que você precise observar. Uma regra corresponde aos erros recebidos por nível e projeto, e então propõe trabalho para sua revisão ou inicia a análise automaticamente.
A página do Sentry só renderiza dados depois que você conecta uma conta. Até lá você vê um aviso para conectar. Tudo abaixo pressupõe que um workspace esteja ativo.

​
Conectar o Sentry

1

Abra Integrações

Vá até Integrações na barra lateral. A página do Sentry leva direto até lá com um botão Conectar quando nenhuma conta está vinculada ainda.
2

Autorize sua organização

Siga o fluxo de conexão do Sentry e conceda ao Orkestral acesso à sua organização. Você conecta uma organização por workspace.
3

Confirme a conexão

Volte à página Sentry. O subtítulo agora mostra o slug da sua organização e o projeto (ou todos os projetos quando nenhum projeto único está selecionado). As issues começam a carregar automaticamente.
A conexão existe por workspace. Se você trocar de workspace, cada um tem sua própria conta do Sentry, issues, regras e histórico de execuções.
Uma vez conectado, a página Sentry lista suas issues recentes, da mais nova para a mais antiga. Cada linha mostra a barra e o badge de severidade, o projeto, o ID curto, o título, o culpado (o local do código que o Sentry responsabiliza), a contagem de ocorrências, os usuários afetados e há quanto tempo foi vista pela última vez.

​
Filtrar e buscar

Uma barra de filtros aparece assim que houver pelo menos uma issue.

Buscar

Correspondência por texto livre no título, no culpado e no ID curto.

Projeto

Restrinja a um único projeto do Sentry, ou mantenha todos os projetos.

Nível

Filtre por severidade: fatal, error, warning, info ou debug.
O contador à direita mostra quantas issues correspondem do total carregado. A filtragem acontece localmente sobre o conjunto carregado, então é instantânea.

​
Cores de severidade

Barra e badge vermelhos. As issues de maior atenção, crashes e exceções não tratadas.
Amarelo. Problemas recuperáveis que merecem uma olhada.
Azul. Eventos informativos que chegaram ao Sentry.
Cinza apagado. Eventos de diagnóstico de baixa prioridade.

​
Atualizar e atualização automática

Clique em Atualizar no cabeçalho para puxar as issues mais recentes sob demanda. Quando a atualização automática está ligada, o cabeçalho mostra um ponto verde com o intervalo (por exemplo auto ligado, a cada 5 min) e a lista se atualiza sozinha. Você define o intervalo na página de automações (veja abaixo). O padrão é a cada 5 minutos.
Abrir a página do Sentry limpa o badge de não lidas no item da barra lateral, então o badge reflete os erros que você ainda não olhou.

​
Ler uma issue em detalhe

Clique em qualquer linha para abrir a página de detalhe da issue. É aqui que você obtém o quadro completo antes de decidir o que fazer.
  • Mensagem: a mensagem de erro bruta, pré-formatada.
  • Exceção: o tipo e o valor da exceção, destacados em vermelho.
  • Stack trace: cada frame com arquivo e linha. Os frames in-app são destacados e trazidos para frente; os frames de biblioteca ficam esmaecidos e marcados como lib para você focar no seu próprio código.
  • Requisição: o método HTTP e a URL quando o erro veio de uma requisição.
  • Breadcrumbs: a linha do tempo de eventos que levaram ao erro, cada um com sua categoria, mensagem e horário.
No cabeçalho você pode:

Abrir no Sentry

Pule para o permalink da issue no Sentry no seu navegador.

Analisar

Entregue a issue à sua equipe de agentes e abra a sessão de chat resultante.

​
Analisar uma issue com sua equipe

Analisar é a ponte do erro ao trabalho. Você pode acioná-lo a partir da lista de issues (o botão em cada linha) ou do cabeçalho de detalhe da issue.
1

Clique em Analisar

O Orkestral coleta o contexto completo do erro e abre uma sessão de chat com sua equipe. Você cai nessa sessão automaticamente.
2

Deixe o CEO planejar e delegar

O orquestrador CEO lê o stack trace e os breadcrumbs, então encaminha o trabalho ao especialista certo (Backend, Frontend e assim por diante) e usa o FORGE para aplicar mudanças de código locais.
3

Reabra a análise a qualquer momento

Depois que uma issue foi analisada, seu botão muda para Ver análise (verde). Clique nele a partir da lista ou da página de detalhe para voltar exatamente àquela sessão, em vez de começar de novo.
Analisar inicia trabalho real em uma sessão de chat. Se você só quer ler o erro, use Abrir no Sentry ou apenas revise a página de detalhe.

​
Automatizar: transformar erros em trabalho

Abra Automações pelo botão no cabeçalho do Sentry. É aqui que você para de clicar em Analisar manualmente. As regras observam as issues recebidas e agem sobre as que correspondem.

​
O painel num relance

O topo da página mostra quatro estatísticas para você saber que o sistema está vivo:

Regras ativas

Quantas das suas regras estão habilitadas, do total.

Monitoradas

Quantas issues estão atualmente em vista para correspondência.

Execuções

Quantas vezes as automações dispararam.

Última execução

Quando a automação mais recente disparou, ou nunca.

​
Definir o intervalo de atualização automática

No canto superior direito, escolha com que frequência o Orkestral verifica o Sentry em busca de novas issues: desligado, ou a cada 1, 5, 15, 30 ou 60 minutos. Este é o mesmo intervalo mostrado na página do Sentry. Defina como desligado para pausar a verificação por completo (você ainda pode atualizar manualmente).

​
Criar uma regra

1

Clique em Nova regra

Use Nova regra no cabeçalho (ou o botão no estado vazio quando você ainda não tem regras).
2

Dê um nome

Dê à regra um nome claro, por exemplo Erros fatais no checkout. Um nome é obrigatório.
3

Defina o nível mínimo

Escolha a menor severidade que deve disparar a regra: fatal, error, warning ou info. A regra corresponde a esse nível e a qualquer coisa mais severa (exibido como error+ e assim por diante).
4

Restrinja a um projeto

Escolha um único projeto do Sentry, ou deixe em qualquer projeto para corresponder a todos eles.
5

Escolha o agente

Atribua o trabalho a um agente específico, ou deixe em CEO (padrão) para que o orquestrador decida quem cuida disso.
6

Escolha o modo

Escolha propor ou auto (explicado abaixo), depois Salvar.

​
Propor vs auto

O modo decide quanto a regra faz por conta própria.

Propor

A regra apresenta um erro correspondente como trabalho proposto para você revisar. Nada começa até você aprovar. Padrão mais seguro. Exibido com um badge azul.

Auto

A regra inicia a análise automaticamente, abrindo uma sessão sem cliques. O caminho mais rápido do erro à correção. Exibido com um badge roxo.
O modo auto dispara o trabalho dos agentes sem você no circuito. Comece restrito: restrinja a um projeto e a um nível mínimo alto (como fatal), confirme que as execuções parecem certas, e então amplie.

​
Gerenciar suas regras

Cada linha de regra mostra um interruptor, seu nome, o badge de modo e um resumo de uma linha como error+ · checkout-api · Backend.

Habilitar ou desabilitar

Acione o interruptor para ligar ou desligar uma regra sem excluí-la.

Editar

Reabra o editor para alterar qualquer campo.

Excluir

Remova a regra após um aviso de confirmação.

​
Revisar o histórico de execuções

A seção Execuções lista o que as automações fizeram, da mais nova para a mais antiga. Cada entrada informa o resultado num relance:
Ícone roxo. A regra iniciou uma análise. Clique na execução para pular direto para aquela sessão de chat.
Ícone verde. A regra apresentou a issue para sua revisão. Clique na execução para abrir a página de detalhe da issue.
Ícone vermelho. A execução falhou. Clique nela para abrir a issue relacionada e olhar mais de perto.
Cada execução também mostra qual regra disparou (como um pequeno badge), o título da issue ou o ID curto, e há quanto tempo foi executada.

​
O que fazer em seguida

Comece com uma regra

Crie uma única regra propor no nível error para o seu projeto mais movimentado, então acompanhe o histórico de execuções por um dia.

Ajuste o intervalo

Se os erros são raros, aumente o intervalo de atualização para economizar chamadas de API. Se são críticos em tempo, reduza para cada minuto.

Evolua para auto

Quando as execuções em propor parecerem confiáveis, troque a regra para auto para que as correções comecem sem você.

Leia antes de enviar

Abra as sessões analisadas e revise o plano e as mudanças do FORGE antes de fazer o merge.
O Sentry combina bem com o resto do Orkestral. Issues analisadas viram sessões de chat normais, então a mesma revisão e acompanhamento que você usa para trabalho planejado se aplicam também aos erros.