Docs/Ferramentas/PR Rollback

PR Rollback

O modo PR Rollback detecta automaticamente incidentes a partir de Revert PRs merged no branch de deploy, sem necessidade de configuração de prefixo de branch ou registro manual.

Onde Encontrar

Acesse Settings no DevStats. Em Reports Configuration, clique em Incidents. Com o Data Source definido como Git Provider, selecione PR Rollback no campo de modo de detecção.

Ao selecionar PR Rollback, a tabela de branch prefix por repositório é ocultada e substituída por uma mensagem informativa. A configuração é aplicada em todo o workspace, sem distinção por repositório.

PR Rollback vs PR Merge

PR Merge PR Rollback
O que conta como falha PRs com issue type Hotfix, Bug ou ambos (configurável por repositório) Revert PRs merged no branch de deploy
Escopo da configuração Branch prefix por repositório Todo o workspace, sem branch prefix
Filtro de issue type Aplicado (Hotfix, Bug ou ambos) Ignorado completamente

Change Failure Rate (CFR)

Com PR Rollback ativado:

  • Numerador: quantidade de Revert PRs deployed (merged no branch de deploy) no período
  • Denominador: total de deploys no período

CFR = (Revert PRs / Total Deploys) × 100

O filtro de issue type (Hotfix / Bug) é completamente ignorado neste modo.

Mean Time to Recovery (MTTR)

Para cada Revert PR deployed no período:

Descrição
Início do incidente pr_merged_at do PR original que foi revertido (quando o link ao PR original estiver disponível)
Início do incidente (fallback) pr_created_at do Revert PR (quando o PR original não puder ser identificado)
Resolução do incidente pr_merged_at do Revert PR

MTTR = média(resolved − start) sobre todos os Revert PRs no período

Detecção por Provider

GitHub

  • Detecção: título começa com Revert
  • Link ao PR original: extraído do nome do branch de origem. O botão nativo "Revert" do GitHub cria branches no padrão revert-<N>-<original-branch-name>, onde N é o número do PR original.
  • Confiabilidade: alta.

GitLab

  • Detecção: título começa com Revert
  • Link ao MR original: extraído da descrição do MR. O botão nativo "Revert" do GitLab sempre adiciona o texto This reverts merge request !N na descrição.
  • Confiabilidade: alta.

Azure Repos

  • Detecção: título começa com Revert
  • Link ao PR original: best-effort. O DevStats analisa o título no padrão Revert "<título do PR original>" e busca um PR com esse título exato no mesmo repositório.
  • Observação: o Azure Repos não possui botão nativo de "Revert PR". Se o PR original não puder ser encontrado, o MTTR usa o pr_created_at do Revert PR como fallback.

Bitbucket

  • Detecção: título começa com Revert
  • Link ao PR original: best-effort. O DevStats analisa a descrição do PR em busca de uma referência ao número do PR original.
  • Observação: o link não é garantido. Se o PR original não puder ser identificado, o MTTR usa o pr_created_at do Revert PR como fallback.