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
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 metriche, tra cui le metriche inserite tramite OpenTelemetry Line Protocol (OTLP) e le metriche vendute arricchite.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 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 delle UTF-8 metriche e i nomi delle etichette.
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 OTLP-ingested metriche, 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ò avere in esecuzione attiva 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 |
Supportata AWS Regioni
La tabella seguente elenca le AWS regioni in cui sono disponibili l'inserimento delle 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 |
✓ |
✓ |
✓ |
Stati Uniti occidentali (California settentrionale) |
us-west-1 |
✓ |
✓ |
✓ |
Stati Uniti orientali (Ohio) |
us-east-2 |
✓ |
✓ |
✓ |
Europe (London) |
eu-west-2 |
✓ |
✓ |
✓ |
Europe (Paris) |
eu-west-3 |
✓ |
✓ |
✓ |
Europa (Francoforte) |
eu-central-1 |
✓ |
✓ |
✓ |
Europa (Stoccolma) |
eu-north-1 |
✓ |
✓ |
✓ |
Europe (Milan) |
eu-south-1 |
✓ |
✓ |
✓ |
Europa (Spagna) |
eu-south-2 |
✓ |
✓ |
✓ |
Europa (Zurigo) |
eu-central-2 |
✓ |
✓ |
✓ |
Asia Pacifico (Tokyo) |
ap-northeast-1 |
✓ |
✓ |
✓ |
Asia Pacifico (Seoul) |
ap-northeast-2 |
✓ |
✓ |
✓ |
Asia Pacifico (Osaka-Locale) |
ap-northeast-3 |
✓ |
✓ |
✓ |
Asia Pacifico (Mumbai) |
ap-south-1 |
✓ |
✓ |
✓ |
Asia Pacifico (Hyderabad) |
ap-south-2 |
✓ |
✓ |
✓ |
Asia Pacific (Hong Kong) |
ap-east-1 |
✓ |
✓ |
✓ |
Asia Pacifico (Taipei) |
ap-east-2 |
✓ |
✓ |
✓ |
Asia Pacifico (Giacarta) |
ap-southeast-3 |
✓ |
✓ |
✓ |
Asia Pacifico (Melbourne) |
ap-southeast-4 |
✓ |
✓ |
✓ |
Asia Pacifico (Malesia) |
ap-southeast-5 |
✓ |
✓ |
✓ |
Asia Pacifico (Auckland) |
ap-southeast-6 |
✓ |
✓ |
✓ |
Asia Pacifico (Thailandia) |
ap-southeast-7 |
✓ |
✓ |
✓ |
Sud America (San Paolo) |
sa-east-1 |
✓ |
✓ |
✓ |
Canada (Centrale) |
ca-central-1 |
✓ |
✓ |
✓ |
Canada occidentale (Calgary) |
ca-west-1 |
✓ |
✓ |
✓ |
Africa (Città del Capo) |
af-south-1 |
✓ |
✓ |
✓ |
Messico (Centrale) |
mx-central-1 |
✓ |
✓ |
✓ |
Autorizzazioni IAM per PromQL
Per eseguire le query PromQL, sono necessari entrambi i permessi. cloudwatch:GetMetricData cloudwatch:ListMetrics La tabella seguente elenca i percorsi degli endpoint dell' Prometheus-compatible API e le relative azioni IAM richieste:
| Percorso dell'endpoint dell'API | Metodi HTTP | Operazioni necessarie |
|---|---|---|
|
OTTIENI, PUBBLICA |
|
|
PRENDERE, POSTARE |
|
|
PRENDERE, POSTARE |
|
|
PRENDERE, POSTARE |
|
|
GET |
|
