Creación de una Consulta

Defina una consulta para recuperar datos de Monitoring.

Para obtener un ejemplo de consulta, consulte Ejemplo de gráfico de consultas y métricas.

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

  • Nota

    Para empezar con una consulta de servicio predefinida, consulte Exploración de un gráfico de métricas por defecto.

    En estos pasos se muestra cómo crear una consulta en la página Explorador de métricas, en modo básico. Para crear una consulta en modo avanzado (MQL), consulte Edición de la expresión MQL para una consulta.

    1. Abra el menú de navegación y seleccione Observación y gestión. En Supervisión, seleccione Explorador de métricas.
      La página Explorador de métricas muestra un gráfico vacío con campos para crear una consulta.
    2. En la barra de navegación, seleccione la región que contiene los datos de métrica que desea.
      Para obtener más información sobre las regiones, consulte Comprensión de las regiones y Trabajar en regiones.
    3. En la consulta debajo del gráfico, seleccione el compartimento que contiene la métrica que desea.
    4. Seleccione el espacio de nombres de métrica que contiene la métrica que desee.
      Nota

      La lista Espacio de nombres de métrica muestra espacios de nombres de métricas para el compartimento seleccionado. Por ejemplo, si el compartimento actual contiene equilibradores de carga, la lista incluye oci_lbaas.
    5. Seleccione el nombre de la métrica.
    6. Actualice el intervalo o la estadística según sea necesario.
    7. (Opcional) Para seleccionar dimensiones, proporcione valores para los siguientes campos:
      • Nombre de dimensión: cualificador especificado en la definición de métrica. Por ejemplo, la dimensión resourceId se especifica en la definición de métrica para CpuUtilization.
      • Valor de la dimensión: valor que desea utilizar para la dimensión especificada, por ejemplo, el identificador de recurso para una instancia.
      • Dimensión Adicional: agrega otro par nombre-valor para una dimensión.
    8. (Opcional) Para agregar flujos de métricas, seleccione Agregar flujos de métricas.
    9. Seleccione Actualizar gráfico.
      En el gráfico se muestran puntos de datos para la métrica personalizada, en una vista de gráfico. Ejemplo:Flujos de métricas y valores en un gráfico.
    10. (Opcional) Para cambiar a una vista de tabla, seleccione Mostrar Tabla de Datos.
      En el gráfico se muestran puntos de datos para la métrica personalizada, en una vista de tabla.

    Para obtener información sobre la edición directa del lenguaje MQL o el cambio de consultas mediante la CLI o API, consulte Edición de la expresión MQL para una consulta.

  • Utilice el comando oci monitoring metric-data summarize-metrics-data y los parámetros necesarios para consultar datos de métricas:

    oci monitoring metric-data summarize-metrics-data [OPTIONS]

    Al especificar un valor de dimensión en la consulta (--query-text), guárdelo con comillas dobles y escape cada comilla doble con un carácter de barra invertida (\). Ejemplo:

    oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace oci_computeagent --query-text "CpuUtilization[1m]{resourceId = \"<instance_OCID>\"}.max()"

    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.