Documentazione dell'infrastruttura Oracle Cloud

Creazione di una query

Definire una query per recuperare i dati dal monitoraggio.

Per un'interrogazione di esempio, vedere Grafico Query e metrica di esempio.

Per la risoluzione dei problemi delle query, vedere Risoluzione dei problemi delle query.

  • Nota

    Per iniziare con un'interrogazione di servizio predefinita, vedere Esplorazione di un grafico delle metriche predefinito.

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

    1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Monitoraggio, selezionare Metrics Explorer.
      Nella pagina Explorer metriche viene visualizzato un grafico vuoto con i campi per creare una query.
    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 desiderata.
    4. Selezionare lo spazio di nomi delle metriche contenente la metrica desiderata.
      Nota

      La lista Spazio di nomi delle metriche mostra gli spazi di nomi delle metriche per il compartimento selezionato. Ad esempio, se il compartimento corrente contiene load balancer, l'elenco include oci_lbaas.
    5. Selezionare il nome della metrica.
    6. Aggiornare l'intervallo o la statistica in base alle esigenze.
    7. (Facoltativo) Per selezionare le dimensioni, fornire i valori per i seguenti campi:
      • Nome dimensione: un qualificatore specificato nella definizione della metrica. Ad esempio, la dimensione resourceId è specificata nella definizione della metrica per CpuUtilization.
      • Valore dimensione: il valore che si desidera utilizzare per la dimensione specificata, ad esempio l'identificativo di risorsa per un'istanza.
      • Dimensione aggiuntiva: aggiunge un'altra coppia nome-valore per una dimensione.
    8. (Facoltativo) Per aggregare i flussi di metriche, selezionare Aggrega flussi di metriche.
    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.

    Per informazioni sulla modifica diretta delle espressioni MQL o sulla modifica delle query mediante l'interfaccia CLI o l'API, vedere Modifica dell'espressione MQL per una query.

  • 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 [OPTIONS]

    Quando si specifica un valore di dimensione all'interno della query (--query-text), racchiuderlo tra virgolette doppie ed eseguire l'escape di ogni virgoletta con un carattere barra rovesciata (\). Esempio:

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

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

  • Eseguire l'operazione SummarizeMetricsData per eseguire una query sui dati delle metriche.