Creazione di una query per una metrica personalizzata

Definire una query per una metrica personalizzata in Monitoraggio.

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

Questi passi mostrano come creare una query in modalità Base nella pagina Explorer 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 desiderata.
  Per ulteriori informazioni sulle aree, vedere Comprendere le aree e Utilizzo tra le aree.
3. Nella query sotto il grafico, selezionare il compartimento contenente la metrica personalizzata desiderata.
4. Selezionare lo spazio di nomi delle metriche che contiene 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 di codici query. Ad esempio:
  productOrder[1m].sum()
9. Selezionare Aggiorna grafico.
  Il grafico mostra i datapoint per la metrica personalizzata in una vista Grafico. Ad esempio:
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 summary-metrics-data e i parametri necessari per eseguire 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 sulla metrica personalizzata 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, vedere Command Line Reference for Monitoring.

File JSON di esempio per la richiesta

Confrontare questo file con l'esempio di dati di metrica 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, che genera tre indicatori orari.

Confrontare questa risposta con l'esempio di dati di metrica 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.

Documentazione di Oracle Cloud Infrastructure

Creazione di una query per una metrica personalizzata