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 valores 1 contínuos para a duração do período de detecção de ausência, a estatística interrompe o retorno de valores. Quando a métrica estiver presente durante o intervalo, a estatística retornará 0 (falso).

O período padrão de detecção de ausência é 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 definida em um intervalo de 1 minuto (com o período padrão de detecção de ausência):
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 incluir groupBy na consulta do alarme de ausência. O uso de groupBy impede acionamentos de alarme irrelevantes quando o OCI introduz novas dimensões. Uma nova dimensão cria um fluxo de métricas inicialmente vazio.

Com groupBy, o alarme monitora apenas streams de métrica agrupados. A consulta de exemplo anterior aciona o alarme quando não há streams de métrica para a instância. Se o serviç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 serviço OCI Compute adicionar uma dimensão a CpuUtilization, o alarme será acionado, independentemente da presença de outros streams de métrica.

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

Para solucionar problemas de alarme, consulte Diagnosticando e Solucionando Problemas de Alarmes.

    1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. No serviço Monitoring, clique em Definições de Alarme.
    2. Clique em Criar Alarme.
    3. Na seção Regra do acionador em Criar Alarme, configure o acionador de ausência:
      • Operador: Selecione ausente.
      • Minutos de atraso do trigger: Informe o número de minutos no qual a condição deve ser mantida antes que o alarme seja acionado.

      Se preferir, clique em Alternar para Modo Avançado para usar MQL.

    4. Para personalizar o período de detecção de ausência:
      O período padrão de detecção de ausência é 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, clique em Alterar para o Modo Avançado.
        A consulta aparece no Monitoring Query Language (MQL), na caixa Editor de códigos de consultas. 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 o 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)
    5. (Opcional) Para evitar acionamentos de alarme irrelevantes quando o OCI introduz novas dimensões (recomendado):
      1. Vá para a área Dimensões de 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ê selecionou resourceId como a dimensão, selecione o identificador de recurso da instância que você está monitorando.
      2. Na parte superior da página, clique em Alterar para o Modo Avançado.
        A consulta aparece no Monitoring Query Language (MQL), na caixa Editor de códigos de consultas. 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()
    6. Forneça valores para os campos restantes.
      Para referência, consulte Criando um Alarme Básico.
    7. Clique em 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 da CLI, consulte a Referência de Linha de Comando para o Serviço Monitoring.

  • 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.