Documentação do Oracle Cloud Infrastructure

Especificando um Predicado em uma Consulta

Especifique um predicado para consultar dados de métrica no serviço Monitoring.

Embora geralmente usado com alarmes, você também pode usar predicados em consultas para gráficos de métrica personalizados.

Para operadores de predicado válidos em expressões MQL, consulte Operadores de Predicado.

Para solucionar problemas de consulta, veja Diagnosticando e Solucionando Problemas de Consultas.

Exemplos
Exemplo 1: Maior que 80% para Utilização Média de CPU 
CpuUtilization[1m].mean() > 80
Exemplo 2: Entre 60 e 80% para a Utilização Média de CPU 
CpuUtilization[1m].mean() in (60, 80)
Exemplo 3: Maior que 1 para Erros
ServiceConnectorHubErrors[1m].count() > 1
Exemplo 4: Maior que 85 para Percentil 90 de Utilização de CPU (Selecionando um Domínio de Disponibilidade e Agrupando por Pool)
CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85
Exemplo 5: Pelo Menos 20 para Utilização Mínima de CPU (Selecionando "ol8" ou "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Exemplo 6: Pelo menos 30 para Utilização Mínima de CPU (Selecionando Nomes de Instância que Começam com "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Exemplo 7: Ausência de Métricas de Utilização da CPU para o Recurso Especificado, definido como 20 horas para o período de detecção de ausência
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)
Descrição de absent(): Retornará verdadeiro (1) se a métrica estiver ausente para todo o intervalo. Retornará falso (0) se a métrica estiver presente durante o intervalo. É ignorado após o período de detecção de ausência, não gerando valores.

  • Esta seção descreve como especificar um predicado em uma consulta na página Explorador de Métricas. Nessa página, os predicados estão disponíveis apenas no modo Avançado (MQL). Para edições de consulta de alarme, consulte Criando um Alarme Básico.

    1. Crie uma consulta básica na página Metrics Explorer.
    2. Se a consulta não estiver aberta, abra-a clicando em Editar consultas.
    3. Clique em Modo avançado.
    4. Edite o texto na caixa Editor de código de consulta.
      Exemplo 1: Predicado de Limite
      > 80 é o predicado de limite na expressão MQL a seguir.
      CpuUtilization[1m].mean() > 80
      O gráfico de Exemplo de Consulta e Gráfico de Métricas agora mostra um único valor. O valor 85% é resolvido como verdadeiro (1) para indicar que satisfaz a expressão MQL. (Se nenhum valor exceder 80, o gráfico na página Explorador de Métricas mostrará "sem dados".)
      Limite em um gráfico, página Explorador de Métricas.
      Exemplo 2: Predicado de Ausência
      absent() é o predicado de ausência na expressão MQL a seguir.
      CpuUtilization[1m].absent()
      O gráfico de Exemplo de Consulta e Gráfico de Métricas agora mostra um valor "1" para um stream de métrica. O valor "1" no gráfico 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 de ausência em um gráfico, página Explorador de Métricas.

      Para operadores de predicado válidos em expressões MQL, consulte Operadores de Predicado.

    5. Clique em Atualizar Gráfico.

  • Use o comando oci monitoring metric-data summarize-metrics-data e os parâmetros obrigatórios para consultar dados de métrica. Use o parâmetro --query-text para especificar um predicado (parte da expressão MQL).

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    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 SummarizeMetricsData para consultar dados de métrica. Use o atributo query para especificar um predicado (parte da expressão MQL). Para obter um exemplo, consulte SummarizeMetricsDataDetails.