Utilizzo dell'origine dati Prometheus

Impostazioni Prometheus

Nome	Descrizione
Name	Il nome della fonte di dati. Ecco come viene visualizzata la fonte di dati nei pannelli e nelle query.
Default	L'origine dati predefinita significa che sarà preselezionata per i nuovi pannelli.
Url	L'URL del server Prometheus, ad esempio. https://prometheus.example.org:9090
Access	Server (impostazione predefinita) = L'URL deve essere accessibile dal backend/server Grafana.
Basic Auth	Abilita l'autenticazione di base per l'origine dati Prometheus.
User	Nome utente per l'autenticazione di base.
Password	Password per l'autenticazione di base.
Scrape interval	Impostalo sul tipico intervallo di scrape e valutazione configurato in Prometheus. Il valore predefinito è 15 secondi.
Disable metrics lookup	La selezione di questa opzione disabiliterà il selettore delle metriche e il supporto per metrice/etichette nel completamento automatico del campo di query. Ciò è utile in caso di problemi di prestazioni con istanze Prometheus più grandi.
Custom Query Parameters	Aggiungi parametri personalizzati all'URL della query Prometheus. Ad esempiotimeout,partial_response, dedup o. max_source_resolution Più parametri devono essere concatenati insieme a un «&».

Editor di query Prometheus

Le seguenti sezioni forniscono informazioni e opzioni per l'editor di query Prometheus nella dashboard e in Esplora.

Editor di query nelle dashboard

Apri un grafico in modalità di modifica scegliendo il titolo e quindi scegliendo Modifica (o premendo il tasto e mentre sei in pausa sul pannello).

Nome	Descrizione
Query expression	Per ulteriori informazioni sulle espressioni di interrogazione di Prometheus, vedere la documentazione di Prometheus.
Legend format	Controlla il nome della serie temporale, utilizzando il nome o lo schema. Ad esempio {{hostname}} viene sostituito dal valore dell'etichettahostname.
Min step	Un limite inferiore aggiuntivo per il stepparametro delle query di intervallo Prometheus e per le variabili and. $__interval $__rate_interval Il limite è assoluto e non viene modificato dall'impostazione della risoluzione.
Resolution	1/1imposta sia la $__interval variabile che il stepparametro delle query di intervallo di Prometheus in modo che ogni pixel corrisponda a un punto dati. Per prestazioni migliori, utilizza risoluzioni più basse. 1/2recupera solo un punto dati per ogni altro pixel e 1/10 recupera un punto dati ogni 10 pixel. Nota che sia Min time Interval che Min step limitano il valore finale di and. $__interval step
Metric lookup	Cerca i nomi delle metriche in questo campo di immissione.
Format as	Passa tra TableTime series, oHeatmap. Tablefunziona solo nel pannello della tabella. Heatmapè adatto per visualizzare metriche del tipo di istogramma su un pannello heatmap. Converte gli istogrammi cumulativi in istogrammi regolari e ordina le serie in base al limite del bucket.
Instant	Esegui una query «istantanea», per restituire solo l'ultimo valore che Prometheus ha recuperato per la serie temporale richiesta. Le interrogazioni istantanee restituiscono risultati molto più velocemente delle normali interrogazioni con intervallo. Usali per cercare set di etichette.
Min time interval	Questo valore moltiplicato per il denominatore dell'impostazione Risoluzione imposta un limite inferiore sia per la $__interval variabile che per il stepparametro delle interrogazioni sull'intervallo di Prometheus. Il valore predefinito è Scrape interval come impostato nelle opzioni dell'origine dati.

Nota

Amazon Managed Grafana modifica le date delle richieste per le query per allinearle alla fase calcolata dinamicamente. Ciò garantisce una visualizzazione coerente dei dati delle metriche, ma può causare una piccola lacuna di dati sul bordo destro di un grafico.

Interrogazioni istantanee nelle dashboard

L'origine dati Prometheus consente di eseguire query istantanee, che interrogano solo il valore più recente. Puoi visualizzare i risultati in un pannello tabellare per vedere tutte le etichette disponibili di una serie temporale.

I risultati delle query istantanee sono costituiti da un solo punto dati per serie. Possono essere visualizzati nel pannello grafico con l'aiuto delle sostituzioni delle serie. Per mostrarle nel grafico come valore più recente, aggiungete una serie di override e selezionate. Points > true Per mostrare una linea orizzontale sull'intero grafico, aggiungi una sovrascrittura di serie e seleziona Transform > constant Per ulteriori informazioni sulle sostituzioni di serie, vedi. Sostituzioni delle serie

Editor di query in Explore

Nome	Descrizione
Query expression	Per ulteriori informazioni sull'espressione di interrogazione di Prometheus, vedere la documentazione di Prometheus.
Step	Stepparametro delle interrogazioni della gamma Prometheus. Le unità di tempo possono essere utilizzate qui, ad esempio: 5s, 1m, 3h, 1d, 1y. L'unità predefinita se nessuna unità specificata è (secondi). s
Query type	Range, Instant, oppure Both. Quando si esegue la query Range, il risultato dell'interrogazione viene visualizzato in un grafico e in una tabella. La query istantanea restituisce solo il valore più recente che Prometheus ha analizzato per la serie temporale richiesta e viene visualizzato nella tabella. Quando è selezionato Both, vengono eseguite sia la query istantanea che la query con intervallo. Il risultato della query con intervallo viene visualizzato nel grafico e il risultato della query istantanea viene visualizzato nella tabella.

Browser delle metriche

Il browser delle metriche consente di trovare rapidamente le metriche e selezionare le etichette pertinenti per creare query di base. Quando apri il browser, vedrai tutte le metriche e le etichette disponibili. Se supportata dall'istanza Prometheus, ogni metrica mostrerà i relativi HELP e TYPE come tooltip.

