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 **Topics** + [Cos'è Prometheus Query Language (PromQL)?](#CloudWatch-PromQL-WhatIs) + [Limiti e restrizioni di PromQL](#CloudWatch-PromQL-Limits) + [Regioni supportate AWS](#CloudWatch-PromQL-Regions) + [Autorizzazioni IAM per PromQL](#CloudWatch-PromQL-IAM) + [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md) + [Esecuzione di query ProMQL in Query Studio (anteprima)](CloudWatch-PromQL-QueryStudio.md) + [Utilizzo di ProMQL negli allarmi](CloudWatch-PromQL-Alarms.md) **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](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html) 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-PromQL-QueryStudio.md) CloudWatch Per ulteriori informazioni, consultare [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md) e [Utilizzo di ProMQL negli allarmi](CloudWatch-PromQL-Alarms.md). **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. `{"http.server.active_requests", "@resource.service.name"="myservice"}` | | **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. `avg_over_time({"http.server.active_requests", "@resource.service.name"="myservice"}[5m])` | | **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 (`=`), la corrispondenza non uguale (`!=`), la corrispondenza regolare (`=~`) e la corrispondenza regex negativa (). `!~` | | **Operatore di aggregazione** | Una funzione che combina più serie temporali in un numero inferiore di serie. Gli operatori comuni includono `sum``avg`,`min`,`max`,`count`, e`topk`. | ## 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\$1range) 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\$1values) al secondo consentite per account. | 422 | | Numero massimo di richieste di query simultanee per account | 30 | Numero massimo di query (/query, /query\$1range) 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\$1values) 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\$1range) 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\$1values) 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 | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | | ExecuteMetricQueryGet | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | | ExecuteMetricRangeQuery | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | | ExecuteMetricRangeQueryGet | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | | ExecuteMetricSeriesPost | `cloudwatch:ListMetrics` | | ExecuteMetricSeriesGet | `cloudwatch:ListMetrics` | | ExecuteMetricLabelsPost | `cloudwatch:ListMetrics` | | ExecuteMetricLabelsGet | `cloudwatch:ListMetrics` | | ExecuteMetricLabelValuesGet | `cloudwatch:ListMetrics` |