Logo

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#

  1. No PagerDuty: Integrations → API Access Keys → Create API User Token (leitura). Copie o token.
  2. Na plataforma: Integrações → PagerDuty → Conectar e cole o token. O backfill começa em segundo plano.
  3. 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#