

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à.

# Scenario: pubblica le metriche su CloudWatch
<a name="PublishMetrics"></a>

In questo scenario, si utilizza la AWS Command Line Interface (AWS CLI) per pubblicare una singola metrica per un'applicazione ipotetica denominata. *GetStarted* *Se non avete ancora installato e configurato il AWS CLI, consultate [Getting Set Up with the AWS Command Line Interface nella Guida per l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)utente.AWS Command Line Interface *

**Topics**
+ [Fase 1: Definizione della configurazione dei dati](#define-data-domain)
+ [Passaggio 2: aggiungere metriche a CloudWatch](#add-metrics-to-scenario)
+ [Passaggio 3: Ottieni statistiche da CloudWatch](#GetStatistics)
+ [Fase 4: Visualizzazione di grafici con la console](#ViewGraphs)

## Fase 1: Definizione della configurazione dei dati
<a name="define-data-domain"></a>

In questo scenario, pubblichi punti dati in grado di monitorare la latenza delle richieste per l'applicazione. Scegli dei nomi per il parametro e per lo spazio dei nomi per te significativi. Per questo esempio, assegnate un nome alla metrica *RequestLatency*e inserite tutti i punti dati nel *GetStarted*namespace. 

Pubblica vari punti dati che rappresentano collettivamente tre ore di dati di latenza. I dati non elaborati comprendono 15 letture di latenza di richieste distribuite in tre ore. Ogni lettura è in millisecondi: 
+ Ora uno: 87, 51, 125, 235
+ Ora due: 121, 113, 189, 65, 89
+ Ora tre: 100, 47, 133, 98, 100, 328

*È possibile pubblicare i dati CloudWatch come punti dati singoli o come set aggregato di punti dati denominato set di statistiche.* Puoi aggregare i parametri con una granularità fino a un minuto. Puoi pubblicare i punti dati aggregati in CloudWatch come set di statistiche con quattro chiavi predefinite: `Sum`, `Minimum`, `Maximum` e `SampleCount`.

Pubblica i punti dati provenienti dalla prima ora come singoli punti dati. Per i dati provenienti dalla seconda e terza ora, aggrega i punti dati e pubblica un set di statistiche per ogni ora. I valori della chiave sono visualizzati nella tabella seguente.


| Ora | Dati non elaborati | Somma | Minimo | Massimo | SampleCount | 
| --- | --- | --- | --- | --- | --- | 
| `1` | `87` |  |  |  |  | 
| `1` | `51` |  |  |  |  | 
| `1` | `125` |  |  |  |  | 
| `1` | `235` |  |  |  |  | 
| `2` | `121, 113, 189, 65, 89` | `577` | `65` | `189` | `5` | 
| `3` | `100, 47, 133, 98, 100, 328` | `806` | `47` | `328` | `6` | 

## Passaggio 2: aggiungere metriche a CloudWatch
<a name="add-metrics-to-scenario"></a>

Dopo aver definito la configurazione dei dati, sei pronto per aggiungere dati.

**Per pubblicare punti dati su CloudWatch**

1. Al prompt dei comandi, [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)esegui i comandi seguenti per aggiungere dati per la prima ora. Sostituisci il timestamp di esempio con un timestamp riferito a due ore nel passato, in formato UTC (Universal Coordinated Time).

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 87 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 51 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 125 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 235 --unit Milliseconds
   ```

1. Aggiungi i dati alla seconda ora utilizzando un timestamp riferito a un'ora in avanti rispetto alla prima ora.

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T21:30:00Z}} --statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds
   ```

1. Aggiungi i dati alla terza ora, omettendo il timestamp al valore predefinito per l'ora corrente. 

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds
   ```

## Passaggio 3: Ottieni statistiche da CloudWatch
<a name="GetStatistics"></a>

Ora che hai pubblicato le metriche su CloudWatch, puoi recuperare le statistiche basate su tali metriche utilizzando il [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)comando seguente. Assicurati di specificare `--start-time` e `--end-time` in momenti sufficientemente distanti nel passato in modo da coprire il primo timestamp pubblicato.

```
aws cloudwatch get-metric-statistics --namespace GetStarted --metric-name RequestLatency --statistics Average \
--start-time {{2016-10-14T00:00:00Z}} --end-time {{2016-10-15T00:00:00Z}} --period 60
```

Di seguito è riportato un output di esempio:

```
{
	"Datapoints": [],
	"Label": "Request:Latency"
}
```

## Fase 4: Visualizzazione di grafici con la console
<a name="ViewGraphs"></a>

Dopo aver pubblicato le metriche su CloudWatch, puoi utilizzare la CloudWatch console per visualizzare grafici statistici.

**Visualizzazione dei grafici delle statistiche nella console**

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

1. Nel pannello **Navigation** (Navigazione), seleziona **Metrics** (Parametri).

1. Nella scheda **Tutte le metriche**, nella casella di ricerca, digita **RequestLatency**e premi Invio.

1. Seleziona la casella di controllo per la **RequestLatency**metrica. Verrà visualizzato un grafico dei dati del parametro nel riquadro superiore.

Per ulteriori informazioni, consulta [Rappresentazione grafica dei parametri](graph_metrics.md).