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 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. Haga clic en Modo avanzado.
    4. Edite el texto en el cuadro Editor de código 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. 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 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 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 emplear el elemento groupBy(x) (parte de la expresión MQL).