

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

**Topics**
+ [Cos'è Prometheus Query Language (ProMQL)?](#CloudWatch-PromQL-WhatIs)
+ [Limiti e restrizioni di ProMQL](#CloudWatch-PromQL-Limits)
+ [Supportata AWS Regioni](#CloudWatch-PromQL-Regions)
+ [Autorizzazioni IAM per ProMQL](#CloudWatch-PromQL-IAM)
+ [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md)
+ [Esecuzione di query ProMQL in Query Studio](CloudWatch-PromQL-QueryStudio.md)
+ [Utilizzo di ProMQL negli allarmi](CloudWatch-PromQL-Alarms.md)
+ [Prometheus-compatible API](CloudWatch-PromQL-APIs.md)

## Cos'è Prometheus Query Language (ProMQL)?
<a name="CloudWatch-PromQL-WhatIs"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html) 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-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 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. `{"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 ciascuna 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 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 (`=`), la corrispondenza non uguale (`!=`), la corrispondenza regex (`=~`) e la corrispondenza regex negativa (). `!~` | 
| **Operatore di aggregazione ** | Una funzione che combina più serie temporali in meno serie. Gli operatori più comuni includono `sum` `avg``min`,`max`,`count`, e`topk`. | 

## Limiti e restrizioni di ProMQL
<a name="CloudWatch-PromQL-Limits"></a>

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
<a name="CloudWatch-PromQL-Regions"></a>

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
<a name="CloudWatch-PromQL-IAM"></a>

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 | 
| --- | --- | --- | 
| `/api/v1/query` | OTTIENI, PUBBLICA | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | 
| `/api/v1/query_range` | OTTIENI, PUBBLICA | `cloudwatch:GetMetricData`, `cloudwatch:ListMetrics` | 
| `/api/v1/series` | OTTIENI, PUBBLICA | `cloudwatch:ListMetrics` | 
| `/api/v1/labels` | OTTIENI, PUBBLICA | `cloudwatch:ListMetrics` | 
| `/api/v1/label/{{label_name}}/values` | GET | `cloudwatch:ListMetrics` | 