

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 richieste EC2 API Amazon utilizzando Amazon CloudWatch
<a name="monitor"></a>

Puoi monitorare le richieste EC2 API di Amazon utilizzando Amazon CloudWatch, che raccoglie dati grezzi e li elabora in metriche leggibili quasi in tempo reale. Queste metriche forniscono un modo semplice per monitorare l'utilizzo e i risultati delle operazioni delle EC2 API Amazon nel tempo. Queste informazioni offrono una prospettiva migliore sulle prestazioni delle applicazioni Web e consentono di identificare e diagnosticare una serie di problemi. È inoltre possibile impostare allarmi che controllano determinate soglie e inviare notifiche o intraprendere azioni specifiche quando tali soglie vengono raggiunte.

Per ulteriori informazioni CloudWatch, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

**Importante**  
I parametri EC2 delle API di Amazon sono una funzionalità opzionale. È necessario richiedere l'accesso a questa funzionalità. Per ulteriori informazioni, consulta [Abilita i parametri EC2 delle API Amazon](#enable-ec2-api-metrics).

**Topics**
+ [Abilita i parametri EC2 delle API Amazon](#enable-ec2-api-metrics)
+ [Metriche e dimensioni dell' EC2 API Amazon](#monitor-metrics_dimensions)
+ [Conservazione dei dati metrici](#monitor-retention)
+ [Monitoraggio delle richieste effettuate per tuo conto](#throttling-metrics)
+ [Fatturazione](#monitor-billing)
+ [Lavorare con Amazon CloudWatch](#monitor-using)

## Abilita i parametri EC2 delle API Amazon
<a name="enable-ec2-api-metrics"></a>

Utilizza la seguente procedura per richiedere l'accesso a questa funzionalità per i tuoi Account AWS.

**Per richiedere l'accesso a questa funzionalità**

1. Open [Supporto AWS Center](https://console.aws.amazon.com/support/home#/).

1. Scegli **Crea caso**.

1. Scegli **Account e fatturazione**.

1. Per **Assistenza**, scegli **Informazioni generali e Guida introduttiva**.

1. Per **Categoria**, scegli **Uso AWS e servizi**.

1. Scegli **Fase successiva: informazioni aggiuntive**.

1. Per **Subject (Oggetto)**, immettere **Request access to Amazon EC2 API metrics**.

1. Per **Descrizione**, inserisci **Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html**. Includi anche la regione a cui devi accedere.

1. Scegli **Passaggio successivo: risolvi ora o contattaci**.

1. Nella scheda **Contattaci**, scegli la lingua e il metodo di contatto preferiti.

1. Seleziona **Invia**.

## Metriche e dimensioni dell' EC2 API Amazon
<a name="monitor-metrics_dimensions"></a>

### Metriche
<a name="monitor-metrics"></a>

I parametri dell' EC2 API Amazon sono contenuti nel `AWS/EC2/API` namespace. Le tabelle seguenti elencano le metriche disponibili per le richieste EC2 API Amazon.


| Metrica | Description | 
| --- | --- | 
|  `ClientErrors` |  Il numero di richieste API non riuscite causate da errori del client. Questi errori sono in genere causati da un'operazione del client, ad esempio la specificazione di un parametro errato o non valido nella richiesta o l'utilizzo di un'azione o di una risorsa per conto di un utente che non dispone dell'autorizzazione per utilizzare l'azione o la risorsa. Unità: numero  | 
|  `RequestLimitExceeded` |  Il numero di volte in cui è EC2 APIs stata superata la frequenza massima di richieste consentita da Amazon per il tuo account. Le richieste EC2 API di Amazon vengono limitate per aiutare a mantenere le prestazioni del servizio. Se le tue richieste sono state limitate, viene visualizzato l'errore. `Client.RequestLimitExceeded` Unità: numero  | 
|  `AwsTriggeredRequestLimitExceeded` |  Il numero di richieste API non riuscite causate dalla limitazione applicata a causa di AWS un problema operativo. Quando si verifica questa limitazione, si riceve un `Client.RequestLimitExceeded` errore con un messaggio che indica che la richiesta è stata limitata a causa di un problema operativo. AWS Questa limitazione è temporanea e si risolve automaticamente una volta risolto il problema operativo. Implementa il backoff esponenziale e riprova la logica per gestire queste accelerazioni temporanee con garbo. Unità: numero  | 
|  `ServerErrors` |  Il numero di richieste API non riuscite causate da errori interni del server. Questi errori sono in genere causati da un errore, un'eccezione o un errore AWS sul lato server. Unità: numero  | 
|  `SuccessfulCalls` |  Il numero di richieste API riuscite. Unità: numero  | 

### Dimensioni
<a name="monitor-dimensions"></a>

I dati dei EC2 parametri Amazon possono essere filtrati tra tutte le azioni EC2 API. Per ulteriori informazioni sulle dimensioni, consulta [Amazon CloudWatch concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html).

## Conservazione dei dati metrici
<a name="monitor-retention"></a>

I parametri EC2 dell'API Amazon vengono inviati a CloudWatch intervalli di 1 minuto. CloudWatch conserva i dati metrici come segue:
+ I punti di dati con un periodo di 60 secondi (1 minuto) sono disponibili per 15 giorni.
+ I punti dati con un periodo di 300 secondi (5 minuti) sono disponibili per 63 giorni.
+ I punti dati con un periodo di 3600 secondi (1 ora) sono disponibili per 455 giorni (15 mesi).

## Monitoraggio delle richieste effettuate per tuo conto
<a name="throttling-metrics"></a>

Le richieste API effettuate dai AWS servizi per tuo conto, come le richieste effettuate da ruoli collegati ai servizi, non vengono conteggiate ai fini dei limiti di limitazione delle API e non inviano i parametri ad Amazon per il tuo account. CloudWatch Queste richieste non possono essere monitorate utilizzando. CloudWatch

Le richieste API effettuate per tuo conto da fornitori di servizi di terze parti vengono conteggiate ai fini dei limiti di limitazione delle API e inviano i parametri ad Amazon CloudWatch per il tuo account. Queste richieste possono essere monitorate utilizzando. CloudWatch

## Fatturazione
<a name="monitor-billing"></a>

Si applicano CloudWatch prezzi e addebiti standard. Non vengono applicati costi aggiuntivi per l'utilizzo delle metriche dell' EC2 API Amazon. Per ulteriori informazioni, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/).

## Lavorare con Amazon CloudWatch
<a name="monitor-using"></a>

**Contents**
+ [Visualizzazione delle CloudWatch metriche](#monitor-using-viewing)
+ [Creazione di CloudWatch allarmi](#monitor-creating)

### Visualizzazione delle CloudWatch metriche
<a name="monitor-using-viewing"></a>

Utilizza la seguente procedura per visualizzare i parametri dell' EC2 API Amazon.

**Prerequisito**  
Devi abilitare l'accesso ai parametri delle EC2 API Amazon per il tuo account. Per ulteriori informazioni, consulta [Abilita i parametri EC2 delle API Amazon](#enable-ec2-api-metrics).

**Per visualizzare i parametri dell' EC2 API Amazon utilizzando la console**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel riquadro di navigazione, scegli **Metriche**, **Tutte le metriche**.

1. Nella scheda **Sfoglia**, in **Metriche**, seleziona la regione desiderata per visualizzare le metriche.

1. Scegli lo spazio dei nomi delle **EC2**metriche.

1. **Per visualizzare le metriche, seleziona la dimensione metrica, ad esempio Metriche per istanza.**
**Nota**  
Le metriche vengono nascoste dopo due settimane di inattività. [Se non ricevono nuovi punti dati nelle ultime due settimane, non vengono più visualizzate nella console, non vengono visualizzate quando digiti il nome delle metriche o i nomi delle dimensioni nella casella di ricerca della console e non vengono restituite dal comando list-metrics.](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) AWS CLI Per recuperare queste metriche, usa i comandi or. [get-metric-data[get-metric-statistics]()]()

**Per visualizzare i parametri EC2 delle API di Amazon utilizzando la riga di comando**

Utilizzare uno dei seguenti comandi:
+ [list-metrics ()](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html)AWS CLI

  ```
  aws cloudwatch list-metrics --namespace "AWS/EC2/API"
  ```
+ [Get- CWMetric](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html) List ()AWS Tools for Windows PowerShell

  ```
  Get-CWMetricList -Namespace "AWS/EC2/API"
  ```

### Creazione di CloudWatch allarmi
<a name="monitor-creating"></a>

Puoi creare un CloudWatch allarme che invia un messaggio Amazon SNS quando l'allarme cambia stato. Un allarme monitora una singola metrica per un periodo di tempo specificato. Invia una notifica a un argomento SNS in base al valore della metrica relativa a una determinata soglia per un certo numero di periodi di tempo.

Ad esempio, puoi creare un allarme che monitora il numero di richieste DescribeInstances API che hanno esito negativo a causa di errori sul lato server. Il seguente allarme invia una notifica e-mail quando il numero di richieste DescribeInstances API non riuscite raggiunge la soglia di 10 errori lato server in un periodo di 5 minuti.

**Prerequisito**  
Devi abilitare l'accesso ai parametri dell' EC2 API Amazon per il tuo account. Per ulteriori informazioni, consulta [Abilita i parametri EC2 delle API Amazon](#enable-ec2-api-metrics).

**Per creare un allarme per gli errori del server di richiesta dell' EC2 DescribeInstances API Amazon**

1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Nel pannello di navigazione, scegli **Alarms** (Allarmi), **All alarms** (Tutti gli allarmi).

1. Scegli **Crea allarme**.

1. Scegliete **Seleziona metrica** e specificate quanto segue:

   1. Scegli **EC2/API.**

   1. Scegli **Metriche per azione**.

   1. Seleziona la casella di controllo accanto **DescribeInstances**che si trova nella stessa riga del nome della metrica. **ServerErrors**

   1. Scegli **Select Metric** (Seleziona parametro).

1. Viene visualizzata la pagina **Specify metric and conditions** (Specifica parametro e condizioni), contenente un grafico e altre informazioni sul parametro e le statistiche selezionate.

   1. In **Metrica**, specifica quanto segue:

      1. Per **Statistic (Statistica)**, scegliere **Sum (Somma)**.

      1. Per **Periodo**, verifica che siano selezionati **5 minuti**.

   1. In **Conditions** (Condizioni), specifica quanto segue:

      1. For **Threshold type (Tipo di soglia)**, scegli **Static (Statica)**.

      1. **Per **Whenever ServerErrors is**, scegli **Maggiore/Uguale >=**.**

      1. **Per** più di... , inserisci **10**.

   1. Scegli **Next (Successivo)**.

1. Viene visualizzata la pagina **Configure actions** (Configura operazioni).

   1. In **Notifica**, specificare quanto segue:

     1. Per attivare **lo stato di allarme**, scegli **In allarme**.

     1. Per **Seleziona un argomento SNS**, scegli **Seleziona un argomento SNS esistente** o **Crea nuovo argomento** e completa i campi obbligatori per la notifica.

     1. Scegli **Next (Successivo)**.

1. Viene visualizzata la pagina **Aggiungi nome e descrizione**. 

   1. In **Nome allarme**, inserisci un nome per la sveglia. Il nome deve contenere solo caratteri ASCII.

   1. Per **Descrizione dell'allarme**, inserisci una descrizione opzionale per l'allarme.

   1. Scegli **Next (Successivo)**.

1. Viene **visualizzata la pagina Anteprima e creazione**. Verifica che le informazioni siano corrette, quindi scegli **Crea allarme**.

Per ulteriori informazioni, consulta [Using Amazon CloudWatch alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) nella *Amazon CloudWatch User Guide*.