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à.
# Monitora le metriche delle query di Athena con CloudWatch
Athena pubblica le metriche relative alle query su CloudWatch Amazon, quando è selezionata [l'opzione Pubblica metriche di query](athena-cloudwatch-metrics-enable.md) su. CloudWatch Puoi creare dashboard personalizzate, impostare allarmi e trigger sulle metriche o utilizzare dashboard precompilate CloudWatch direttamente dalla console Athena.
Quando si abilitano i parametri di query per le query nei gruppi di lavoro, i parametri vengono visualizzati nella tab **Parametri** del pannello **Gruppi di lavoro** per ogni gruppo di lavoro nella console Athena.
Athena pubblica le seguenti metriche sulla console: CloudWatch
+ `DPUAllocated`— Il numero totale di DPUs (unità di elaborazione dati) fornite in una riserva di capacità per eseguire le query.
+ `DPUConsumed`— Il numero di persone DPUs utilizzate attivamente dalle interrogazioni in `RUNNING` uno stato in un determinato momento di una prenotazione. Parametro emesso solo quando il gruppo di lavoro è associato a una prenotazione della capacità e include tutti i gruppi di lavoro associati a una prenotazione.
+ `DPUCount`— Il numero massimo di dati DPUs consumati dalla tua query, pubblicato esattamente una volta completata la query.
+ `EngineExecutionTime`: il numero di millisecondi necessari per l'esecuzione della query.
+ `ProcessedBytes`: il numero di byte scansionati da Athena per query DML.
+ `QueryPlanningTime`: il numero di millisecondi richiesti da Athena per pianificare il flusso di elaborazione delle query.
+ `QueryQueueTime`: il numero di millisecondi di permanenza della query nella coda di query in attesa delle risorse.
+ `ServicePreProcessingTime`: il numero di millisecondi richiesti da Athena per pre-elaborare la query prima di inviarla al motore di query.
+ `ServiceProcessingTime`: il numero di millisecondi richiesti da Athena per elaborare i risultati della query dopo che il motore di query ha terminato l'esecuzione della query.
+ `TotalExecutionTime`: il numero di millisecondi richiesti da Athena per eseguire una query DDL o DML.
Per le descrizioni più complete, consulta [Elenco di CloudWatch metriche e dimensioni per Athena](#athena-cloudwatch-metrics-table) più avanti in questo documento.
Questi parametri hanno le seguenti dimensioni:
+ `CapacityReservation`: il nome della prenotazione della capacità utilizzata per eseguire la query, se applicabile.
+ `QueryState` - `SUCCEEDED`, `FAILED` o `CANCELED`
+ `QueryType` - `DML`, `DDL` o `UTILITY`
+ `WorkGroup` – nome del gruppo di lavoro
Athena pubblica la seguente metrica sulla CloudWatch console nel namespace: `AmazonAthenaForApacheSpark`
+ `DPUCount`— numero di dati DPUs consumati durante la sessione per eseguire i calcoli.
Questo parametro possiede le seguenti dimensioni:
+ `SessionId`: l'ID della sessione in cui vengono inviati i calcoli.
+ `WorkGroup`: il nome del gruppo di lavoro.
Per ulteriori informazioni, consulta [Elenco di CloudWatch metriche e dimensioni per Athena](#athena-cloudwatch-metrics-table) più avanti in questo argomento. Per ulteriori informazioni sui parametri di utilizzo di Athena, consulta [Monitora le metriche di utilizzo di Athena con CloudWatch](monitoring-athena-usage-metrics.md).
Puoi visualizzare le metriche delle query nella console Athena o nella CloudWatch console.
## Visualizzazione dei parametri delle query nella console Athena
**Per visualizzare i parametri delle query per un gruppo di lavoro nella console Athena**
1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.
![\[Scegli il menu di espansione.\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/nav-pane-expansion.png)
1. Nel pannello di navigazione, seleziona **Workgroups** (Gruppi di lavoro).
1. Scegli il gruppo di lavoro desiderato dall'elenco, quindi seleziona la scheda **Metrics** (Parametri).
Viene visualizzato il pannello di controllo dei parametri.
**Nota**
Se di recente hai abilitato le metriche per il gruppo di lavoro, non and/or c'è stata alcuna attività di interrogazione recente, i grafici sulla dashboard potrebbero essere vuoti. L'attività di interrogazione viene recuperata in CloudWatch base all'intervallo specificato nel passaggio successivo.
1. Nella sezione **Metriche**, scegli l'intervallo di metriche che Athena deve utilizzare per recuperare le metriche della query o specifica un intervallo personalizzato. CloudWatch
![\[Specifica dell'intervallo di recupero dei parametri per un gruppo di lavoro nella console Athena.\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/wg-custom-interval.png)
1. Per aggiornare i parametri visualizzati, scegliere l'icona di aggiornamento.
![\[Scelta dell'icona di aggiornamento.\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/wg-refresh-metrics.png)
1. Fai clic sulla freccia accanto all'icona di aggiornamento per scegliere la frequenza di aggiornamento per la visualizzazione dei parametri.
![\[Scelta di un intervallo di aggiornamento per i parametri del gruppo di lavoro visualizzati nella console Athena.\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/wg-choose-refresh-interval.png)
## Visualizza CloudWatch le metriche delle query nella console
**Per visualizzare le metriche nella console Amazon CloudWatch**
1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Nel pannello di navigazione, seleziona **Metrics** (Parametri), **All metrics** (Tutti i parametri).
1. Seleziona lo spazio dei nomi **AWS/Athena**.
## Visualizza le metriche delle query con AWS CLI
**Per visualizzare le metriche con AWS CLI**
+ Esegui una delle seguenti operazioni:
+ Per elencare i parametri per Athena, apri un prompt dei comandi e usa il comando seguente:
```
aws cloudwatch list-metrics --namespace "AWS/Athena"
```
+ Per visualizzare un elenco di tutti i parametri disponibili, usare il comando seguente:
```
aws cloudwatch list-metrics"
```
## Elenco di CloudWatch metriche e dimensioni per Athena
Se hai abilitato le CloudWatch metriche in Athena, invia le seguenti metriche CloudWatch a ciascun gruppo di lavoro. I parametri seguenti utilizzano lo spazio dei nomi `AWS/Athena`.
| Nome parametro | Description |
| --- | --- |
| DPUAllocated | Il numero totale di DPUs (unità di elaborazione dati) fornite in una riserva di capacità per eseguire le query. |
| DPUConsumed | Il numero di persone DPUs utilizzate attivamente dalle query in RUNNING uno stato in un determinato momento di una prenotazione. Questo parametro viene emesso solo quando il gruppo di lavoro è associato a una prenotazione della capacità e include tutti i gruppi di lavoro associati a una prenotazione. Se sposti un gruppo di lavoro da una prenotazione all'altra, il parametro include i dati del momento in cui il gruppo di lavoro apparteneva alla prima prenotazione. Per informazioni delle prenotazioni della capacità, consulta [Gestisci la capacità di elaborazione delle query](capacity-management.md). |
| DPUCount | Il numero massimo di dati DPUs consumati dalla query, pubblicato esattamente una volta al termine della query. Questo parametro viene emesso solo per i gruppi di lavoro collegati a una prenotazione della capacità. |
| EngineExecutionTime | Il numero di millisecondi necessari per l'esecuzione della query. |
| ProcessedBytes | Il numero di byte analizzati da Athena per query DML. Per le query che sono state annullate (dagli utenti o automaticamente se hanno raggiunto il limite), questo valore include la quantità di dati analizzati prima dell'annullamento. Questo parametro non viene segnalato per le query DDL o CTAS. |
| QueryPlanningTime | Il numero di millisecondi richiesti da Athena per pianificare il flusso di elaborazione delle query. Include il tempo impiegato per recuperare le partizioni della tabella dall'origine dati; Si noti che, poiché il motore di query esegue la pianificazione delle query, il tempo di pianificazione delle query è un sottoinsieme di. EngineExecutionTime |
| QueryQueueTime | Il numero di millisecondi di permanenza della query nella coda di query in attesa delle risorse. Se si verificano errori temporanei, la query può essere aggiunta automaticamente alla coda. |
| ServicePreProcessingTime | Il numero di millisecondi richiesti da Athena per pre-elaborare la query prima di inviarla al motore di query. |
| ServiceProcessingTime | Il numero di millisecondi richiesti da Athena per elaborare i risultati della query dopo che il motore di query ha terminato l'esecuzione della query. |
| TotalExecutionTime | Il numero di millisecondi impiegato da Athena per eseguire una query DDL o DML. TotalExecutionTime include,, e. QueryQueueTime QueryPlanningTime EngineExecutionTime ServiceProcessingTime |
Questi parametri per Athena possiedono le seguenti dimensioni.
| Dimensione | Description |
| --- | --- |
| CapacityReservation | Il nome della prenotazione della capacità utilizzata per eseguire la query, se applicabile. Quando non viene utilizzata una prenotazione della capacità, questa dimensione non restituisce dati. |
| QueryState | Lo stato della query. Statistiche valide: SUCCEEDED, FAILED o CANCELED. |
| QueryType | Il tipo di query. Statistiche valide: `DDL`, `DML` o `UTILITY`. Il tipo di istruzione di query che è stata eseguita. `DDL` indica le istruzioni di query DDL (Data Definition Language). `DML` indica istruzioni di query DML (Data Manipulation Language), ad esempio `CREATE TABLE AS SELECT`. `UTILITY` indica istruzioni di query diverse da DDL e DML, ad esempio `SHOW CREATE TABLE` o `DESCRIBE TABLE`. |
| WorkGroup | Il nome del gruppo di lavoro. |