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 diagnosticar e solucionar problemas de consulta, consulte Solucionando Problemas de Pesquisas.

Exemplos
Exemplo 1: Maior que 80% para a Média de Utilização da CPU 
CpuUtilization[1m].mean() > 80
Exemplo 2: Entre 60 e 80 por cento para a Média de Utilização da CPU 
CpuUtilization[1m].mean() in (60, 80)
Exemplo 3: Maior que 1 para Erros
ServiceConnectorHubErrors[1m].count() > 1
Exemplo 4: Maior que 85 para Utilização de CPU do 90º Percentil (Selecionando um Domínio da Disponibilidade e Agrupamento 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 da CPU (Selecionando "ol8" ou "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Exemplo 6: Pelo Menos 30 para Utilização Mínima da CPU (Selecionando Nomes de Instâncias 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 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 absent(): Retornará verdadeiro (1) se a métrica estiver ausente em todo o intervalo. Retorna falso (0) se a métrica estiver presente durante o intervalo. É ignorado após o período de detecção de ausência, sem gerar valores.

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

    1. Crie uma consulta básica na página Explorador de Métrica.
    2. Se a consulta não estiver aberta, abra-a selecionando Editar consultas.
    3. Selecione Modo avançado.
    4. Edite o texto na caixa Editor do código de pesquisa.
      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 ultrapassar 80, o gráfico na página Explorador de Métrica mostrará "nenhum dado").
      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. Selecione 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 CLI, consulte a Referência de Linha de Comandos para Monitoramento.

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