Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Metriche di interrogazione con PromQL
Argomenti
Nota
L'inserimento delle metriche OTLP, l'interrogazione con PromQL, l' OTel arricchimento delle AWS metriche vendute e Query Studio sono disponibili in anteprima pubblica, sono gratuiti e soggetti a modifiche.
Cos'è Prometheus Query Language (PromQL)?
Prometheus Query Language (PromQL) è un linguaggio di interrogazione funzionale che consente di selezionare, aggregare e trasformare i dati delle serie temporali in tempo reale. PromQL è stato originariamente progettato per Prometheus ed è diventato un popolare linguaggio di interrogazione per le metriche.
Amazon CloudWatch supporta PromQL per l'interrogazione di parametri, inclusi i parametri acquisiti tramite OpenTelemetry Line Protocol (OTLP) e i parametri di vendita arricchiti.AWS Quando inserisci i parametri OTLP, CloudWatch conserva l'intera struttura semantica della telemetria, inclusi gli attributi delle risorse, l'ambito della strumentazione, gli attributi dei punti dati e i metadati specifici, e li espone come etichette PromQL interrogabili. AWS
Con PromQL puoi fare quanto segue:
Seleziona le serie temporali per nome della metrica e abbinatori di etichette.
Applica funzioni e operatori matematici su serie temporali.
Aggrega le metriche tra dimensioni come servizio, regione o account.
Calcola tassi, istogrammi, quantili e medie mobili.
È possibile utilizzare le query PromQL in modo interattivo e anche per creare allarmi. Esecuzione di query ProMQL in Query Studio (anteprima) CloudWatch Per ulteriori informazioni, consultare Interrogazione ProMQL e Utilizzo di ProMQL negli allarmi.
Nota
CloudWatch utilizza PromQL basato sulla specifica Prometheus 3.0. Ciò include il supporto per i nomi di metriche e i nomi delle etichette UTF-8.
I seguenti concetti sono fondamentali per lavorare con PromQL in. CloudWatch
| Concetto | Description |
|---|---|
Serie temporali |
Un flusso di valori con data e ora identificati da un nome di metrica e da un insieme di coppie chiave-valore denominate etichette. Ogni combinazione univoca di nome metrico ed etichette forma una serie temporale distinta. |
Vettore istantaneo |
Un insieme di serie temporali contenenti un singolo campione per ogni serie, tutte con lo stesso timestamp. Restituito da domande come. |
Vettore di intervallo |
Un insieme di serie temporali contenente un intervallo di punti dati nel tempo per ogni serie. Creato aggiungendo un selettore di durata temporale tra parentesi, ad esempio. |
Etichetta |
Una coppia chiave-valore associata a una serie temporale. Nelle metriche inserite da OTLP, le etichette derivano dagli attributi delle risorse, dall'ambito della strumentazione, dagli attributi dei punti dati e dai metadati specifici. AWS |
Label matcher |
Un'espressione tra parentesi graffe che filtra le serie temporali in base al valore dell'etichetta. Supporta la corrispondenza esatta ( |
Operatore di aggregazione |
Una funzione che combina più serie temporali in un numero inferiore di serie. Gli operatori comuni includono |
Limiti e restrizioni di PromQL
La tabella seguente elenca i limiti e le restrizioni per PromQL:
| Limite | Valore | Informazioni aggiuntive | Codice di errore |
|---|---|---|---|
TPS massimo per le richieste di query per account |
300 |
Numero massimo di richieste di query (/query, /query_range) al secondo consentite per account. |
422 |
Numero massimo di TPS per le richieste di rilevamento per account |
10 |
Numero massimo di richieste di rilevamento (/series, /label, /label_values) al secondo consentite per account. |
422 |
Numero massimo di richieste di query simultanee per account |
30 |
Numero massimo di query (/query, /query_range) che un account può eseguire attivamente contemporaneamente. |
429 |
Numero massimo di richieste di rilevamento simultanee per account |
30 |
Numero massimo di richieste di rilevamento (/series, /labels, /label_values) che un account può avere in esecuzione attiva contemporaneamente. |
429 |
Numero massimo di serie restituite per richiesta di query |
500 |
Numero massimo di serie temporali univoche che una richiesta di query (/query, /query_range) può restituire. |
200 - risposta troncata |
Numero massimo di etichette restituite per richiesta di rilevamento |
10.000 |
Numero massimo di etichette univoche che una richiesta di rilevamento (/series, /labels, /label_values) può restituire. |
200 - risposta troncata |
Intervallo massimo per richiesta |
7 giorni |
Intervallo di tempo massimo che una query può coprire, inclusi i parametri dell'intervallo e i periodi di lookback. |
422 |
Numero massimo di serie scansionate per finestra di 24 ore |
100.000 |
Numero massimo di serie temporali univoche che possono essere scansionate per ogni finestra di esecuzione della query di 24 ore. |
422 |
Numero massimo di campioni scansionati per finestra di 24 ore |
300.000.000 |
Numero massimo di campioni che possono essere scansionati per ogni finestra di esecuzione della query di 24 ore. |
422 |
Numero massimo di campioni elaborati per finestra di 24 ore |
3.000.000.000 |
Numero massimo di campioni che possono essere elaborati per ogni finestra di esecuzione della query di 24 ore. |
422 |
Execution timeout (Timeout di esecuzione) |
20 secondi |
Tempo massimo che il motore può dedicare alla valutazione di una query, escluso il tempo trascorso in coda e il recupero dei dati dallo storage. |
422 |
Regioni supportate AWS
La tabella seguente elenca le AWS regioni in cui sono disponibili l'inserimento di metriche OTLP, l'interrogazione PromQL e Query Studio.
| Nome della Regione | Codice regione | Inserimento di metriche OTLP | Query PromQL | Studio di interrogazione |
|---|---|---|---|---|
Stati Uniti orientali (Virginia settentrionale) |
us-east-1 |
✓ |
✓ |
✓ |
Stati Uniti occidentali (Oregon) |
us-west-2 |
✓ |
✓ |
✓ |
Europa (Irlanda) |
eu-west-1 |
✓ |
✓ |
✓ |
Asia Pacifico (Singapore) |
ap-southeast-1 |
✓ |
✓ |
✓ |
Asia Pacific (Sydney) |
ap-southeast-2 |
✓ |
✓ |
✓ |
Autorizzazioni IAM per PromQL
Per eseguire le query PromQL, sono necessari entrambi i permessi. cloudwatch:GetMetricData cloudwatch:ListMetrics La tabella seguente elenca le nuove operazioni dell'API PromQL e le relative azioni IAM richieste:
| Operazione API | Operazioni necessarie |
|---|---|
ExecuteMetricQueryPost |
|
ExecuteMetricQueryGet |
|
ExecuteMetricRangeQuery |
|
ExecuteMetricRangeQueryGet |
|
ExecuteMetricSeriesPost |
|
ExecuteMetricSeriesGet |
|
ExecuteMetricLabelsPost |
|
ExecuteMetricLabelsGet |
|
ExecuteMetricLabelValuesGet |
|
