Documentação do Oracle Cloud Infrastructure

Selecionando Dimensões para uma Consulta

Limite os 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 solucionar problemas de consulta, consulte Diagnosticando e Solucionando Problemas de Consultas.

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 o 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 parcial 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 parcial, coloque o conjunto de valores entre aspas: name = "val*" ou name = "value1|value2"

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

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 a correspondência parcial para três conjuntos de valores de dimensão (instâncias de computação de teste 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 o 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 de dimensão.
!~ (ponto de exclamação seguido por til) Diferente de. Use para filtrar vários valores de 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é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 selecionar dimensões usando o modo Básico (padrão), forneça valores para os seguintes campos:
      Observação

      Campos de dimensão adicionais ou outros aparecem para alguns namespaces de 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 o 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 da 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. Clique em Modo Avançado.
      2. Edite o texto na caixa Query code editor.

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