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

• Consola
• CLI
• API

• Estos pasos muestran 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. Cree una consulta básica en la página Explorador de métricas.
  2. En la cabecera Consola, seleccione la región que contiene los datos de métrica que desea.
     Para obtener más información sobre las regiones, consulte Descripción de las regiones y Trabajar entre 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étrica 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, haga clic en Modo avanzado.

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

     productOrder[1m].sum()
  9. Haga clic en 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, haga clic en 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 Referencia de la línea de comandos para 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.