Conectar o PagerDuty
O PagerDuty torna duas métricas DORA confiáveis: MTTR (tempo de recuperação) e Change Failure Rate (CFR). Sem ele, a plataforma estima essas duas a partir do status dos deploys, um proxy fraco (por isso há um aviso na tela de Deploys). Com o PagerDuty, elas passam a vir de incidentes reais, e você ganha uma aba Confiabilidade (feed, MTTR/MTTA, incidentes por serviço, tendência).
O PagerDuty não adiciona repositórios: ele enriquece os repos do seu SCM. Cada serviço do PagerDuty é ligado a um repositório por você (mapeamento serviço → repo).
Como funciona#
A plataforma puxa os incidentes da API do PagerDuty (backfill no momento da conexão + atualização periódica). Não precisamos de webhook nem de acesso ao seu ambiente, só de um token de leitura.
Pré-requisitos#
- Ser Owner ou Admin da organização na plataforma.
- Um REST API token (somente leitura) do PagerDuty.
- Pelo menos um repositório conectado (o PagerDuty mapeia serviços a esses repos).
Passo a passo#
- No PagerDuty: Integrations → API Access Keys → Create API User Token (leitura). Copie o token.
- Na plataforma: Integrações → PagerDuty → Conectar e cole o token. O backfill começa em segundo plano.
- Em Gerenciar PagerDuty, ligue cada serviço a um repositório. Serviços sem repositório contam só no MTTR geral da organização (sem quebra por repo nem correlação de CFR).
O que muda#
- Deploys → DORA: MTTR = média de (resolvido − criado) dos incidentes; CFR = % de deploys de produção que dispararam um incidente nas 24h seguintes. O aviso de "sem falhas registradas" some e aparece o selo "fonte: PagerDuty". Frequência de deploy e lead time não mudam.
- Deploys → aba Confiabilidade: MTTR/MTTA, incidentes por serviço, tendência e o feed (com link pro PagerDuty).
Perguntas frequentes#
Precisa configurar webhook? Não. Puxamos por API (poll). Webhook em tempo real pode vir no futuro; o poll já é suficiente para MTTR/CFR.
Meus incidentes não afetam o CFR por repositório. Confirme que o serviço do incidente está mapeado a um repositório em Gerenciar PagerDuty. Sem mapeamento, o incidente entra só no MTTR geral.
Como o token fica seguro? É somente leitura e criptografado (AES-256) no banco. Se vazar, revogue no PagerDuty e reconecte.
Próximos passos#
- Dashboards e telas: a aba Deploys (DORA + Confiabilidade).
- Visão geral das integrações.