Quando selezioni una metrica, il browser restringe le etichette disponibili per mostrare solo quelle applicabili alla metrica. È quindi possibile selezionare una o più etichette per le quali i valori delle etichette disponibili sono mostrati negli elenchi nella sezione inferiore. Seleziona uno o più valori per ogni etichetta per restringere l'ambito della ricerca.

Nota

Se non ricordi il nome di una metrica con cui iniziare, puoi anche selezionare prima alcune etichette per restringere l'elenco e quindi trovare i valori delle etichette pertinenti.

Tutti gli elenchi nel browser delle metriche hanno un campo di ricerca sopra di essi per filtrare rapidamente le metriche o le etichette che corrispondono a una determinata stringa. La sezione dei valori ha un solo campo di ricerca. Il suo filtro si applica a tutte le etichette per aiutarti a trovare i valori tra le etichette una volta selezionate, ad esempio, tra le tue etichette app, job, job_name solo una potrebbe avere il valore che stai cercando.

Quando sei soddisfatto della tua richiesta, fai clic su «Usa query» per eseguirla. Il pulsante Use as rate Query aggiunge una tariffa (...) [$__interval] attorno alla tua query per aiutarti a scrivere query per le metriche dei contatori. Il pulsante «Convalida selettore» verificherà con Prometheus quante serie temporali sono disponibili per quel selettore.

Limitazioni

Il browser delle metriche ha un limite rigido di 10.000 etichette (chiavi) e 50.000 valori di etichette (inclusi i nomi delle metriche). Se l'istanza Prometheus restituisce più risultati, il browser continuerà a funzionare. Tuttavia, i set di risultati verranno limitati al di sopra di tali limiti massimi.

Modellazione

Invece di inserire elementi come il nome del server, dell'applicazione e del sensore nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come caselle di selezione a discesa nella parte superiore della dashboard. Puoi utilizzare queste caselle a discesa per modificare i dati visualizzati nella dashboard.

Per ulteriori informazioni sui modelli e sulle variabili dei modelli, consulta. Modelli e variabili

Variabile di interrogazione

La variabile di tipo Query consente di interrogare Prometheus per un elenco di metriche, etichette o valori di etichetta. Il plug-in di origine dati Prometheus fornisce le seguenti funzioni che è possibile utilizzare nel campo di immissione Query.

Nome	Descrizione
label_names()	Restituisce un elenco di nomi di etichette.
label_values(label)	Restituisce un elenco di valori di etichetta per ogni metrica. label
label_values(metric, label)	Restituisce un elenco di valori di etichetta per la label metrica specificata.
metrics(metric)	Restituisce un elenco di metriche che corrispondono all'espressione regolare specificatametric.
query_result(query)	Restituisce un elenco dei risultati della query Prometheus per. query

Per informazioni su cosa sono i nomi delle metriche, i nomi delle etichette e i valori delle etichette, consulta la documentazione di Prometheus.

Utilizzo delle variabili di intervallo e intervallo

Nota

Supporta e $__range_ms sono disponibili solo da Grafana v5.3. $__range $__range_s

È possibile utilizzare alcune variabili globali nelle variabili di query:$__interval,, $__interval_ms$__range, $__range_s e. $__range_ms Per ulteriori informazioni, consulta Variabili globali. Queste possono essere comode da usare con la query_result funzione quando è necessario filtrare le interrogazioni con variabili perché la label_values funzione non supporta le query.

Per ottenere le istanze corrette quando si modifica l'intervallo di tempo sulla dashboard, assicurati di impostare il refresh trigger della variabile su. On Time Range Change

Il seguente esempio di codice mostra come compilare una variabile con le cinque istanze di richiesta più trafficate in base al QPS medio nell'intervallo di tempo mostrato nella dashboard.

Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/

Il seguente esempio di codice mostra come popolare una variabile con le istanze che hanno un determinato stato nell'intervallo di tempo mostrato nella dashboard, utilizzando. $__range_s

Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Regex:

Utilizzo di una variabile $__rate_interval

La $__rate_interval variabile è pensata per essere utilizzata nella funzione rate. È definita come max ($__interval+ intervallo di raschiatura, 4 * intervallo di raschiatura). Scrape interval è l'impostazione Min step (alias query_interval, un'impostazione per una query PromQL), se impostata, altrimenti l'intervallo Scrape impostato nell'origine dati Prometheus (ma ignora qualsiasi impostazione dell'intervallo minimo nel pannello, poiché quest'ultima viene modificata dall'impostazione della risoluzione).

Utilizzo di variabili nelle query

Esistono due sintassi:

• $<varname>Esempio: rate (http_requests_total {job=~"$job "} [5m])

• [[varname]]Esempio: rate (http_requests_total {job=~ "[[job]]"} [5m])

Perché due modi? La prima sintassi è più facile da leggere e scrivere ma non consente di utilizzare una variabile al centro di una parola. Quando le opzioni Multivalore o Includi tutti i valori sono abilitate, Grafana converte le etichette da testo semplice a una stringa compatibile con espressioni regolari. Il che significa che devi usare invece di. =~ =

Annotazioni

È possibile utilizzare le annotazioni per sovrapporre informazioni dettagliate sugli eventi ai grafici. È possibile aggiungere interrogazioni di annotazione utilizzando il menu Dashboard o la vista Annotazioni. Per ulteriori informazioni, consulta Annotazioni.

Prometheus supporta due modi per interrogare le annotazioni.

• Una normale interrogazione metrica

• Una richiesta di Prometheus per avvisi in sospeso e di attivazione. Per ulteriori informazioni, vedere Ispezione degli avvisi durante l'esecuzione).

L'opzione step è utile per limitare il numero di eventi restituiti dalla query.