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 las consultas 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 consultas, 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 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. Seleccione el modo avanzado.
    4. Edite el texto en el recuadro 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 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 emplear el elemento groupBy(x) (parte de la expresión MQL).