> 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/notification-rules.md).
# Definições de Alarme
Configure definições de alarme no Kilo IoT — severidade, escalonamento, cadência de repetição, canais, horário, supressão, corpo.
Uma definição de alarme configura a resposta operacional quando o [Motor de Regras](/kilo-docs-pt/kilo-iot-server/rules-engine.md) dispara um alarme — classificação de severidade, cadeia de escalonamento, cadência de repetição, canais de entrega, agendamento, supressão e a mensagem de notificação. As definições de alarme são geridas a partir do **Definições de alarmes** separador na página de Alarmes.
Clique em **Adicionar regra de alarme** para criar uma nova definição, ou clique em **Editar** numa existente para a modificar.
## Campos do formulário da definição
### Nome do alarme
| Campo | Detalhe |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome do alarme** | Campo de texto. Placeholder: *Introduza o nome*. Obrigatório. Este nome aparece na Caixa de entrada quando o alarme dispara e nas linhas de assunto das notificações. |
### Severidade
| Campo | Detalhe |
| ------------------------ | ----------------------------------------------------------------------------- |
| **Escolha a severidade** | Lista suspensa. Opções: Crítica, Alta, Média, Baixa, Informação. Obrigatório. |
A severidade determina a cadência de repetição das notificações (configurada em [Severidade da notificação](/kilo-docs-pt/kilo-iot-server/alarm/notification-delivery-settings.md)) e a prioridade visual na Caixa de entrada. Após selecionar uma severidade, o formulário mostra a política de repetição atual para esse nível. Substituições por alarme estão disponíveis na secção Intervalo de notificação personalizado abaixo.
### Intervalo de notificação personalizado
Substituir a política global de repetição para este alarme específico.
| Campo | Detalhe |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Intervalo de notificação personalizado** | Interruptor (Desligado por predefinição). Quando Ligado, revela controlos de intervalo e de notificação única. |
| **Intervalo** | Número + unidade (Horas ou Dias). Controla com que frequência as notificações são reenviadas enquanto o alarme permanecer ativo. |
| **Notificação única** | Interruptor. Quando Ligado, é enviada uma notificação e não há repetições. Aparece uma mensagem contextual a confirmar: *"As notificações de \[Severity] são enviadas uma vez. Pode alterá-lo abaixo."* — em que \[Severity] corresponde ao nível de severidade selecionado para esta definição de alarme. |
### Cadeia de escalonamento
Escalonamento em várias etapas para alarmes não resolvidos. A primeira etapa é **Imediata** e não pode ser removida. Etapas adicionais são acionadas após atrasos configuráveis se o alarme permanecer sem resolução.
Para um guia detalhado, consulte [Escalonamento e Resposta](/kilo-docs-pt/kilo-iot-server/alarm/escalation-and-response.md). Em resumo:
* Cada etapa especifica: **Notificar** (destinatários da organização — **obrigatório**, pelo menos um destinatário deve ser selecionado), **Via** (canais de entrega).
* Clique em **Adicionar passo** para adicionar níveis de escalonamento com atrasos configuráveis.
* A resolução em qualquer momento interrompe o escalonamento subsequente.
### Agendamento
| Campo | Detalhe |
| ----------------------- | ------------------------------------------------------------------------------------ |
| **Agendamento** | Mostra o agendamento atual ou "24/7 por predefinição". |
| **Alterar agendamento** | Abre um popover com alternâncias dos dias da semana e um intervalo de hora De / Até. |
Use o agendamento para delimitar alarmes a horário de expediente, janelas de turno ou monitorização fora de horas — por exemplo, um alarme de temperatura da sala de servidores que só dispara fora das janelas de manutenção.
### Suprimir duplicados
| Campo | Detalhe |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Suprimir duplicados nesta janela (em minutos)** | Controlador deslizante. Intervalo: 1–60 minutos. Impede que o mesmo alarme dispare repetidamente quando um sensor comunica com frequência. |
### Mensagem
| Campo | Detalhe |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **Assunto** | Linha de assunto da notificação. Placeholder: *Alarme de incêndio na cozinha*. Obrigatório. |
| **Corpo da mensagem** | Corpo da notificação (várias linhas, 3 filas). Placeholder: *O seu texto aqui*. Obrigatório. |
Escreva mensagens que possam ser imediatamente acionadas — inclua o que aconteceu, onde aconteceu e qual é a resposta esperada.
## Guardar e gerir
Clique em **Adicionar nova regra de alarme** para criar a definição, ou **Salvar** ao editar. Clique em **Cancelar** para descartar as alterações.
A **Definições de alarmes** separador lista todas as definições com as seguintes colunas:
| Coluna | Conteúdo |
| ----------------- | ------------------------------------------ |
| **Alarme** | Nome da definição |
| **Mensagem** | Corpo da mensagem (truncado) |
| **Severidade** | Nível de severidade (codificado por cores) |
| **Destinatários** | Destinatários da etapa de escalonamento |
Cada linha tem:
* **Alternar** — Ative ou desative a definição sem a eliminar. As definições desativadas não disparam mesmo quando o Motor de Regras as aciona.
* **Editar** — Reabrir o formulário da definição.
Para eliminar permanentemente uma definição, abra-a em modo de edição e clique em **Eliminar alarme** na parte inferior do formulário.
## Exemplos empresariais
* **Excedência de temperatura na cadeia de frio:** Severidade Crítica. Notificação imediata ao técnico de refrigeração de serviço. Escalonar para o supervisor de turno e depois para o gestor do local. Agendamento: 24/7. Supressão: 10 minutos.
* **Alarme de humidade da sala de servidores:** Severidade Alta. Notificação imediata às operações do centro de dados. Assunto: "Excedência de humidade no DC-3." Mensagem: "A humidade da fila de bastidores B excedeu o limiar operacional."
* **Desvio de pressão da bomba:** Severidade Média. Apenas em horário de expediente (Seg–Sex 06:00–22:00). Notificar a equipa de manutenção. Notificação única — não repetir.
---
# 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/notification-rules.md?ask=&goal=
```
`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.
