Trigger

Uma Trigger (ou Gatilho) define a condição lógica para disparar um alerta com base nos dados coletados por um ou mais Items. Ela é responsável por detectar comportamentos anormais no sistema monitorado.

---

🧩 Estrutura de uma Trigger

Campo	Tipo	Descrição
nome	string	Nome descritivo do trigger
expressao	string	Expressão lógica que define quando o alerta é disparado
severidade	enum	Nível de severidade do alerta: Alto, Médio, Baixo, Informação

---

📝 Expressão

A expressão define a lógica para ativar a trigger. Ela é composta por uma ou mais chaves de item combinadas com operadores:

load.currentLoad > 10

Significa: Se a carga de CPU atual for maior que 10, o trigger será ativado.

Você pode usar expressões simples ou mais complexas:

mem.usedPercent > 80 && load.currentLoad > 10

---

🚦 Severidade

A severidade representa o impacto do problema detectado:

Valor	Significado
Alto	Problema crítico, ação imediata
Médio	Problema moderado, requer atenção
Baixo	Problema leve, pode ser tolerado
Informação	Apenas notificação, sem urgência

---

🔗 Associação com Items

As triggers utilizam os Items como fonte de dados. Cada expressão deve referenciar uma ou mais chaves que já estejam cadastradas nos items do host.

Exemplo: Se a trigger usa load.currentLoad, deve existir um item com essa key.

---

✅ Exemplo de Trigger

{
  "nome": "CPU acima do normal",
  "expressao": "load.currentLoad > 10",
  "severidade": "Alto",
  "items": ["load.currentLoad"]
}

{
  "nome": "Memória e CPU elevadas",
  "expressao": "mem.usedPercent > 80 && load.currentLoad > 10",
  "severidade": "Médio",
  "items": ["mem.usedPercent", "load.currentLoad"]
}

---

📌 Observações

• A trigger é avaliada automaticamente sempre que os valores dos items associados forem atualizados.

• Quando a expressão for verdadeira, o sistema pode gerar:

  • Notificação
  • Entrada em log
  • Ação automática (ex: reinício de serviço, script remoto)

• Triggers podem ser utilizadas em painéis, gráficos e relatórios para indicar o status de um host ou serviço.

---

🔄 Ciclo de vida de uma Trigger

1. Definição: Criada com nome, expressão e severidade.
2. Avaliação: Verificada constantemente conforme chegam dados dos items.
3. Disparo: Quando a condição da expressão é verdadeira.
4. Recuperação: Quando a condição volta ao normal (expressão falsa), o alerta é fechado.

---