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.
Visão geral
Configuração
Implante um serviço intermediário de webhook
Crie um serviço simples que receba payloads de incidentes do PagerDuty e chame a API do Devin para iniciar sessões de investigação.Crie um service user em Settings > Service Users com a permissão Implante isso em qualquer ambiente que possa receber requisições HTTPS — como um Cloudflare Worker, AWS Lambda ou um pequeno contêiner.
ManageOrgSessions. Armazene o token da API como DEVIN_API_KEY, o ID da sua organização como DEVIN_ORG_ID e um segredo compartilhado como WEBHOOK_SECRET no seu serviço intermediário. Você configurará esse mesmo segredo nos Custom Headers do webhook do PagerDuty na próxima etapa.Adicione uma integração de webhook no PagerDuty
- No PagerDuty, acesse Services > [your service] > Integrations
- Clique em Add Integration e selecione Generic Webhooks (v3)
- Defina a Webhook URL como o endpoint do seu serviço intermediário (por exemplo,
https://your-bridge.example.com/pagerduty-alert) - Em Custom Headers, adicione
X-Webhook-Secretcom o mesmo valor que você armazenou comoWEBHOOK_SECRETno seu serviço intermediário - Em Event Subscription, filtre pelo tipo de evento
incident.triggeredpara acionar apenas em novos incidentes
Verifique o fluxo
Gere um incidente de teste no PagerDuty (ou use um serviço de teste) e confirme que:
- Seu serviço intermediário recebe o payload do webhook
- Uma nova sessão do Devin é criada em app.devin.ai
- Devin começa a investigar o incidente
Boas práticas
- Comece com monitores no nível de aviso. Teste o pipeline com incidentes não críticos antes de encaminhar alertas P1 de produção para o Devin.
- Filtre por serviço ou severidade. Use as assinaturas de eventos de webhook do PagerDuty ou adicione lógica à sua bridge para ignorar serviços de baixa prioridade ou muito ruidosos. Isso evita que o Devin fique sobrecarregado com alertas de baixo valor.
- Use playbooks diferentes para cada severidade. Encaminhe alertas P1 para investigação imediata e hotfix. Encaminhe alertas P3 apenas para análise de causa raiz. Passe valores de
playbook_iddiferentes na solicitação à API do Devin com base na urgência. - Adicione tags às sessões para facilitar o rastreamento. O código de exemplo marca cada sessão com
pagerduty-triagee o nome do serviço, facilitando a filtragem e a revisão no dashboard do Devin.
Combinando com Datadog
- PagerDuty encaminha o alerta para o Devin (acionando a sessão de investigação)
- Devin usa o Datadog MCP para consultar logs, métricas e traces do serviço afetado
