Documentação do Oracle Cloud Infrastructure

Usando groupBy(x) em uma Consulta

Use o elemento groupBy(x) opcional ao consultar dados de métrica no serviço Monitoring.

Agregar resultados de consulta por grupo para representar um valor para cada grupo. Esta opção retorna o valor combinado de todos os streams de métrica em cada grupo especificado para a estatística selecionada. O valor combinado de cada grupo é representado como linha única no gráfico de métricas. Essa opção é útil quando você deseja identificar tendências por grupo, em vez de por recurso individual.

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

Exemplos

Exemplo 1: Agrupar por Domínio de Falha
CpuUtilization[1m].groupBy(faultDomain).mean()
Exemplo 2: Agrupar por Grupo de Recursos
CpuUtilization[1m].groupBy(resourceGroup).mean()

  • Esta seção descreve como usar groupBy(x) na página Explorador de Métricas. groupBy(x) só está disponível 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 Explorador de Métricas.
    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 Query code editor.

      O exemplo a seguir agrupa a expressão MQL por domínio de falha:

      CpuUtilization[1m].groupBy(faultDomain).mean()

      O gráfico de Exemplo de Consulta e Gráfico de Métricas agora mostra três streams de métrica. Cada stream de métrica corresponde a um domínio de falha, agregando todas as instâncias de computação nesse domínio de falha.

      Streams de métrica agregados por domínio de falha.

    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 empregar o elemento groupBy(x) (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 empregar o elemento groupBy(x) (parte da expressão MQL).