Documentação do Oracle Cloud Infrastructure

Selecionando Dimensões para uma Consulta

Limite dados de métrica retornados selecionando dimensões ao consultar dados de métrica no serviço Monitoring. Dimensão é um qualificador fornecido em uma definição de métrica. No MQL, o componente de seleção de dimensão especifica pares de nome/valor para dimensões, entre chaves.

Para diagnosticar e solucionar problemas de consulta, consulte Solucionando Problemas de Pesquisas.

Exemplos
Observação

As aspas no valor (como em "FAULT-DOMAIN-1") podem ser omitidas, a menos que o valor contenha espaços ou seja usado em Correspondência Parcial.
Exemplo 1: Domínio de Falha
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()
Exemplo 2: Compartimento
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()
Exemplo 3: Forma (com Agrupamento)
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean()
Exemplo 4: Vários Pares de Nome/Valor de Dimensão: Domínio de Falha, Nome e Forma
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
As dimensões nessa consulta são processadas com um operador AND. Os dados resultantes incluem somente os streams de métrica que correspondem a todas as dimensões.
Exemplo 5: Diversos Valores para uma Dimensão: Domínio de Falha 1 ou 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
Os valores de dimensão nessa consulta são processados com um operador OR, usando correspondência parcial. (A correspondência parcial está disponível apenas em expressões MQL. Na Console, use modo Avançado.) Os dados resultantes incluem streams de métrica que correspondem a qualquer um dos valores.
Correspondência Parcial

Especifique correspondências aproximadas ("parciais") com valores de dimensão em uma expressão MQL.

Observação

A correspondência difusa está disponível apenas em expressões MQL. Na Console, use o modo Avançado.

No lugar do sinal de igual (=) entre o nome da dimensão e o conjunto de valores, use o operador de comparação a seguir.

Operador de comparação Descrição
=~ (sinal de igual seguido por til) aproximadamente igual a. Usar para correspondências difusas

Para correspondência difusa, coloque o conjunto de valores entre aspas: name = "val*" ou name = "value1|value2"

Atualize o conjunto de valores usando um ou mais dos seguintes caracteres.

Caractere de Correspondência Parcial de Valor Descrição
* (asterisco) Curinga, indicando de zero a muitos caracteres.
| (barra vertical) Operando OR para valores de dimensão.

Exemplo mostrando correspondência difusa para três conjuntos de valores de dimensão (testar instâncias de computação no domínio de falha 1 que usam a forma myshape):

CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean()
Excluindo Valores

Filtrar (excluir) valores de dimensão em uma expressão MQL.

Observação

A exclusão de valores só está disponível em expressões MQL. Na Console, use modo Avançado.

No lugar do sinal de igual (=) entre o nome da dimensão e o conjunto de valores, use um dos seguintes operadores de comparação.

Operador de comparação Descrição
!= (ponto de exclamação seguido pelo sinal de igual) Diferente de. Use para filtrar um único valor da dimensão.
!~ (ponto de exclamação seguido por til) Diferente de. Use para filtrar vários valores da dimensão (quando a expressão usa curingas ou operandos OR).

Se estiver usando o operador de comparação !~, atualize o conjunto de valores de dimensão usando um ou mais dos seguintes caracteres.

Caractere de Correspondência Parcial de Valor Descrição
* (asterisco) Curinga, indicando de zero a muitos caracteres.
| (barra vertical) Operando OR para valores de dimensão.

Exemplo 1 (Valor Único): Consulta básica para utilização de CPU, excluindo o domínio de falha 1.

CpuUtilization [1m]{faultDomain != "FAULT-DOMAIN-1"}.mean()

Exemplo 2 (Diversos Valores): Consulta básica para utilização de CPU, excluindo os domínios de falha 1 e 2.

CpuUtilization [1m]{faultDomain !~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()

  • Esta seção descreve como selecionar dimensões na página Explorador de Métrica. 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. Para selecionar dimensões usando o modo Básico (padrão), forneça valores para os seguintes campos:
      Observação

      Campos adicionais ou de outra dimensão são exibidos para alguns namespaces da métrica. Por exemplo, um campo de tipo de implantação aparece para o namespace de métricas oci_autonomous_database Consulte a documentação específica do serviço para obter detalhes.
      • Nome da dimensão: Um qualificador especificado na definição da métrica. Por exemplo, a dimensão resourceId é especificada na definição da métrica para CpuUtilization.

        Para selecionar um recurso específico no compartimento selecionado, filtre os resultados por uma dimensão específica do recurso, como resourceDisplayName.

        Observação

        As listas longas de dimensões são reduzidas.

        • Para exibir dimensões por nome, digite um ou mais caracteres na caixa. Uma lista atualizada (reduzida) mostra os nomes das dimensões correspondentes.
        • Para recuperar todas as dimensões de uma métrica, consulte Listando Definições de Métrica.
      • Valor de dimensão: O valor que você deseja usar para a dimensão especificada, por exemplo, o identificador de recurso de uma instância.
      • Dimensão adicional: Adiciona outro par de nome/valor para uma dimensão.
    4. Para selecionar dimensões, atualizando a expressão MQL, siga estas etapas:
      1. Selecione Modo avançado.
      2. Edite o texto na caixa Editor do código de pesquisa.

        Exemplo de dimensão em uma expressão MQL:

        CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()

        Nesse exemplo, os limites de consulta retornaram dados para o domínio de falha 1. O gráfico de Exemplo de Consulta e Gráfico de Métricas agora mostra quatro streams de métrica. Cada stream de métrica corresponde a uma instância no domínio de falha 1.Streams de métrica filtrados para um único domínio de falha.

    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 selecionar dimensões (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 selecionar dimensões (parte da expressão MQL). Para obter um exemplo, consulte SummarizeMetricsDataDetails.