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étrica de Utilização de CPU para retornar o valor combinado de 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, veja 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 o máximo (max()) de dados da métrica IopsRead no intervalo de um minuto, filtrados em um compartimento, com todos os resultados agregados.

  • Esta seção descreve como agregar streams de métrica 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 Metrics Explorer.
    2. Se a consulta não estiver aberta, abra-a clicando em Editar consultas.
    3. Para agregar streams de métrica usando o modo Básico (padrão), selecione Agregar streams de métrica.
    4. Para agregar streams de métrica atualizando a expressão MQL, siga estas etapas:
      1. Clique em Modo avançado.
      2. Edite o texto na caixa Editor de código de consulta.
    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).