Pular para o conteúdo principal
POST
/
api
/
v1
/
postmortems
/
{name}
/
feedback
Feedback do Desenvolvedor
curl --request POST \
  --url https://api.example.com/api/v1/postmortems/{name}/feedback \
  --header 'Content-Type: application/json' \
  --data '
{
  "providedBy": "<string>",
  "remediationAccuracy": 123,
  "overrideRootCause": "<string>",
  "comments": "<string>"
}
'
{
  "apiVersion": "v1",
  "kind": "PostMortem",
  "resourceMeta": {
    "name": "PM-20260319-001",
    "namespace": "production"
  },
  "status": {
    "state": "InReview",
    "feedback": {
      "overrideRootCause": "Leak causado por goroutine não cancelada no webhook handler, não pelo response body",
      "remediationAccuracy": 4,
      "comments": "Boa analise. Sugerir AdjustResources antes de restart na proxima vez.",
      "providedBy": "sre@empresa.com",
      "providedAt": "2026-03-19T09:00:00Z"
    }
  }
}
name
string
obrigatório
Nome único do postmortem (ex.: PM-20260319-001)
namespace
string
padrão:"default"
Namespace Kubernetes
providedBy
string
obrigatório
Identificador de quem está fornecendo o feedback (ex.: email ou nome de usuario). Máximo 253 caracteres.
remediationAccuracy
integer
obrigatório
Nota de 1 a 5 para a precisao da remediação automática da IA
  • 1 — Completamente errada, não resolveu nada
  • 2 — Parcialmente correta, mas com problemas significativos
  • 3 — Razoavel, resolveu mas com ajustes manuais
  • 4 — Boa, resolveu com observações menores
  • 5 — Excelente, remediação perfeita
overrideRootCause
string
Causa raiz fornecida pelo humano (sobrescreve a análise da IA). Deixe vazio para manter a root cause original. Máximo 4096 caracteres.
comments
string
Comentarios adicionais sobre o postmortem ou a remediação. Máximo 4096 caracteres.

Quando Usar

Apos revisar um postmortem na Dashboard, o desenvolvedor pode fornecer feedback estruturado:
  1. Avaliar a remediação — classificar de 1 a 5 a precisao da ação automatica
  2. Corrigir root cause — sobrescrever a causa raiz se a IA errou ou foi imprecisa
  3. Adicionar contexto — comentarios com informações que a IA não tinha acesso
O feedback e exibido diretamente na Dashboard e fica persistido no status do PostMortem CR.
Requer role operator ou superior. O campo providedBy e obrigatório para rastreabilidade. Submeter feedback novamente sobrescreve o feedback anterior. Em caso de conflito concorrente, a API retorna 409 Conflict.
{
  "apiVersion": "v1",
  "kind": "PostMortem",
  "resourceMeta": {
    "name": "PM-20260319-001",
    "namespace": "production"
  },
  "status": {
    "state": "InReview",
    "feedback": {
      "overrideRootCause": "Leak causado por goroutine não cancelada no webhook handler, não pelo response body",
      "remediationAccuracy": 4,
      "comments": "Boa analise. Sugerir AdjustResources antes de restart na proxima vez.",
      "providedBy": "sre@empresa.com",
      "providedAt": "2026-03-19T09:00:00Z"
    }
  }
}
{
  "apiVersion": "v1",
  "kind": "Error",
  "error": "remediationAccuracy must be between 1 and 5",
  "code": 400
}
{
  "apiVersion": "v1",
  "kind": "Error",
  "error": "postmortem was modified concurrently, please retry",
  "code": 409
}