Alarmes do PromQL
Um alarme do PromQL monitora as métricas usando uma consulta instantânea do Prometheus Query Language (PromQL). A consulta seleciona as métricas ingeridas por meio do endpoint do OTLP do CloudWatch, e todas as séries temporais correspondentes retornadas pela consulta são consideradas em violação. O alarme avalia a consulta em um intervalo regular e rastreia cada série temporal em violação de forma independente como um colaborador.
Para obter informações sobre como ingerir métricas usando o OpenTelemetry, consulte OpenTelemetry.
Como funcionam os alarmes do PromQL
Um alarme do PromQL avalia uma consulta instantânea do PromQL em uma programação recorrente definida por EvaluationInterval. A consulta retorna somente as séries temporais que satisfazem a condição. Cada série temporal retornada é um colaborador, identificado por seu conjunto exclusivo de atributos.
O alarme usa transições de estado baseadas na duração:
-
Quando um colaborador é retornado pela consulta, isso é considerado em violação. Se o colaborador continuar violando pelo período especificado por
PendingPeriod, ele fará a transição para o estadoALARM. -
Quando um colaborador deixa de ser retornado pela consulta, ele é considerado em recuperação. Se o colaborador permanecer ausente pelo período especificado por
RecoveryPeriod, ele voltará ao estadoOK.
O alarme está no estado ALARM quando pelo menos um colaborador está em violação há mais tempo do que o período pendente. O alarme voltará ao estado OK quando todos os colaboradores tiverem se recuperado.
Configuração de alarmes do PromQL
Um alarme do PromQL é configurado com os seguintes parâmetros:
-
PendingPeriod é a duração em segundos que um colaborador deve violar continuamente antes que ele faça a transição para o estado
ALARM. Isso é equivalente à duraçãoforda regra de alerta do Prometheus. -
RecoveryPeriod é a duração em segundos que um colaborador deve parar de violar antes que ele volte ao estado
OK. Isso é equivalente à duraçãokeep_firing_forda regra de alerta do Prometheus. -
EvaluationInterval é a frequência com que, em segundos, o alarme avalia a consulta do PromQL.
Para criar um alarme do PromQL, consulte Criar um alarme usando uma consulta em PromQL.
