Creazione di una query per una metrica customizzata

Definire una query per una metrica personalizzata in Monitoraggio.

Per informazioni sulle metriche personalizzate, vedere Pubblicazione di metriche personalizzate mediante l'API. Per la risoluzione dei problemi delle query, vedere Risoluzione dei problemi delle query.

  • In questi passi viene illustrato come creare una query in modalità Base nella pagina Esplora metriche. Per creare una query in modalità avanzata (MQL), vedere Modifica dell'espressione MQL per una query.

    1. Creare una query di base nella pagina Explorer metriche.
    2. Nella barra di navigazione selezionare l'area che contiene i dati della metrica desiderati.
      Per ulteriori informazioni sulle aree, vedere Comprendere le aree e Utilizzo delle aree.
    3. Nella query sotto il grafico, selezionare il compartimento che contiene la metrica personalizzata desiderata.
    4. Selezionare lo spazio di nomi delle metriche contenente la metrica personalizzata desiderata.
      Esempio: mymetricsnamespace
    5. (Facoltativo) Selezionare il gruppo di risorse desiderato.
      Esempio: divisionX
    6. Selezionare il nome della metrica personalizzata.
      Esempio: productOrder
    7. (Facoltativo) Aggiornare l'intervallo o la statistica.
      Esempio: selezionare 1 minuto per Intervallo e selezionare Somma per Statistica.
    8. Per visualizzare e aggiornare l'espressione MQL, selezionare Modalità avanzata.

      L'espressione MQL si trova nella casella Editor codice query. Esempio:

      productOrder[1m].sum()
    9. Selezionare Aggiorna grafico.
      Il grafico mostra i datapoint per la metrica personalizzata in una vista Grafico. Esempio:Flussi di metriche e valori in un grafico.
    10. (Facoltativo) Per passare a una vista tabella, selezionare Mostra tabella dati.
      Il grafico mostra i datapoint per la metrica personalizzata, in una vista tabella.
  • Utilizzare il comando oci monitoring Metric-data riepilogate-metrics-data e i parametri necessari per eseguire la query sui dati delle metriche.

    oci monitoring metric-data summarize-metrics-data --compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression>

    Nell'esempio seguente viene utilizzato il parametro --from-json per recuperare le informazioni sulle metriche personalizzate da un file JSON.

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

    Per un elenco completo dei parametri e dei valori per i comandi CLI, consultare il manuale Command Line Reference for Monitoring.

    File JSON di esempio per la richiesta

    Confrontare questo file con l'esempio dei dati delle metriche pubblicati in Pubblicazione di metriche personalizzate mediante l'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"
    }
    Risposta di esempio

    Questa risposta di esempio include i datapoint solo per la divisione del gruppo di risorse X (prodotto ball, paese NL). L'aggregazione utilizza un intervallo di un minuto, con tre indicatori orari.

    Confrontare questa risposta con l'esempio dei dati delle metriche pubblicati in Pubblicazione di metriche personalizzate mediante l'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"
        }
      ]
    }
  • Eseguire l'operazione SummarizeMetricsData per eseguire una query sui dati delle metriche.