Skip to main content
POST
Resolve Incident
string
obrigatório
Nome único do incidente (ex.: INC-20260319-001)
string
padrão:"default"
Namespace Kubernetes do incidente
string
Descrição de como o incidente foi resolvido. Se omitido, assume o valor padrão "Manually resolved via dashboard".Boa prática: sempre forneça uma mensagem de resolução significativa para postmortem e trilha de auditoria.

Quando Usar Este Endpoint

Este endpoint é crítico nos seguintes cenários:

1. Incidentes Escalados (Ação Humana Necessária)

Quando a plataforma AIOps esgota todas as tentativas de remediação automática (padrão: 3 tentativas), o incidente transiciona para o estado Escalated. Neste ponto:
  • O sistema de notificação alerta a equipe de plantão pelos canais configurados (Slack, PagerDuty, etc.)
  • A política de escalação progride através dos níveis (L1 → L2 → L3) com base nos tempos limite
  • Nenhuma remediação automática adicional será tentada
  • O incidente permanece no estado Escalated até que um humano o resolva por este endpoint, pelo painel web ou pela CLI

2. Verificação Manual Após Remediação Automatica

Mesmo quando a remediação automática e bem-sucedida, operadores podem querer verificar manualmente e fechar o incidente com contexto adicional.

3. Falsos Positivos

Quando um incidente e detectado mas o operador determina que e um falso positivo, use este endpoint com uma resolução como "False positive — metric spike caused by scheduled batch job".

Fluxo de Resolução para Incidentes Escalados

O Que Acontece Após a Resolução

  1. Mudança de Estado: O incidente transiciona de Escalated (ou qualquer estado ativo) para Resolved
  2. Anotações Adicionadas:
    • aiops.chatcli.io/resolved-by — o papel/usuário autenticado
    • aiops.chatcli.io/resolved-at — timestamp da resolução
    • aiops.chatcli.io/manual-resolution — definido como "true"
  3. Cache de Dedup Limpo: A entrada de deduplicação do recurso é invalidada, permitindo que novas anomalias sejam detectadas para o mesmo recurso
  4. PostMortem Gerado: Um postmortem automático é criado com os detalhes da resolução
  5. Evento de Auditoria: Um evento de auditoria imutável é registrado para conformidade

Autorizações

Authorization
string
header
obrigatório

Bearer token issued by the operator. Format: Authorization: Bearer <token>.

Parâmetros de caminho

name
string
obrigatório

Unique incident name.

Exemplo:

"INC-20260319-001"

Parâmetros de consulta

namespace
string
padrão:default

Kubernetes namespace of the incident.

Corpo

application/json
resolution
string

Description of how the incident was resolved. Defaults to "Manually resolved via dashboard" when omitted.

Resposta

Incident resolved

apiVersion
string
Exemplo:

"v1"

kind
string
Exemplo:

"Incident"

metadata
object
spec
object
status
object