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 delle query 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 di 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 delle metriche, incluse le metriche inserite tramite Line Protocol (OTLP) e le metriche vendute arricchite. OpenTelemetry AWS Quando inserisci le metriche OTLP, CloudWatch preserva l'intera struttura semantica della tua 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 in base al nome della metrica e ai corrispondenti abbinamenti delle etichette.
Applica funzioni e operatori matematici a tutte le serie temporali.
Aggrega le metriche tra dimensioni quali 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 in base alla specifica Prometheus 3.0. Ciò include il supporto per i nomi delle UTF-8 metriche e dei 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 ed etichette della metrica forma una serie temporale distinta. |
Vettore istantaneo |
Un set di serie temporali contenente 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 ciascuna 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 meno serie. Gli operatori più 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 consentito per account. |
422 |
TPS massimo per le richieste di rilevamento per account |
10 |
Numero massimo di richieste di rilevamento (/series, /label, /label_values) al secondo consentito 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 attivamente eseguite contemporaneamente. |
429 |
Numero massimo di richieste di rilevamento simultanee per account |
30 |
Numero massimo di richieste di individuazione (/series, /labels, /label_values) che un account può avere in esecuzione attiva contemporaneamente. |
429 |
Numero massimo di serie restituite per richiesta di interrogazione |
500 |
Numero massimo di serie temporali uniche 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ò estendersi, 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 finestra di 24 ore di esecuzione della query. |
422 |
Numero massimo di campioni scansionati per finestra di 24 ore |
300.000.000 |
Numero massimo di campioni che possono essere scansionati per finestra di 24 ore di esecuzione della query. |
422 |
Numero massimo di campioni elaborati per finestra di 24 ore |
3.000.000.000 |
Numero massimo di campioni che possono essere elaborati per 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 dall'archivio. |
422 |
Supportata AWS Regioni
La tabella seguente elenca le AWS regioni in cui sono disponibili l'inserimento di metriche OTLP, l'interrogazione con ProMQL e Query Studio.
| Nome della Regione | Codice regione | Inserimento delle metriche OTLP | Query ProMQL | Query Studio |
|---|---|---|---|---|
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 necessarie entrambe le autorizzazioni. cloudwatch:GetMetricData cloudwatch:ListMetrics La tabella seguente elenca i percorsi degli endpoint delle Prometheus-compatible API e le relative azioni IAM richieste:
| Percorso dell'endpoint API | Metodi HTTP | Operazioni necessarie |
|---|---|---|
|
OTTIENI, PUBBLICA |
|
|
OTTIENI, PUBBLICA |
|
|
OTTIENI, PUBBLICA |
|
|
OTTIENI, PUBBLICA |
|
|
GET |
|
