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, veja Diagnosticando e Solucionando Problemas de Consultas.
Considerações
Qualquer texto é aceito como nome da dimensão . Se a dimensão não existir, os dados não serão filtrados.
Para garantir que a dimensão exista, liste dimensões para o nome da métrica ou consulte Serviços Suportados
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()
- 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()
Especifique correspondências aproximadas ("parciais") com valores de dimensão em uma expressão MQL.
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 parciais |
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()
Filtrar (excluir) valores de dimensão em uma expressão MQL.
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 operadores 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.
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.