Documentación de Oracle Cloud Infrastructure

Uso de groupBy(x) en una consulta

Utilice el elemento opcional groupBy(x) al consultar datos de métricas en Monitoring.

Agregue los resultados de la consulta por grupo para representar un valor para cada grupo. Esta opción devuelve el valor combinado de todos los flujos de métricas de cada grupo especificado para la estadística seleccionada. El valor combinado de cada grupo se representa con una sola línea en el gráfico de métricas. Esta opción es útil para identificar tendencias por grupo en lugar de por recurso individual.

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

Ejemplos

Ejemplo 1: Agrupación por dominio de errores
CpuUtilization[1m].groupBy(faultDomain).mean()
Ejemplo 2: Agrupación por grupo de recursos
CpuUtilization[1m].groupBy(resourceGroup).mean()

  • En esta sección se describe cómo utilizar groupBy(x) en la página Explorador de métricas. groupBy(x) solo está disponible en modo avanzado (MQL). Para ver las ediciones de consultas de alarmas, consulte Creación de una alarma básica.

    1. Crear una consulta básica en la página Explorador de métricas.
    2. Si la consulta no está abierta, ábrala seleccionando Editar consultas.
    3. Seleccione Modo avanzado.
    4. Edite el texto en el cuadro Editor de códigos de consulta.

      En el siguiente ejemplo los grupos de expresiones MQL se agrupan por dominio de errores:

      CpuUtilization[1m].groupBy(faultDomain).mean()

      El gráfico de Ejemplo de gráfico de consultas y métricas ahora muestra tres flujos de métricas. Cada flujo de métricas se corresponde con un dominio de errores, que agrega todas las instancias informáticas de ese dominio.

      Flujos de métricas agregados por 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 emplear el elemento groupBy(x) (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 Command Line Reference for Monitoring.

  • Ejecute la operación SummarizeMetricsData para consultar datos de métricas. Utilice el atributo query para emplear el elemento groupBy(x) (parte de la expresión MQL).