Builder query
Utilizzando il Query Builder, è possibile creare query per i widget dei cruscotti IBM® Cloud Logs personalizzati senza dover conoscere la sintassi di DataPrime, Lucene o PromQL.
Quando si definisce il widget, si può scegliere se utilizzare la modalità Builder o Query.
Query basate sulle metriche
Quando si costruisce un widget che utilizza le metriche, selezionare la modalità Costruttore e poi Metriche come fonte.
Tipo di query
Per il tipo di query, selezionare una query istantanea o un intervallo. La query viene eseguita su un intervallo di tempo specifico, definito dal selezionatore di tempo del dashboard o dall'intervallo di tempo del widget.
-
La modalità di interrogazione istantanea visualizza il valore della metrica in un singolo momento, in particolare al timestamp finale dell'intervallo di tempo selezionato. La modalità di interrogazione istantanea è ideale per il monitoraggio in tempo reale e fornisce un'istantanea dei dati al momento della visualizzazione. È anche più performante, in quanto recupera solo il punto di dati più recente senza dover recuperare l'intero set di dati.
-
La modalità di interrogazione a intervalli recupera e aggrega i dati metrici per un periodo di tempo specifico. Restituisce tutti i punti di dati tra i timestamp di inizio e fine che corrispondono alla query. Al variare dell'intervallo di tempo, il sistema regola automaticamente l'intervallo per ottimizzare il numero di punti dati visualizzati nel grafico. La modalità di interrogazione a intervalli è più adatta per identificare le tendenze o valutare le prestazioni in un periodo definito.
Nome metrica
Scegliere la metrica preferita dal menu a discesa che si riempie dinamicamente con le metriche disponibili. È possibile utilizzare il completamento automatico per esplorare il nome della metrica, le etichette e i valori.
Filtri
Per aggiungere un filtro, fare clic su +. Scegliere un'etichetta di metrica e un valore associato per filtrare la metrica.
Selezionare l'operatore = o != dal menu a discesa per includere o escludere uno o più valori. Utilizzando gli operatori =~ o !~, è possibile inserire un'espressione RegEx.
Per aggiungere altre coppie etichetta-valore, fare clic sul simbolo + per aggiungere una riga.
Funzioni
Selezionando le metriche e le etichette si crea una query valida di Prometheus, ma è anche possibile creare query più complesse utilizzando le funzioni.
Per aggiungere una funzione, fare clic su +. Selezionare tra le funzioni aggregation, count e rollup.
Le funzioni di aggregazione calcolano un insieme di valori e restituiscono un singolo valore. Queste funzioni includono SUM(), AVG(), MIN(), MAX(), COUNT() e altre.
Dopo aver scelto la funzione, selezionare l'etichetta da aggregare nel menu a discesa o inserire il valore dell'etichetta.
| Aggregazione | Descrizione |
|---|---|
average |
Il valore medio di tutti i punti dati nell'intervallo di tempo selezionato. |
count |
Il numero totale di punti dati nell'intervallo di tempo selezionato. |
min |
Il valore più piccolo tra i punti dati nell'intervallo di tempo selezionato. |
max |
Il valore più grande tra i punti dati nell'intervallo di tempo selezionato. |
sum |
La somma di tutti i punti dati nell'intervallo di tempo selezionato. |
quantile |
La funzione quantile(phi, q) by (group_labels) è un aggregato che calcola phi-quantile per ogni gruppo di etichette all'interno della serie temporale restituita da q. Il valore di phi deve rientrare nell'intervallo [0...1]. Il quantile viene calcolato separatamente per ogni serie di punti con lo stesso timestamp. |
histogram_quantile |
La funzione histogram_quantile è una funzione di trasformazione che calcola phi-percentile in base ai bucket dell'istogramma forniti. Il valore di phi deve essere compreso tra [0...1].
Ad esempio, histogram_quantile(0.5, sum(rate(http_request_duration_seconds_bucket[5m])) by (le)) restituisce la durata mediana della richiesta per tutte le richieste degli ultimi 5 minuti. |
Le funzioni di conteggio eseguono calcoli su un insieme di valori e restituiscono un singolo valore. Queste funzioni includono Count(), Absent(), Absent over time(), Present over time(),
Changes(), Resets() e altre.
| Conteggio | Descrizione |
|---|---|
count |
Il numero totale di punti dati nell'intervallo di tempo selezionato. |
absent |
Restituisce 1 se la serie temporale non ha punti. Altrimenti, restituisce un risultato vuoto. |
absent over time |
Restituisce 1 se l'intervallo di tempo fornito non contiene campioni grezzi. |
present over time |
Restituisce 1 se esiste almeno un singolo campione grezzo nell'intervallo di tempo fornito. |
changes |
Il numero di volte in cui il valore della serie temporale è cambiato all'interno dell'intervallo di tempo fornito. |
resets |
Il numero di azzeramenti del contatore nell'intervallo di tempo indicato. |
Una funzione di rollup si riferisce a funzioni che aggregano i dati delle serie temporali su un intervallo di tempo specificato. Queste funzioni calcolano metriche come average (avg_over_time), sum (sum_over_time),
minimum (min_over_time), maximum (max_over_time), count (count_over_time) e quantiles (quantile_over_time) su una finestra temporale. Vengono utilizzati per riassumere e analizzare i dati
metrici.
| Rollup | Descrizione |
|---|---|
average over time |
Calcola la media dei valori delle serie temporali su un intervallo di tempo. |
max over time |
Trova il valore massimo dei dati della serie temporale in un intervallo di tempo. |
min over time |
Determina il valore minimo dei dati della serie temporale in un intervallo di tempo. |
sum over time |
Calcola la somma dei valori delle serie temporali in un intervallo di tempo. |
count over time |
Conta il numero di elementi non NaN nella serie temporale in un intervallo di tempo. |
quantile over time |
Calcola il quantile specificato dei dati delle serie temporali su un intervallo di tempo. |
Dopo aver scelto la funzione, selezionare l'intervallo da interrogare come numero o ${__range}. ${__range} rappresenta la durata dell'intervallo di tempo del cruscotto. Viene reso come una stringa di intervallo supportata
da PromQL. Ad esempio, se si seleziona un intervallo di tempo da 13.00 a 14.30, la variabile ${__range} viene resa come 90m.
Con le funzioni di rango è possibile ordinare, classificare e filtrare i dati all'interno delle query. È possibile utilizzarli per affinare i risultati in base a metriche e valori specifici.
Per aggiungere una funzione di rango, fare clic su + e scegliere tra TOPK, SORT, o SORT Descending. Dopo aver selezionato una funzione di rango, configurarla specificando la metrica e
i parametri (ad esempio, inserire il numero di risultati di K che si desidera che la query recuperi per TOPK).
| Rank | Descrizione |
|---|---|
TOPK |
Recupera i risultati più alti di K da un set di dati in base a una metrica specificata. Utilizzate TOPK per mostrare i punti di maggiore importanza. |
SORT |
Ordina i dati in ordine crescente in base alla metrica selezionata. Utilizzare SORT per organizzare i dati dal valore più piccolo a quello più grande. |
SORT Descending |
Ordina i dati in ordine decrescente in base alla metrica selezionata. Utilizzare SORT Descending per dare priorità ai valori più grandi all'inizio del set di risultati. |
Query basate su log
Con il Query Builder basato sui log, è possibile creare query complesse creando query basate su Lucene e aggiungendo poi filtri e funzioni.
Quando si costruisce un widget che utilizza i registri, selezionare la modalità Costruttore e poi Registri come fonte.
È inoltre necessario scegliere se interrogare i registri nella pipeline di dati Insight priorità o Analizza e avvisa.
Filtri
Per aggiungere un filtro, fare clic su +. Scegliere un'etichetta e un valore associato.
Selezionare l'operatore = o != dal menu a discesa per includere o escludere uno o più valori. Utilizzando gli operatori =~ o !~, è possibile inserire un'espressione RegEx.
Per aggiungere altre coppie etichetta-valore, fare clic su +.
Funzioni
Per aggiungere una funzione, fare clic su +. Selezionare un valore aggregato utilizzando una funzione.
| Funzione | Descrizione |
|---|---|
Count |
Il numero totale di punti dati nell'intervallo di tempo selezionato. |
Count Distinct |
Il numero di punti dati unici nell'intervallo di tempo selezionato. |
Sum |
La somma di tutti i punti dati nell'intervallo di tempo selezionato. |
Min |
Il valore più piccolo tra i punti dati nell'intervallo di tempo selezionato. |
Max |
Il valore più grande tra i punti dati nell'intervallo di tempo selezionato. |
Average |
Il valore medio di tutti i punti dati nell'intervallo di tempo selezionato. |
Percentile XX |
Rappresenta il valore in cui cade meno di XX% dei punti dati. Ad esempio, Percentile 95 è il valore in cui cadono meno di 95% dei punti dati. |
Con Raggruppa per è possibile raggruppare i risultati delle query in base a uno o più campi.
DataPrime interrogazioni
È possibile creare una query DataPrime come base per il widget.
È necessario scegliere se interrogare i registri nella pipeline di dati Insight priorità o Analizza e avvisa.
Quando si crea una query basata sui dati di log, è possibile convertire la query nel linguaggio sintattico DataPrime facendo clic su Converti in DataPrime nel Query Builder.
Una volta convertita, la query trasformata viene visualizzata nella scheda DataPrime nel Query Builder.
Se si cambiano le fonti di dati o si converte la query in DataPrime,, i parametri originali della query nel Query Builder andranno persi. Il salvataggio del widget conserva lo stato più recente del widget.
Tempo del widget
Il selezionatore temporale del dashboard imposta l'intervallo di tempo predefinito per la query. Per personalizzare l'intervallo di tempo del widget che si sta configurando, fare clic su Tempo del widget e disattivare la levetta per scollegarlo dall'intervallo di tempo della dashboard. È quindi possibile scegliere un intervallo di tempo standard o personalizzato, specifico per il widget che si sta configurando.