Documentação do Oracle Cloud Infrastructure

Agregando Streams de Métrica em uma Consulta

A agregação de streams de métricas retorna o valor combinado de todos os streams de métricas para a estatística selecionada. Por exemplo, agregue todos os streams de métricas para Utilização da CPU para retornar o valor combinado entre todos os recursos.

A opção Agregar streams de métrica é equivalente a grouping() na expressão MQL.

Observação

Se você agregar streams de métrica, apenas um stream será rastreado. Não agregue streams de métrica com notificações divididas.

Por padrão, um gráfico representa cada stream de métricas com uma linha, o que resulta em várias linhas por gráfico. Quando você agrega streams de métricas, um gráfico representa todos os streams de métricas com uma única linha, o que resulta em apenas uma linha por gráfico.

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

Exemplos

Exemplo 1: Agregar Streams de Métrica para count()
ServiceConnectorHubErrors[1m].grouping().count()

No exemplo 1, a consulta retorna a contagem (count()) de erros em um intervalo de um minuto, com todos os resultados agregados.

Exemplo 2: Agregar Streams de Métrica para max()
IopsRead[1m]{compartmentID = "<compartment_OCID>"}.grouping().max()

No exemplo 2, a consulta retorna os dados de métrica máximo (max()) IopsRead em um intervalo de um minuto, filtrados para um compartimento, com todos os resultados agregados.

  • Esta seção descreve como agregar fluxos de métricas na página Explorador de Métricas. 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. Para agregar fluxos de métricas usando o modo Básico (padrão), selecione Agregar streams de métricas.
    4. Para agregar fluxos de métricas atualizando a expressão MQL, siga estas etapas:
      1. Clique em Modo Avançado.
      2. Edite o texto na caixa Query code editor.
    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 grouping() (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 grouping() (parte da expressão MQL).