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 consulta, 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, utilice 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, utilice 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 que muestra la coincidencia parcial para tres juegos de valores de dimensión (prueba de instancias informáticas 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, utilice 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 de 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 ver las ediciones de consultas de alarmas, consulte Creating a Basic Alarm.

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

      Aparecen campos de dimensión adicionales u otros campos para algunos espacios de nombres de métricas. Por ejemplo, aparece un campo de tipo de despliegue para el espacio de nombres de métrica oci_autonomous_database. Consulte la documentación específica del servicio para obtener más información.
      • Nombre de la dimensión: calificador especificado en la definición de la 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 Lista de definiciones de métricas.
      • Valor de 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 actualizando la expresión MQL, siga estos pasos:
      1. Haga clic en Modo avanzado.
      2. Edite el texto en el cuadro Editor de código 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. Haga clic en 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 los comandos de la CLI, consulte la Referencia de la línea de comandos para Monitoring.

  • 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.