Creación de una consulta para una métrica personalizada

• Consola
• CLI
• API

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

  1. Crear una consulta básica en la página Explorador de métricas.
  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 del gráfico, seleccione el compartimento que contiene la métrica personalizada que desea.
  4. Seleccione el espacio de nombres de métricas que contiene la métrica personalizada que desea.
     Ejemplo: mymetricsnamespace
  5. (Opcional) Seleccione el grupo de recursos que desea.
     Ejemplo: divisionX
  6. Seleccione el nombre de la métrica personalizada.
     Ejemplo: productOrder
  7. (Opcional) Actualice el intervalo o la estadística.
     Ejemplo: seleccione 1 minuto para Intervalo y seleccione Suma para Estadística.
  8. Para ver y actualizar la expresión MQL, seleccione Modo avanzado.

     La expresión MQL está en el cuadro Editor de códigos de consulta. Ejemplo:

     productOrder[1m].sum()
  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:
  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.

• 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 --compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression>

  En el siguiente ejemplo se utiliza el parámetro --from-json para recuperar información de métricas personalizadas de un archivo JSON.

  oci monitoring metric-data summarize-metrics-data --from-json file://./get-metrics.json [...]

  Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Command Line Reference for Monitoring.

  Archivo JSON de ejemplo para la solicitud

  Compare este archivo con el ejemplo de datos de métricas publicadas en Publicación de métricas personalizadas mediante la API.

  {
    "compartmentId": "$compartmentId",
    "endTime": "2023-01-08T20:00:00+00:00",
    "namespace": "mymetricsnamespace",
    "queryText": "productOrder[1m].sum()",
    "resolution": "5m",
    "resourceGroup": "divisionX",
    "startTime": "2023-01-07T23:00:00+00:00"
  }

  Respuesta de ejemplo

  Esta respuesta de ejemplo incluye puntos de datos solo para la división de grupo de recursos X (producto ball, país NL). La agregación utiliza un intervalo de un minuto, lo que genera tres registros de hora.

  Compare esta respuesta con el ejemplo de datos de métricas publicadas en Publicación de métricas personalizadas mediante la API.

  {
    "data": [
      {
        "aggregated-datapoints": [
          {
            "timestamp": "2023-01-08T09:20:00+00:00",
            "value": 100.0
          },
          {
            "timestamp": "2023-01-08T10:15:00+00:00",
            "value": 110.0
          },
          {
            "timestamp": "2023-01-08T10:25:00+00:00",
            "value": 30.0
          },
        "compartmentId": "$compartmentId",
        "dimensions": {
          "country": "NL",
          "product": "ball"
        },
        "metadata": {
          "category": "toys",
          "note": "national holiday"
        },
        "name": "productOrder",
        "namespace": "mymetricsnamespace",
        "resourceGroup": "divisionX"
      }
    ]
  }

• Ejecute la operación SummarizeMetricsData para consultar datos de métricas.