Skip to main content
O Devin Oncall investiga, corrige e mitiga seus alertas, bugs e incidentes, além de oferecer percepções acionáveis sobre o seu plantão. O Devin entra em ação assim que um alerta, relatório de bug ou incidente é disparado e usa sua telemetria, seu código, suas implantações, seus runbooks e incidentes anteriores para encontrar a causa raiz, corrigir o problema e abrir um PR com a correção. O Oncall é composto por três produtos:
  • Responders: investigam e corrigem alertas, relatos de bug e dúvidas de suporte à medida que chegam.
  • Incidents: encontram a causa raiz, mitigam e conduzem cada incidente até a resolução.
  • Reports: trazem percepções acionáveis sobre o que está gerando seus alertas, bugs e incidentes, como limites de alerta que precisam de ajuste e classes recorrentes de problemas a corrigir.

Configuração

O Oncall exige uma configuração one-time por organização. Durante a configuração, o Devin aprende sobre seus sistemas com base nas suas ferramentas de telemetria e no seu código, e cria habilidades que todas as sessões do Oncall utilizam.
  1. Abra Oncall na barra lateral e clique em Begin setup.
  2. Conecte pelo menos uma ferramenta de telemetria. Você pode pular esta etapa se já houver uma ferramenta de telemetria disponível no Ambiente do Devin.
  3. Clique em Finish. O Devin começa a aprender sobre seus sistemas, o que geralmente leva de 1 a 2 horas. Você será notificado quando o Oncall estiver pronto.
Responders, Incidents e Reports ficam disponíveis assim que a configuração for concluída.
A configuração exige permissão para gerenciar o Oncall. Somente administradores da organização podem conectar ferramentas para toda a organização.

Configurações do Oncall

O ícone de engrenagem no cabeçalho do Oncall abre as configurações compartilhadas por todas as sessões do Oncall:
  • Instruções: orientações, escritas em markdown, que todas as sessões do Oncall seguem. Pense nelas como um AGENTS.md exclusivo do Oncall.
  • Habilidades: as habilidades sobre seus sistemas que o Devin gerou durante a configuração. Defina Skill update frequency como Weekly ou Monthly para mantê-las atualizadas ou clique em Update skills now.

Responders

Um responder monitora uma fonte de alertas ou relatos e aciona o Devin para investigar cada novo evento. O Devin agrupa eventos repetidos em um único problema, de modo que um alerta ruidoso seja investigado apenas uma vez. Use responders para:
  • Alertas de produção publicados pelas suas ferramentas de monitoramento em um canal do Slack ou do Microsoft Teams.
  • Incidentes do PagerDuty, nos quais o Devin publica sua investigação como notas do incidente.
  • Relatos de bugs e dúvidas de suporte em um canal como #eng-bugs.

Criar um responder

  1. Na página Oncall, clique em Create responder.
  2. Insira um Name e escolha o Responder type. O tipo não pode ser alterado depois da criação.
  3. Adicione um ou mais Triggers.
  4. Se quiser, ajuste as configurações da sessão, os conectores e o runbook.
  5. Clique em Create responder.
O runbook é opcional. O Devin Oncall já sabe investigar alertas e bugs, então adicione um apenas para etapas específicas da sua equipe.

Tipos de responder

Alertas e relatos de bug exigem tratamentos diferentes, por isso cada tipo de responder executa um fluxo próprio. O tipo também define como os problemas do responder são acompanhados no painel dele.

Gatilhos

Um responder monitora uma integração por vez e pode ter até 10 gatilhos. O Devin responde quando qualquer um deles for atendido. Adicione condições a um gatilho para restringir os eventos aos quais o Devin responde.

Configurações do responder

Incidentes

O Incidents foi desenvolvido para equipes que criam um novo canal do Slack para cada incidente. O Devin entra no canal, identifica a provável causa raiz, recomenda medidas de mitigação e continua investigando conforme o incidente evolui. Ele publica atualizações, responde a perguntas em threads e mantém um relatório do incidente.

Ativar incidentes

  1. Na página Oncall, abra a aba Incidents e clique em Enable incidents.
  2. Ative a opção Enable incidents.
  3. Defina o Slack channel prefix usado pelos seus canais de incidente, por exemplo, incident-.
  4. Escolha um Response mode e salve.
O Devin inicia uma investigação ao entrar em um canal do Slack cujo nome começa com o prefixo. Convide o Devin para o canal ou ative a opção Auto-join incident channels.
Para usar incidentes, o Slack precisa estar conectado à sua organização. Em uma empresa, apenas uma organização por vez pode ter os incidentes ativados.

Modos de resposta

Configurações de incidentes

A aba Incidentes lista cada incidente com um link para a respectiva sessão. Use Stop para encerrar a participação do Devin em um incidente e Resume para retomá-la.

Relatórios

Um relatório traz, de forma recorrente, percepções acionáveis sobre o seu plantão: limites de alerta que precisam de ajuste, classes de problemas recorrentes a corrigir e o que está gerando seus alertas, bugs e incidentes. Cada relatório também resume os problemas identificados e corrigidos, os incidentes investigados e os PRs que o Devin abriu e cujo merge ele fez. Use relatórios na transferência semanal de plantão ou defina o escopo de um relatório para a sua equipe, como Faturamento ou Infraestrutura.

Criar um relatório

  1. Na página Oncall, abra a aba Reports e clique em Create report.
  2. Insira um Name.
  3. Em Responders match, escolha quais responders o relatório abrange, selecionando responders individualmente ou por metadados.
  4. Em Incidents match, descreva quais incidentes devem entrar no relatório. Deixe em branco para não incluir incidentes.
  5. Defina o Schedule e, opcionalmente, adicione Instructions descrevendo o que o relatório deve conter.
  6. Em Notifications, escolha o canal do Slack ou do Microsoft Teams em que o relatório será publicado.
  7. Clique em Create report.
Como os relatórios são compartilhados, eles são executados como um usuário de serviço, e não em nome de uma pessoa específica. Abra um relatório para ver as execuções anteriores ou clique em Generate report para executá-lo agora.