> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Severidades

> As quatro severidades do aciona.me e como valores de cada ferramenta são traduzidos.

O aciona.me trabalha com um conjunto fechado de quatro severidades.

| Severidade | Uso típico                                            | Push |
| ---------- | ----------------------------------------------------- | ---- |
| `critical` | Impacto direto no cliente; alguém precisa agir agora. | ✅    |
| `high`     | Degradação relevante; precisa de atenção rápida.      | ✅    |
| `warning`  | Sinal de alerta; pode esperar o horário comercial.    | ✅    |
| `info`     | Informativo; registro sem urgência.                   | —    |

<Warning>
  Acionamentos com severidade `info` **não geram notificações push**. E-mail, Slack e Microsoft Teams continuam sendo enviados.
</Warning>

## Sinônimos reconhecidos

Valores livres enviados pelas ferramentas são normalizados. A comparação ignora maiúsculas e espaços.

| Severidade final | Valores aceitos                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------- |
| `critical`       | `critical`, `crit`, `fatal`, `emergency`, `page`, `p1`, `sev1`                               |
| `high`           | `high`, `error`, `err`, `major`, `p2`, `sev2`                                                |
| `warning`        | `warning`, `warn`, `medium`, `minor`, `p3`, `sev3`                                           |
| `info`           | `info`, `information`, `informational`, `notice`, `low`, `debug`, `p4`, `p5`, `sev4`, `sev5` |

Valores ausentes ou não reconhecidos caem em **`warning`**.

## Mapeamento por ferramenta

<Tabs>
  <Tab title="Prometheus / Grafana">
    Vem da label `severity`. Sem ela, `warning`.

    ```yaml theme={null}
    labels:
      severity: critical
      service: api-pagamentos
    ```
  </Tab>

  <Tab title="Datadog">
    Vem da **prioridade do monitor** (`$ALERT_PRIORITY`):

    | Prioridade | Severidade |
    | ---------- | ---------- |
    | `P1`       | `critical` |
    | `P2`       | `high`     |
    | `P3`       | `warning`  |
    | `P4`, `P5` | `info`     |

    Sem prioridade, o tipo do alerta é usado como alternativa.
  </Tab>

  <Tab title="New Relic">
    Vem de `priority`:

    | `priority` | Severidade |
    | ---------- | ---------- |
    | `CRITICAL` | `critical` |
    | `HIGH`     | `high`     |
    | `MEDIUM`   | `warning`  |
    | `LOW`      | `info`     |
  </Tab>

  <Tab title="Zabbix">
    Vem da prioridade numérica do evento:

    | Zabbix             | Severidade |
    | ------------------ | ---------- |
    | 5 — Disaster       | `critical` |
    | 4 — High           | `high`     |
    | 3 — Average        | `warning`  |
    | 2 — Warning        | `warning`  |
    | 1 — Information    | `info`     |
    | 0 — Not classified | `info`     |
  </Tab>

  <Tab title="CloudWatch">
    O CloudWatch não tem severidade nativa. A Lambda de transformação resolve em camadas:

    1. Marcador no `AlarmDescription`: `[severity:critical]`
    2. Palavra no nome do alarm: `critical`, `high`, `warning`, `info`
    3. Padrão: `warning`
  </Tab>
</Tabs>

## Boas práticas

<AccordionGroup>
  <Accordion title="Reserve critical para o que acorda alguém" icon="siren">
    Se tudo é `critical`, nada é. A severidade deve responder: "isso justifica tirar alguém da cama?".
  </Accordion>

  <Accordion title="Use info para o que é só registro" icon="file-text">
    Deploys, execuções de job bem-sucedidas e mudanças de configuração ficam registrados sem gerar push.
  </Accordion>

  <Accordion title="Padronize entre ferramentas" icon="equal">
    Se o Grafana usa `critical` e o Datadog usa `P1`, os dois chegam como `critical` — mas alinhar o vocabulário facilita a vida de quem lê o alerta.
  </Accordion>
</AccordionGroup>