> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/alarm.md).

# Alarme

Alertas operacionais no Kilo IoT Server — Caixa de Entrada, definições de alarme, níveis de severidade, escalonamento e entrega multicanal.

Quando um sensor de armazenamento refrigerado reporta um excesso de temperatura às 3h da manhã, a pessoa certa precisa de saber — imediatamente, de forma fiável e através do canal certo. A secção de Alarmes no Kilo IoT Server transforma dados de sensores em tempo real em alertas operacionais estruturados, com escalonamento em várias etapas, políticas de severidade configuráveis e entrega por e-mail, SMS e push.

> **Lógica de acionamento vs lógica de resposta:** A [Motor de Regras](/kilo-docs-pt/kilo-iot-server/rules-engine.md) determina *quando* um alarme é gerado — avalia os dados do sensor em relação às condições e dispara o alarme quando essas condições são cumpridas. As Definições de Alarme controlam *o que acontece depois de* o alarme disparar: classificação de severidade, cadência de repetição, seleção de destinatários, canais de entrega, horários semanais, janelas de supressão e cadeias de escalonamento para eventos por resolver.

## Estrutura da página

A página de Alarmes tem três separadores:

| Separador                 | Finalidade                                                                                                                                                                                                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Caixa de Entrada**      | Lista todos os eventos de alarme que foram acionados. Filtre por severidade ou estado, pesquise por título, resolva eventos ou navegue até à regra de origem para investigação.                                                                                                                   |
| **Definições de alarmes** | Crie e gere configurações de alarmes. Cada definição especifica a severidade, as etapas de escalonamento, o momento das notificações, o horário, a supressão e a mensagem do alerta. Clique em **Adicionar regra de alarme** para criar uma nova definição.                                       |
| **Definições**            | Gira os contactos de entrega de notificações — e-mail e SMS — com alternâncias de ativar/desativar por canal. A configuração de notificações push está disponível quando ativada para a conta, entregue através do [Aplicação IoT Alerts](/kilo-docs-pt/kilo-iot-server/alarm/iot-alerts-app.md). |

Um **Severidade da notificação** botão no cabeçalho da página (visível em todos os separadores) abre uma janela modal para configurar com que frequência cada nível de severidade volta a enviar notificações.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-9183d1652580a108f4dd9e8d9f13c9fd84e2c408%2Falarm-page-tabs.jpg?alt=media" alt="The Alarm page on the Inbox tab, with the Alarm definitions and Settings tabs, severity and status filters, and a triggered alarm"><figcaption></figcaption></figure>

## Modelo de severidade

O Kilo utiliza cinco níveis de severidade para classificar alarmes por prioridade operacional:

| Nível          | Contexto operacional                                                                                                                          |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Crítico**    | Condições que paralisam a produção e exigem intervenção imediata — falha de equipamento, limites de segurança, violações de conformidade      |
| **Alta**       | Desvios urgentes que requerem resposta rápida — desvio da cadeia de frio, anomalias de pressão, excessos ambientais                           |
| **Médio**      | Não urgentes, mas operacionalmente significativos — acionadores de manutenção programada, limiares de capacidade a aproximarem-se dos limites |
| **Baixo**      | Consciência operacional de rotina — pequenas flutuações dentro da tolerância, alterações informativas do estado do dispositivo                |
| **Informação** | Relatórios de fundo — verificações periódicas de integridade, confirmações do estado do sistema, resumos operacionais                         |

Cada nível tem a sua própria política de repetição de notificações, configurável em [Severidade da notificação](/kilo-docs-pt/kilo-iot-server/alarm/notification-delivery-settings.md).

## Escalonamento

Alarmes por resolver podem escalar por várias etapas — notificando destinatários adicionais através de canais adicionais após atrasos configuráveis. Um engenheiro de prevenção que não responda dentro da janela configurada aciona uma notificação para o supervisor de turno, que por sua vez escala para o gestor do local se o alarme continuar por resolver.

Para obter detalhes completos sobre a configuração de cadeias de escalonamento, consulte [Escalonamento e Resposta](/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md).

## O que ler a seguir

| Página                                                                                             | Quando o ler                                                                                                  |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [O Seu Primeiro Alerta](/kilo-docs-pt/kilo-iot-server/alarm/first-operational-alert.md)            | Crie uma definição de alarme de ponta a ponta, veja-a disparar e resolva-a.                                   |
| [Definições de alarmes](/kilo-docs-pt/kilo-iot-server/alarm/notification-rules.md)                 | Referência completa para criar, editar e gerir definições de alarme.                                          |
| [Escalonamento e Resposta](/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md)         | Configure cadeias de escalonamento em várias etapas para alarmes por resolver.                                |
| [Severidade da notificação](/kilo-docs-pt/kilo-iot-server/alarm/notification-delivery-settings.md) | Controle os intervalos de repetição e o comportamento de notificação única por nível de severidade.           |
| [Caixa de entrada e resolução](/kilo-docs-pt/kilo-iot-server/alarm/inbox-and-resolution.md)        | Faça a triagem dos alarmes recebidos — filtre, pesquise, resolva e recupere até às regras de origem.          |
| [Canais de Entrega](/kilo-docs-pt/kilo-iot-server/alarm/notification-channels.md)                  | Configure e faça a gestão da entrega de notificações por e-mail, SMS e push.                                  |
| [Aplicação IoT Alerts](/kilo-docs-pt/kilo-iot-server/alarm/iot-alerts-app.md)                      | Coloque alarmes nos telemóveis dos responsáveis — e descubra quais as severidades que fazem o telefone tocar. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/alarm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
