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 consultas, consulte Solución de problemas de consultas.

Ejemplos
Ejemplo 1: uso medio de la CPU superior al 80 %
CpuUtilization[1m].mean() > 80
Ejemplo 2: uso medio de la CPU entre 60 y 80 por ciento
CpuUtilization[1m].mean() in (60, 80)
Ejemplo 3: Mayor que 1 para errores
ServiceConnectorHubErrors[1m].count() > 1
Ejemplo 4: Uso de CPU del percentil 90 mayor que 85 (predicado de 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 instancias que comienzan con "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Ejemplo 7: Ausencia de métricas de uso de CPU para el recurso especificado, definida en 20 horas para el período de detección de ausencias
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)
Descripción 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 del período de detección de ausencia, 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 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.
      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 ha excedido 80, en el gráfico de las páginas Explorador de métricas aparecerá "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. 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 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 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 especificar un predicado (parte de la expresión MQL). Para obtener un ejemplo, consulte SummarizeMetricsDataDetails.