Documentación de Oracle Cloud Infrastructure

Selección de dimensiones para una consulta

Para limitar los datos de métricas devueltos, seleccione las dimensiones al consultar datos de métricas en Monitoring. Una dimensión es un calificador proporcionado en una definición de métrica. En MQL, el componente de selección de dimensiones especifica pares nombre-valor para dimensiones, entre llaves.

Para solucionar problemas de consultas, consulte Solución de problemas de consultas.

Ejemplos
Nota

Las comillas que rodean el valor (como en "FAULT-DOMAIN-1") se pueden omitir, a menos que el valor contenga espacios o se utilice en Coincidencia parcial.
Ejemplo 1: dominio de errores
CpuUtilization[1m]{faultDomain = "FAULT-DOMAIN-1"}.mean()
Ejemplo 2: Compartimento
IopsRead[1m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().max()
Ejemplo 3: Unidad (con agrupación)
CpuUtilization[1m]{shape="VM.Standard.E4.Flex"}.groupBy(availabilityDomain,poolId).mean()
Ejemplo 4: Pares nombre-valor de varias dimensiones: dominio de errores, nombre y unidad
CpuUtilization [1m]{faultDomain = "FAULT-DOMAIN-1", resourceDisplayName = "test", shape = "myshape"}.mean()
Las dimensiones de esta consulta se procesan con un operador AND. Los datos resultantes incluyen solo los flujos de métricas que coinciden con todas las dimensiones.
Ejemplo 5: Varios valores para una dimensión: dominio de errores 1 o 2
CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1|FAULT-DOMAIN-2"}.mean()
Los valores de dimensión de esta consulta se procesan con un operador OR mediante coincidencia parcial. (La coincidencia parcial solo está disponible en expresiones MQL. En la consola, use el modo avanzado). Los datos resultantes incluyen flujos de métricas que coinciden con cualquier valor.
Coincidencia parcial

Especifique coincidencias aproximadas ("parciales") con los valores de dimensión en una expresión MQL.

Nota

La coincidencia parcial solo está disponible en expresiones MQL. En la consola, use el modo avanzado.

En lugar del signo igual (=) entre el nombre de dimensión y el juego de valores, utilice el siguiente operador de comparación.

Operador de comparación Descripción
=~ (signo igual seguido de virgulilla) Aproximadamente igual a. Usar para coincidencias parciales

Para la coincidencia parcial, rodee el juego de valores con comillas: name = "val*" o name = "value1|value2"

Actualice el juego de valores con uno o más de los siguientes caracteres.

Carácter de coincidencia parcial de valor Descripción
* (asterisco) Comodín, que indica de cero a muchos caracteres.
| (pleca) Operando OR para valores de dimensión.

Ejemplo en el que se muestra la coincidencia parcial para tres conjuntos de valores de dimensión (coincidencia parcial para instancias informáticas de prueba en el dominio de errores 1 que utilizan la unidad myshape):

CpuUtilization [1m]{faultDomain =~ "FAULT-DOMAIN-1", resourceDisplayName =~ "test*", shape =~ "myshape"}.mean()
Exclusión de valores

Filtre (excluya) valores de dimensión en una expresión MQL.

Nota

La exclusión de valores solo está disponible en expresiones MQL. En la consola, use el modo avanzado.

En lugar del signo igual (=) entre el nombre de dimensión y el juego de valores, utilice uno de los siguientes operadores de comparación.

Operador de comparación Descripción
!= (signo de exclamación seguido del signo igual) Distinto de. Se utiliza para filtrar un único valor de dimensión.
!~ (signo de exclamación seguido de virgulilla) Distinto de. Se utiliza para filtrar varios valores en la dimensión (cuando la expresión utiliza comodines u operandos OR).

Si utiliza el operador de comparación !~, actualice el juego de valores de dimensión con uno o más de los siguientes caracteres.

Carácter de coincidencia parcial de valor Descripción
* (asterisco) Comodín, que indica de cero a muchos caracteres.
| (pleca) Operando OR para valores de dimensión.

Ejemplo 1 (valor único): consulta básica para el uso de CPU, excluido el dominio de errores 1.

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

Ejemplo 2 (varios valores): consulta básica para el uso de CPU, excepto los dominios de errores 1 y 2.

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

  • En esta sección se describe cómo seleccionar dimensiones en la página Explorador de métricas. Para consultar las ediciones de consultas de alarmas, consulte Creación de la alarma básica.

    1. Cree una consulta básica en la página Explorador de métricas.
    2. Si la consulta no está abierta, ábrala seleccionando Editar consultas.
    3. Para seleccionar dimensiones mediante el modo básico (valor por defecto), proporcione valores para los siguientes campos:
      Nota

      Aparecen campos adicionales o de dimensión para algunos espacios del nombre de las métricas. Por ejemplo, aparece un campo para el espacio oci_autonomous_database de nombres de métrica. Consulte la documentación específica del servicio para obtener más información.
      • Nombre de dimensión: cualificador especificado en la definición de métrica. Por ejemplo, la dimensión resourceId se especifica en la definición de métrica para CpuUtilization.

        Para seleccionar un recurso específico en el compartimento seleccionado, filtre los resultados por una dimensión específica del recurso, como resourceDisplayName.

        Nota

        Se recortan listas largas de dimensiones.

        • Para ver las dimensiones por nombre, escriba uno o varios caracteres en el cuadro. Una lista actualizada (recortada) muestra los nombres de dimensiones coincidentes.
        • Para recuperar todas las dimensiones de una métrica, consulte Enumeración de definiciones de métricas.
      • Valor de la dimensión: valor que desea utilizar para la dimensión especificada, por ejemplo, el identificador de recurso para una instancia.
      • Dimensión Adicional: agrega otro par nombre-valor para una dimensión.
    4. Para seleccionar dimensiones mediante la actualización de la expresión MQL, siga estos pasos:
      1. Seleccione el modo avanzado.
      2. Edite el texto en el recuadro Editor de Códigos de Consulta.

        Ejemplo de dimensión en una expresión MQL:

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

        En este ejemplo, la consulta limita los datos devueltos al dominio de errores 1. El gráfico de Ejemplo de gráfico de consultas y métricas ahora muestra cuatro flujos de métricas. Cada flujo de métricas se corresponde con una instancia del dominio de errores 1.Flujos de métricas filtrados en un único dominio de errores.

    5. Seleccione Actualizar gráfico.

  • Utilice el comando oci monitoring metric-data summarize-metrics-data y los parámetros necesarios para consultar datos de métricas. Utilice el parámetro --query-text para seleccionar dimensiones (parte de la expresión MQL).

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    Para obtener una lista completa de parámetros y valores para comandos de CLI, consulte la Referencia de línea de comandos para la supervisión.

  • Ejecute la operación SummarizeMetricsData para consultar datos de métricas. Utilice el atributo query para seleccionar dimensiones (parte de la expresión MQL). Para obtener un ejemplo, consulte SummarizeMetricsDataDetails.