Documentación de Oracle Cloud Infrastructure

Especificación de un predicado en una consulta

Especifique un predicado para consultar datos de métricas en Monitoring.

Aunque se suele utilizar con alarmas, también puede utilizar predicados en consultas de gráficos de métricas personalizados.

Para ver los operadores de predicado válidos en las expresiones MQL, consulte Operadores de predicado.

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

Ejemplos
Ejemplo 1: Mayor que 80% para el uso medio de CPU 
CpuUtilization[1m].mean() > 80
Ejemplo 2: entre 60 y 80 por ciento para el uso medio de CPU 
CpuUtilization[1m].mean() in (60, 80)
Ejemplo 3: mayor que 1 para errores
ServiceConnectorHubErrors[1m].count() > 1
Ejemplo 4: mayor que 85 para el uso de CPU del percentil 90 (selección de un dominio de disponibilidad y agrupación por pool)
CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85
Ejemplo 5: al menos 20 para el uso mínimo de CPU (seleccionando "ol8" o "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Ejemplo 6: al menos 30 para el uso mínimo de CPU (selección de nombres de instancia que empiecen por "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Ejemplo 7: ausencia de métricas de uso de CPU para el recurso especificado
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
Descripción de absent(): devuelve true (1) si la métrica está ausente para todo el intervalo. Devuelve false (0) si la métrica está presente durante el intervalo. Se ignora después de dos horas, sin generar ningún valor.

  • En esta sección se describe cómo especificar un predicado en una consulta en la página Explorador de métricas. En esta página, los predicados solo están disponibles 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.
      Ejemplo 1: predicado de umbral
      > 80 es el predicado de umbral en la siguiente expresión MQL.
      CpuUtilization[1m].mean() > 80
      El gráfico de Ejemplo de consulta y gráfico de métricas ahora muestra un único valor. El valor del 85% se resuelve en true (1) para indicar que cumple la expresión MQL. (Si ningún valor supera 80, el gráfico de la página Explorador de métricas mostrará "sin datos".)
      Umbral en un gráfico, página Explorador de métricas.
      Ejemplo 2: predicado de ausencia
      absent() es el predicado de ausencia en la siguiente expresión MQL.
      CpuUtilization[1m].absent()
      El gráfico de Ejemplo de consulta y gráfico de métricas ahora muestra un valor "1" para un flujo de métricas. El valor "1" del gráfico indica que la instancia informática correspondiente a este flujo de métricas no ha emitido datos de la métrica CpuUtilization hasta las 1:30.
      Datos de métricas ausentes en un gráfico, página Explorador de métricas.

      Para ver los operadores de predicado válidos en las expresiones MQL, consulte Operadores de predicado.

    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 especificar un predicado (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 especificar un predicado (parte de la expresión MQL). Para obtener un ejemplo, consulte SummarizeMetricsDataDetails.