# Monitoramentos

Monitoramento é a configuração que observa uma métrica em intervalos regulares e emite alertas quando as regras de detecção são acionadas.

Enquanto a métrica transforma eventos em séries temporais, o monitoramento é o mecanismo que acompanha essas séries e sinaliza comportamentos fora do esperado — como um aumento anormal de recusas, uma queda brusca no volume de transações ou o cruzamento de um limite definido manualmente.

## Componentes de um monitoramento

### O que está sendo monitorado

Define a origem dos dados analisados:

* **Métrica**: qual métrica será observada. Não pode ser alterada após a criação.
* **Agregação**: qual cálculo da métrica será analisado (contagem, soma, taxa, etc.).
* **Filtros** (opcional): restringe o escopo do monitoramento a um subconjunto dos eventos, com base nas dimensões da métrica.

### Com que frequência

O intervalo define a periodicidade com que a análise é executada. A cada ciclo, a plataforma avalia o valor mais recente da agregação e verifica se as regras de detecção são acionadas.

### Regras de detecção

As regras determinam quando um alerta deve ser aberto. É necessário configurar ao menos um dos dois métodos:

#### Detecção de anomalias

A detecção de anomalias usa aprendizado de máquina para identificar comportamentos fora do padrão histórico da métrica. O modelo considera a sazonalidade e a tendência da série para determinar o que é esperado em cada período.

Ao habilitar a detecção de anomalias, é possível configurar a **direção**:

* **Alta**: alerta apenas quando o valor sobe além do esperado.
* **Baixa**: alerta apenas quando o valor cai abaixo do esperado.
* **Ambas**: alerta em qualquer desvio significativo.

#### Condições

Condições são regras manuais que comparam o valor atual de uma agregação com um limite definido. Quando o valor ultrapassa o limite configurado, o alerta é aberto.

É possível configurar múltiplas condições no mesmo monitoramento.

### Notificações

Ao configurar um canal de notificação, a plataforma envia um aviso sempre que um alerta for aberto. Se nenhum canal for configurado, os alertas ficam disponíveis apenas no painel.

## Alertas

Cada vez que uma regra de detecção é acionada, um alerta é aberto. O alerta permanece aberto até que o comportamento retorne ao normal ou o monitoramento seja desativado.

Ao desativar um monitoramento, todos os alertas abertos são encerrados automaticamente. O mesmo ocorre ao remover o monitoramento.

## Status

Um monitoramento pode estar **ativo** ou **inativo**. Quando inativo, a análise é suspensa e os alertas abertos são encerrados.

## Limites

* Máximo de **20 monitoramentos** por tipo de evento.
* Um monitoramento depende de uma métrica ativa — não é possível remover uma métrica enquanto ela estiver em uso por um ou mais monitoramentos.