

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

# Monitoraggio di Amazon Personalize con Amazon CloudWatch
<a name="personalize-monitoring"></a>

Con Amazon CloudWatch, puoi ottenere metriche associate ad Amazon Personalize. È possibile impostare allarmi per ricevere una notifica quando uno o più di questi parametri ricadono al di fuori di una soglia definita. Per visualizzare le metriche, puoi utilizzare [Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/) AWS Command Line Interface, [Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/) o l'[CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).



**Topics**
+ [Utilizzo dei CloudWatch parametri per Amazon Personalize](#using-metrics)
+ [Accesso ai parametri di Amazon Personalize](#how-to-access)
+ [Creazione di un allarme](#alarms)
+ [Esempio di app di monitoraggio senza server Amazon Personalize](#creating-monitor-app)
+ [CloudWatch metriche per Amazon Personalize](cloudwatch-metrics.md)

## Utilizzo dei CloudWatch parametri per Amazon Personalize
<a name="using-metrics"></a>

Per utilizzare le metriche, devi specificare le seguenti informazioni:
+ Il nome della metrica.
+ La dimensione della metrica. Una *dimensione* è una coppia nome-valore che consente di identificare una metrica in modo univoco.

Puoi ottenere dati di monitoraggio per Amazon Personalize utilizzando l' Console di gestione AWS AWS CLI, l'o l' CloudWatch API. Puoi anche utilizzare l' CloudWatch API tramite uno dei AWS SDKs nostri strumenti CloudWatch API. La console mostra una serie di grafici basati sui dati grezzi dell' CloudWatch API. In base alle tue esigenze, potresti decidere di utilizzare i grafici visualizzati nella console o quelli recuperati dall'API.

L'elenco seguente mostra alcuni usi comuni dei parametri. Questi suggerimenti sono solo introduttivi e non costituiscono un elenco completo.


| Come...? | Parametro pertinente | 
| --- | --- | 
|  Come monitorare il numero di eventi che sono stati registrati.  |  Monitorare il parametro `PutEventsRequests`.  | 
|  Come posso monitorare gli DatasetImportJob errori?  |  Utilizza la metrica `DatasetImportJobError`.  | 
|  Come è possibile monitorare la latenza delle chiamate `GetRecommendations`?  |  Utilizza la metrica `GetRecommendationsLatency`.  | 

Devi disporre delle CloudWatch autorizzazioni appropriate con cui monitorare Amazon CloudWatch Personalize. Per ulteriori informazioni, consulta [Autenticazione e controllo degli accessi per Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).

## Accesso ai parametri di Amazon Personalize
<a name="how-to-access"></a>

Gli esempi seguenti mostrano come accedere ai parametri di Amazon Personalize utilizzando la CloudWatch console, l'e l' AWS CLI API. CloudWatch 

**Come visualizzare le metriche (console)**

1. Accedi Console di gestione AWS e apri la CloudWatch console all'indirizzo. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)

1. Scegli **Metriche**, scegli la scheda **Tutte le metriche**, quindi scegli. `AWS/Personalize`

1. Scegli la dimensione delle metriche.

1. Selezionare il parametro desiderato dall'elenco e scegliere un periodo di tempo per il grafico.

**Per visualizzare i parametri per gli eventi ricevuti in un periodo di tempo (CLI).**
+ Apri AWS CLI e inserisci il seguente comando:

  ```
  aws cloudwatch get-metric-statistics \
    --metric-name PutEventsRequests \
    --start-time 2019-03-15T00:00:20Z \
    --period 3600 \
    --end-time 2019-03-16T00:00:00Z \
    --namespace AWS/Personalize \
    --dimensions Name=EventTrackerArn,Value=EventTrackerArn \
    --statistics Sum
  ```

  Questo esempio mostra gli eventi ricevuti per l’ARN del tracciatore eventi determinato in un periodo di tempo. Per ulteriori informazioni, consulta [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).

**Per accedere alle metriche (CloudWatch API)**
+  Chiama `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Per ulteriori informazioni, consulta [Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).

## Creazione di un allarme
<a name="alarms"></a>

Puoi creare un CloudWatch allarme che invia un messaggio Amazon Simple Notification Service (Amazon SNS) quando l'allarme cambia stato. Un allarme monitora un singolo parametro per un periodo di tempo specificato. L'allarme esegue una o più operazioni basate sul valore del parametro relativo a una soglia prestabilita per un certo numero di periodi. L'azione è una notifica inviata a un argomento o a una AWS Auto Scaling policy di Amazon SNS.

Gli allarmi richiamano azioni solo per modifiche di stato sostenute. CloudWatch gli allarmi non richiamano azioni semplicemente perché si trovano in uno stato particolare. È necessario che lo stato cambi e rimanga costante per un periodo specificato

**Come impostare un allarme (console)**

1. Accedi a Console di gestione AWS e apri la CloudWatch console all'indirizzo. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)

1. Nel riquadro di navigazione, seleziona **Alarms (Allarmi)**, quindi **Crea Alarm (Crea allarme)**. Viene avviata la **procedura guidata per la creazione di allarmi**. 

1. Scegli **Seleziona metrica**.

1. Nella scheda **Tutte le metriche**, scegli`AWS/Personalize`.

1. Scegli **EventTrackerArn**, quindi scegli le **PutEventsRequests**metriche.

1. Seleziona la scheda **Graphed metrics** (Parametri nel grafico).

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

1. Scegli **Seleziona metrica**.

1. Compila i campi **Name** (Nome) e **Description** (Descrizione). Per **Whenever (Ogni volta)**, scegliere **>** e inserire un valore massimo che si preferisce.

1. Se desideri CloudWatch inviarti un'e-mail quando viene raggiunto lo stato di allarme, per **Ogni volta che questo allarme:**, scegli **Lo stato è ALLARME**. Per inviare allarmi a un argomento Amazon SNS esistente, in **Invia notifica a:**, scegli un argomento SNS esistente. Per impostare il nome e gli indirizzi e-mail per una nuova lista di sottoscrizioni e-mail, scegli **Nuova lista**. CloudWatch salva l'elenco e lo visualizza sul campo in modo da poterlo utilizzare per impostare allarmi futuri. 
**Nota**  
Se utilizzi **New list** per creare un nuovo argomento Amazon SNS, gli indirizzi e-mail devono essere verificati prima che i destinatari previsti ricevano le notifiche. Le e-mail vengono inviate da Amazon SNS solo quando l'allarme passa allo stato definito. Se lo stato cambia prima della verifica degli indirizzi e-mail, i destinatari previsti non riceveranno una notifica.

1. Scegli **Crea allarme**. 

**Per impostare un allarme (AWS CLI)**
+ Apri AWS CLI, quindi inserisci il seguente comando. Modifica il valore del `alarm-actions` parametro per fare riferimento a un argomento di Amazon SNS creato in precedenza.

  ```
  aws cloudwatch put-metric-alarm \
      --alarm-name PersonalizeCLI \
      --alarm-description "Alarm when more than 10 events occur" \
      --metric-name PutEventsRequests \
      --namespace  AWS/Personalize \
      --statistic Sum \
      --period 300 \
      --threshold 10 \
      --comparison-operator GreaterThanThreshold \
      --evaluation-periods 1 \
      --unit Count \
      --dimensions Name=EventTrackerArn,Value=EventTrackerArn \
      --alarm-actions SNSTopicArn
  ```

  Questo esempio illustra come creare un allarme per quando si verificano più di 10 eventi per un determinato ARN del tracciatore di eventi in 5 minuti. Per ulteriori informazioni, consulta [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html).

**Per impostare un allarme (CloudWatch API)**
+ Chiama `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Per ulteriori informazioni, consulta *[Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.

## Esempio di app di monitoraggio senza server Amazon Personalize
<a name="creating-monitor-app"></a>

Per un'app di esempio che aggiunge funzionalità di monitoraggio, avviso e ottimizzazione per Amazon Personalize, consulta Amazon [Personalize monitor nell'archivio degli esempi di Amazon [Personalize](https://github.com/aws-samples/amazon-personalize-samples)](https://github.com/aws-samples/amazon-personalize-monitor).

# CloudWatch metriche per Amazon Personalize
<a name="cloudwatch-metrics"></a>

Questa sezione contiene informazioni sui CloudWatch parametri Amazon disponibili per Amazon Personalize. Per ulteriori informazioni, consulta [Monitoraggio di Amazon Personalize con Amazon CloudWatch](personalize-monitoring.md).

La tabella seguente elenca i parametri di Amazon Personalize. Tutte le metriche tranne GetRecommendations e GetPersonalizedRanking supportano queste statistiche:. `Average, Minimum, Maximum, Sum` GetRecommendations e `Sum` solo GetPersonalizedRanking supporto.


| Metrica | Description | 
| --- | --- | 
| DatasetImportJobRequests |  Il numero di chiamate API [CreateDatasetImportJob](API_CreateDatasetImportJob.md) eseguite correttamente. Dimensioni: `DatasetGroupArn, DatasetArn, DatasetImportJobArn`  | 
| DatasetImportJobError |  Il numero di chiamate API `CreateDatasetImportJob` che hanno generato un errore. Dimensioni: `DatasetGroupArn, DatasetArn, DatasetImportJobArn`  | 
| DatasetImportJobExecutionTime |  L'intervallo di tempo tra la chiamata API `CreateDatasetImportJob` e il completamento (o l’errore) dell'operazione. Dimensioni: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unità: secondi  | 
| DatasetSize |  Le dimensioni dei dati importati dal processo di importazione del set di dati. Dimensioni: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` Unità: byte  | 
| SolutionTrainingJobRequests |  Il numero di chiamate API [CreateSolutionVersion](API_CreateSolutionVersion.md) eseguite correttamente. Dimensioni: `SolutionArn, SolutionVersionArn`  | 
| SolutionTrainingJobError |  Il numero di chiamate API `CreateSolutionVersion` che hanno generato un errore. Dimensioni: `SolutionArn, SolutionVersionArn`  | 
| SolutionTrainingJobExecutionTime |  L'intervallo di tempo tra la chiamata API `CreateSolutionVersion` e il completamento (o l’errore) dell'operazione. Dimensioni: `SolutionArn, SolutionVersionArn` Unità: secondi  | 
| GetPersonalizedRanking |  Se una chiamata [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API ha esito positivo. Utilizza la `sum` statistica per visualizzare il numero totale di chiamate GetPersonalizedRanking API riuscite. Questa metrica non supporta altre statistiche. Dimensione: `CampaignArn`  | 
| GetPersonalizedRanking4xxErrors |  Il numero di chiamate API `GetPersonalizedRanking` che hanno restituito un codice di risposta HTTP 4xx. Dimensione: `CampaignArn`  | 
| GetPersonalizedRanking5xxErrors |  Il numero di chiamate API `GetPersonalizedRanking` che hanno restituito un codice di risposta HTTP 5xx. Dimensione: `CampaignArn`  | 
| GetPersonalizedRankingLatency |  Il periodo di tempo tra la ricezione della chiamata API `GetPersonalizedRanking` e l'invio di raccomandazioni (sono esclusi gli errori 4xx e 5xx). Dimensione: `CampaignArn` Unità: millisecondi  | 
| GetRecommendations |  Se una chiamata [GetRecommendations](API_RS_GetRecommendations.md) API ha esito positivo. Utilizza la `sum` statistica per visualizzare il numero totale di chiamate GetRecommendations API riuscite. Questa metrica non supporta altre statistiche. Dimensione: `CampaignArn`  | 
| GetRecommendations4xxErrors |  Il numero di chiamate API `GetRecommendations` che hanno restituito un codice di risposta HTTP 4xx. Dimensione: `CampaignArn`  | 
| GetRecommendationsErrori 5xx |  Il numero di chiamate API `GetRecommendations` che hanno restituito un codice di risposta HTTP 5xx. Dimensione: CampaignArn  | 
| GetRecommendationsLatency |  Il periodo di tempo tra la ricezione della chiamata API `GetRecommendations` e l'invio di raccomandazioni (sono esclusi gli errori 4xx e 5xx). Dimensione: `CampaignArn` Unità: millisecondi  | 
| PutEventsRequests |  Il numero di chiamate API [PutEvents](API_UBS_PutEvents.md) eseguite correttamente. Dimensione: ` DatasetGroupArn, DatasetArn, EventTrackerArn`  | 
| PutEvents4xxErrors |  Il numero di chiamate API `PutEvents` che hanno restituito un codice di risposta HTTP 4xx. Dimensione: ` DatasetGroupArn, DatasetArn, EventTrackerArn`  | 
| PutEvents5xxErrors |  Il numero di chiamate API `PutEvents` che hanno restituito un codice di risposta HTTP 5xx. Dimensione: ` DatasetGroupArn, DatasetArn, EventTrackerArn`  | 
| PutEventLatency |  Il tempo necessario per il completamento della chiamata API `PutEvents` (sono esclusi gli errori 4xx e 5xx). Dimensione: ` DatasetGroupArn, DatasetArn, EventTrackerArn` Unità: millisecondi  | 
| PutItemsRequests |  Il numero di chiamate API [PutItems](API_UBS_PutItems.md) eseguite correttamente. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutItems4xxErrors |  Il numero di chiamate API `PutItems` che hanno restituito un codice di risposta HTTP 4xx. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutItems5xxErrors |  Il numero di chiamate API `PutItems` che hanno restituito un codice di risposta HTTP 5xx. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutItemsLatency |  Il tempo necessario per il completamento della chiamata API `PutItems` (sono esclusi gli errori 4xx e 5xx). Dimensione: ` DatasetGroupArn, DatasetArn` Unità: millisecondi  | 
| PutUsersRequests |  Il numero di chiamate API [PutUsers](API_UBS_PutUsers.md) eseguite correttamente. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutUsers4xxErrors |  Il numero di chiamate API `PutUsers` che hanno restituito un codice di risposta HTTP 4xx. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutUsers5xxErrors |  Il numero di chiamate API `PutUsers` che hanno restituito un codice di risposta HTTP 5xx. Dimensione: ` DatasetGroupArn, DatasetArn`  | 
| PutUsersLatency |  Il tempo necessario per il completamento della chiamata API `PutUsers` (sono esclusi gli errori 4xx e 5xx). Dimensione: ` DatasetGroupArn, DatasetArn` Unità: millisecondi  | 