Documentação do Oracle Cloud Infrastructure

Criando um Alarme de Ausência

Crie um alarme de ausência no serviço Monitoring para enviar notificações quando uma métrica não emitir dados para um intervalo especificado.

A estatística absent() em um alarme de ausência retorna 1 (verdadeiro) quando a métrica está ausente para todo o intervalo. Após os valores contínuos de 1 pela duração do período de detecção de ausência, a estatística interrompe o retorno dos valores. Quando a métrica está presente durante o intervalo, a estatística retorna 0 (falso).

O período de detecção de ausência padrão é de duas horas. Para obter mais informações sobre o período de detecção de ausência, consulte Exemplo de Alarme de Ausência.

Exemplo
A consulta de métrica a seguir tem um alarme de ausência para uma instância de computação que é definida em um intervalo de 1 minuto (com o período de detecção de ausência padrão):
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
A consulta de métrica a seguir define o período de detecção de ausência como 20 horas:
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20h)
Observação

Recomendamos a inclusão de groupBy na consulta do alarme de ausência. O uso de groupBy impede acionadores de alarme irrelevantes quando a OCI introduz novas dimensões. Uma nova dimensão cria um fluxo de métrica inicialmente vazio.

Com groupBy, o alarme monitora somente streams de métricas agrupados. A consulta de exemplo anterior aciona o alarme quando não há streams de métrica para a instância. Se o OCI Compute adicionar uma dimensão a CpuUtilization e outros streams de métrica (de outras dimensões) não estiverem ausentes, o alarme não será acionado.

Sem groupBy, o alarme monitora todos os streams de métrica. Por exemplo, considere a consulta CpuUtilization[1m].absent(). Se o OCI Compute adicionar uma dimensão ao CpuUtilization, o alarme será acionado, independentemente da presença de outros streams de métrica.

No gráfico de métricas da página Criar Alarme, uma linha vermelha tracejada indica o limite de ausência. O exemplo a seguir mostra um valor 1 para um fluxo de métricas, o que indica que a instância de computação correspondente a esse fluxo de métricas não emitiu dados da métrica CpuUtilization até 1:30.
Dados de métrica ausentes em um gráfico, página Criar Alarme.

Para diagnóstico e solução de problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes.

    1. Na página de lista Definições de Alarme, selecione Criar Alarme. Se precisar de ajuda para localizar a página da lista, consulte Listando Alarmes.
    2. Na seção Regra do acionador em Criar Alarme, configure o acionador de ausência:
      • Operador: Selecione ausente.
      • Minutos de atraso do acionador: Informe o número de minutos nos quais a condição deve ser mantida antes do alarme estar no estado de acionamento.

      Se preferir, selecione Alternar para o Modo Avançado para usar o MQL.

    3. Para personalizar o período de detecção de ausência:
      O período de detecção de ausência padrão é de duas horas. Para obter mais informações sobre o período de detecção de ausência, consulte Exemplo de Alarme de Ausência.
      1. Na parte superior da página, selecione Alternar para o Modo Avançado.
        A consulta aparece em Monitoring Query Language (MQL), na caixa Editor de código de consulta. Exemplo:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      2. Substitua absent() por absent(<number-and-unit).
        Os valores válidos variam de um minuto (1m) a três dias (3d ou 72h). Especifique a quantidade de tempo no período de detecção de ausência usando um número e uma unidade (m, h ou d para minuto, hora ou dia).
        Exemplo (período de detecção de ausência de 20 horas):
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent(20h)
    4. (Opcional) Para evitar acionadores de alarme irrelevantes quando o OCI introduzir novas dimensões (recomendado):
      1. Vá para a área Dimensões da métrica e forneça os seguintes valores:
        • Nome da dimensão: Selecione um qualificador especificado na definição da métrica. Por exemplo, a dimensão resourceId é especificada na definição da métrica para CpuUtilization.
        • Valor da dimensão: Selecione o valor a ser usado para a dimensão especificada. Por exemplo, se você tiver selecionado resourceId como a dimensão, selecione o identificador de recurso da instância que você está monitorando.
      2. Na parte superior da página, selecione Alternar para o Modo Avançado.
        A consulta aparece em Monitoring Query Language (MQL), na caixa Editor de código de consulta. Exemplo:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      3. Na caixa Editor de código de consulta, antes de .absent(), insira .groupBy(<dimension_name>).
        Exemplo:
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
    5. Forneça valores para os campos restantes.
      Para referência, consulte Criando um Alarme Básico.
    6. Selecione Salvar alarme.

  • Use o comando oci monitoring alarm create e os parâmetros obrigatórios para criar um alarme de limite. Para o parâmetro obrigatório --query-text, use uma expressão MQL que especifique uma regra de trigger de ausência:

    oci monitoring alarm create --query-text <mql_expression_specifying_absence_trigger_rule> [...]

    Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Linha de Comandos para Monitoramento.

  • Execute a operação CreateAlarm para criar um alarme de ausência.

    Ao definir detalhes para CreateAlarmDetails, defina query como expressão MQL que especifica uma regra de trigger de ausência.