Specifica di un predicato in una query

Specificare un predicato per l'esecuzione di query sui dati delle metriche in Monitoraggio.

Sebbene in genere venga utilizzato con gli allarmi, è anche possibile utilizzare i predicati nelle query per i grafici delle metriche personalizzati.

Per gli operatori predicato validi nelle espressioni MQL, vedere Operatori predicato.

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

Esempi
Esempio 1: maggiore dell'80% per l'utilizzo medio della CPU
CpuUtilization[1m].mean() > 80
Esempio 2: tra il 60 e l'80% per l'utilizzo medio della CPU
CpuUtilization[1m].mean() in (60, 80)
Esempio 3: maggiore di 1 per gli errori
ServiceConnectorHubErrors[1m].count() > 1
Esempio 4: maggiore di 85 per l'utilizzo della CPU al 90° percentile (selezione di un dominio di disponibilità e raggruppamento per pool)
CpuUtilization[1m]{availabilityDomain = "VeBZ:PHX-AD-1"}.groupBy(poolId).percentile(0.9) > 85
Esempio 5: almeno 20 per l'utilizzo minimo della CPU (selezionando "ol8" o "ol7")
CpuUtilization[1m]{resourceDisplayName =~ "ol8|ol7"}.min() >= 20
Esempio 6: almeno 30 per l'utilizzo minimo della CPU (selezione dei nomi delle istanze che iniziano con "instance-2023-")
CpuUtilization[1m]{resourceDisplayName =~ "instance-2023-*"}.min() >= 30
Esempio 7: assenza di metriche di utilizzo della CPU per la risorsa specificata, impostata su 20 ore per il periodo di rilevamento delle assenze
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20)
Descrizione absent(): restituisce true (1) se la metrica è assente per l'intero intervallo. Restituisce false (0) se la metrica è presente durante l'intervallo. Viene ignorato dopo il periodo di rilevamento dell'assenza, senza generare alcun valore.
  • In questa sezione viene descritto come specificare un predicato in una query nella pagina Esplora metriche. In questa pagina, i predicati sono disponibili solo in modalità avanzata (MQL). Per le modifiche alle query di allarme, vedere Creazione di un allarme di base.

    1. Creare una query di base nella pagina Explorer metriche.
    2. Se la query non è aperta, aprirla selezionando Modifica query.
    3. Selezionare Modalità avanzata.
    4. Modificare il testo nella casella Editor di codici query.
      Esempio 1: Predicato soglia
      > 80 è il predicato soglia nell'espressione MQL seguente.
      CpuUtilization[1m].mean() > 80
      Il grafico di Query di esempio e grafico di metriche ora mostra un singolo valore. Il valore dell'85% viene risolto in true (1) per indicare che soddisfa l'espressione MQL. Se nessun valore supera 80, il grafico nella pagina Esplorazione metriche mostra "nessun dato".
      Soglia in un grafico, pagina Esplora metriche.
      Esempio 2: predicato assenza
      absent() è il predicato assenza nell'espressione MQL seguente.
      CpuUtilization[1m].absent()
      Il grafico di Query di esempio e grafico di metriche ora mostra un valore "1" per un flusso di metriche. Il valore "1" nel grafico indica che l'istanza di computazione corrispondente a questo flusso di metriche non ha emesso i dati delle metriche CpuUtilization fino alle 1:30.
      Dati delle metriche assenti in un grafico, pagina Explorer metriche.

      Per gli operatori predicato validi nelle espressioni MQL, vedere Operatori predicato.

    5. Selezionare Aggiorna grafico.
  • Utilizzare il comando oci monitoring Metric-data riepilogate-metrics-data e i parametri necessari per eseguire la query sui dati delle metriche. Utilizzare il parametro --query-text per specificare un predicato (parte dell'espressione MQL).

    oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

    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. Utilizzare l'attributo query per specificare un predicato (parte dell'espressione MQL). Per un esempio, vedere SummarizeMetricsDataDetails.