Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
Implantar uma ponte para webhooks
Crie um pequeno serviço que monitore eventos Crie um usuário de serviço em Configurações > Service Users no app.devin.ai com a permissão
incident.resolved do PagerDuty e inicie uma sessão do Devin para redigir o postmortem. Implante isso como uma função serverless (AWS Lambda, Cloudflare Worker) ou um contêiner leve:ManageOrgSessions. Copie o token da API exibido após a criação e armazene-o como DEVIN_API_KEY no seu serviço de bridge. Defina DEVIN_ORG_ID como o ID da sua organização — obtenha-o fazendo uma chamada a GET https://api.devin.ai/v3/enterprise/organizations com seu token. Defina WEBHOOK_SECRET como um segredo compartilhado que você também configurará no PagerDuty.Configurar PagerDuty
- No PagerDuty, vá para Services > [seu serviço] > Integrations
- Clique em Add Integration e selecione Generic Webhooks (v3)
- Defina a Webhook URL como o endpoint da sua bridge (por exemplo,
https://your-bridge.example.com/pagerduty-resolved) - Em Custom Headers, adicione
X-Webhook-Secretcom o mesmo valor que você armazenou comoWEBHOOK_SECRET - Em Event Subscription, filtre pelo tipo de evento
incident.resolvedpara que o postmortem seja acionado somente após o incidente ser encerrado
Você também pode se inscrever em
incident.acknowledged se quiser que o Devin comece a coletar dados enquanto o incidente ainda estiver em andamento e depois finalize o postmortem quando ele for resolvido.Conecte MCPs de observabilidade (opcional)
Devin escreve post-mortems melhores quando pode acessar seus dados de telemetria. Ative um ou mais MCPs para que o Devin possa buscar dados reais do período do incidente:Datadog MCP — Vá para Configurações > MCP Marketplace, encontre Datadog, clique em Ativar e insira suas chaves de API e de aplicativo. Devin consultará logs, métricas, eventos de deploy e histórico dos monitores.Sentry MCP — Encontre Sentry no MCP Marketplace, clique em Ativar e conclua o fluxo de OAuth. Devin buscará detalhes de erros, stack traces e tags de release.Depois de conectado, Devin correlaciona automaticamente a telemetria com a linha do tempo do incidente para elaborar um post-mortem baseado em evidências. Saiba mais sobre como conectar servidores MCP.
O que Devin gera
Quando um incidente no PagerDuty é resolvido, Devin analisa o período do incidente e elabora um postmortem estruturado:Exemplo de postmortem produzido pelo Devin:
Personalize o post-mortem
Adapte o pipeline para se alinhar ao processo de postmortem da sua equipe:Use um Playbook para definir seu modelo de postmortem — seções, classificação de severidade, campos obrigatórios e onde armazenar o resultado. Passe um
playbook_id na solicitação da API para padronizar cada postmortem.Encaminhe por severidade. Adicione lógica à sua integração para gerar postmortems apenas para incidentes P1/P2. Incidentes de menor severidade podem não precisar de um relatório completo.Adicione Knowledge sobre sua arquitetura, os responsáveis pelos serviços e incidentes anteriores para que Devin consiga ligar os pontos — por exemplo, “orders-service depende de inventory-service, que é conhecido por problemas de timeout sob carga.”Publique no seu wiki. Em vez de fazer commit em um repo, faça com que Devin publique o postmortem no Confluence, Notion ou no wiki interno da sua empresa por meio do prompt da sessão.