

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 delle implementazioni con gli strumenti di Amazon CloudWatch
<a name="monitoring-cloudwatch"></a>

Puoi monitorare le CodeDeploy distribuzioni utilizzando i seguenti CloudWatch strumenti: Amazon CloudWatch Events, CloudWatch allarmi e Amazon Logs. CloudWatch 

La revisione dei log creati dall' CodeDeploy agente e dalle distribuzioni può aiutarti a risolvere le cause degli errori di distribuzione. In alternativa alla revisione dei CodeDeploy log di un'istanza alla volta, è possibile utilizzare CloudWatch Logs per monitorare tutti i log in una posizione centrale.

Per informazioni sull'utilizzo di CloudWatch allarmi ed CloudWatch eventi per monitorare le CodeDeploy distribuzioni, consulta i seguenti argomenti. 

**Topics**
+ [Monitoraggio delle distribuzioni con allarmi in CloudWatch CodeDeploy](monitoring-create-alarms.md)
+ [Monitoraggio delle distribuzioni con Amazon Events CloudWatch](monitoring-cloudwatch-events.md)

# Monitoraggio delle distribuzioni con allarmi in CloudWatch CodeDeploy
<a name="monitoring-create-alarms"></a>

Puoi creare un CloudWatch allarme per un'istanza o un gruppo Amazon EC2 Auto Scaling che utilizzi CodeDeploy nelle tue operazioni. Un allarme controlla una singola metrica in un periodo di tempo specificato ed esegue una o più azioni in base al valore della metrica rispetto a una determinata soglia in diversi periodi di tempo. CloudWatch gli allarmi richiamano azioni quando il loro stato cambia (ad esempio, da a). `OK` `ALARM`

Utilizzando la funzionalità di CloudWatch allarme nativa, puoi specificare qualsiasi azione supportata in CloudWatch caso di errore di un'istanza utilizzata in una distribuzione, come l'invio di una notifica Amazon SNS o l'arresto, la chiusura, il riavvio o il ripristino di un'istanza. Per CodeDeploy le tue operazioni, puoi configurare un gruppo di distribuzione per interrompere una distribuzione ogni volta che viene attivato un CloudWatch allarme associato al gruppo di distribuzione. 

È possibile associare fino a dieci CloudWatch allarmi a un gruppo di CodeDeploy distribuzione. Se uno degli allarmi specificati viene attivato, la distribuzione viene interrotta e passa allo stato Interrotta. Per utilizzare questa opzione, è necessario concedere CloudWatch le autorizzazioni per il proprio ruolo di CodeDeploy servizio.

Per informazioni sulla configurazione degli CloudWatch allarmi nella CloudWatch console, consulta la sezione [Creazione di CloudWatch allarmi Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/AlarmThatSendsEmail.html) nella *Amazon CloudWatch User Guide*.

Per informazioni sull'associazione di un CloudWatch allarme a un gruppo di distribuzione in CodeDeploy, consulta e. [Crea un gruppo di distribuzione con CodeDeploy](deployment-groups-create.md) [Modifica le impostazioni del gruppo di distribuzione con CodeDeploy](deployment-groups-edit.md)

**Topics**
+ [Concedere CloudWatch le autorizzazioni a un ruolo di servizio CodeDeploy](monitoring-create-alarms-grant-permissions.md)

# Concedere CloudWatch le autorizzazioni a un ruolo di servizio CodeDeploy
<a name="monitoring-create-alarms-grant-permissions"></a>

Prima di poter utilizzare il monitoraggio degli CloudWatch allarmi nelle distribuzioni, è necessario concedere al ruolo di servizio utilizzato nelle CodeDeploy operazioni l' CloudWatch autorizzazione ad accedere alle risorse. 

**Per concedere le CloudWatch autorizzazioni a un ruolo di servizio**

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

1. Nella console IAM, nel pannello di navigazione, scegli **Ruoli**.

1. Scegli il nome del ruolo di servizio che utilizzi nelle tue AWS CodeDeploy operazioni.

1. Nella scheda **Permissions (Autorizzazioni)**, nell'area **Inline Policies (Policy inline)**, scegliere **Create Role Policy (Crea policy ruolo)**.

   —oppure—

   Se il pulsante **Create Role Policy (Crea policy ruolo)** non è disponibile, espandere l'area **Inline Policies (Policy inline)**, quindi scegliere **click here (fai clic qui)**.

1. Nella pagina **Set Permissions** (Imposta autorizzazioni), scegli **Custom Policy** (Policy personalizzata), quindi scegli **Select** (Seleziona).

1. Nella pagina **Review Policy (Riconsulta policy)**, nel campo **Policy Name (Nome policy)**, digitare un nome per identificare questa policy, ad esempio `CWAlarms`.

1. Incollare quanto segue nel campo **Policy Document (Documento policy)**: 

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "cloudwatch:DescribeAlarms",
               "Resource": "*"
           }
       ]
   }
   ```

------

1. Scegli **Apply Policy** (Applica policy).

# Monitoraggio delle distribuzioni con Amazon Events CloudWatch
<a name="monitoring-cloudwatch-events"></a>

Puoi utilizzare Amazon CloudWatch Events per rilevare e reagire ai cambiamenti nello stato di un'istanza o di una distribuzione (un «evento») nelle tue CodeDeploy operazioni. Quindi, in base alle regole che crei, CloudWatch Events invocherà una o più azioni mirate quando una distribuzione o un'istanza entra nello stato specificato in una regola. A seconda del tipo di cambiamento di stato, potrebbe essere necessario inviare notifiche, acquisire informazioni sullo stato, eseguire un'azione correttiva, avviare eventi o eseguire altre operazioni. Puoi selezionare i seguenti tipi di obiettivi quando utilizzi CloudWatch Events come parte delle tue CodeDeploy operazioni:
+ AWS Lambda funzioni
+  Flussi Kinesis
+ Code Amazon SQS
+ Obiettivi predefiniti (`EC2 CreateSnapshot API call``EC2 RebootInstances API call``EC2 StopInstances API call`,, e`EC2 TerminateInstances API call`)
+ Argomenti di Amazon SNS

Di seguito sono riportati alcuni casi d'uso:
+ Utilizza una funzione di Lambda per inoltrare una notifica a un canale Slack quando le distribuzioni hanno esito negativo.
+ Effettua il push dei dati relativi a distribuzioni o istanze su un flusso Kinesis per supportare il monitoraggio completo dello stato in tempo reale.
+ Usa le azioni di CloudWatch allarme per arrestare, terminare, riavviare o ripristinare automaticamente EC2 le istanze Amazon quando si verifica un evento di distribuzione o istanza specificato.

Il resto di questo argomento descrive la procedura di base per la creazione di una CloudWatch regola Events per. CodeDeploy Prima di creare regole di evento da utilizzare nelle CodeDeploy operazioni, tuttavia, è necessario effettuare le seguenti operazioni:
+ Completa i prerequisiti CloudWatch degli eventi. Per informazioni, consulta i [prerequisiti di Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_Prerequisites.html).
+ Acquisisci familiarità con eventi, regole e obiettivi in Events. CloudWatch Per ulteriori informazioni, consulta [Che cos'è Amazon CloudWatch Events?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) e [nuovi CloudWatch eventi: monitora e rispondi alle modifiche alle tue AWS risorse](https://aws.amazon.com/blogs/aws/new-cloudwatch-events-track-and-respond-to-changes-to-your-aws-resources/).
+ Crea la destinazione o le destinazioni da utilizzare nelle regole degli eventi. 

**Per creare una regola CloudWatch relativa agli eventi per CodeDeploy:**

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 **Events** (Eventi).

1. Scegli **Create rule (Crea regola)**, quindi, in **Event selector (Selettore evento)**, scegli **AWS CodeDeploy**.

1. Specifica un tipo di dettaglio:
   + Per creare una regola che si applichi a tutte le modifiche di stato delle istanze e delle distribuzioni, scegli **Any detail type (Qualsiasi tipo di dettaglio)**, quindi passa alla fase 6.
   + Per creare una regola applicabile solo alle istanze, scegli **Tipo di dettaglio specifico**, quindi scegli Notifica di **modifica dello stato dell'CodeDeploy istanza**.
   + **Per creare una regola che si applichi solo alle distribuzioni, scegli **Tipo di dettaglio specifico**, quindi scegli CodeDeploy Notifica di modifica dello stato di distribuzione.**

1. Specificare le modifiche di stato cui si applica la regola:
   + Per creare una regola che si applichi a tutte le modifiche di stato, scegli **Any state (Qualsiasi stato)**.
   + Per creare una regola che si applichi solo ad alcune modifiche di stato, scegli **Specific state(s) (Stati specifici)**, quindi scegli uno o più valori di stato dall'elenco. La tabella seguente include i valori di stato che è possibile scegliere:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codedeploy/latest/userguide/monitoring-cloudwatch-events.html)

1. Specificate a quali CodeDeploy applicazioni si applica la regola:
   + Per creare una regola che si applichi a tutte le applicazioni, scegli **Any application (Qualsiasi applicazione)**, quindi passa al punto 8.
   + Per creare una regola che si applichi a una sola applicazione, scegli **Specific application (Applicazione specifica)**, quindi seleziona il nome dell'applicazione dall'elenco.

1. Specifica i gruppi di distribuzione a cui si applica la regola:
   + Per creare una regola che si applichi a tutti i gruppi di distribuzione associati all'applicazione selezionata, scegli **Any deployment group (Qualsiasi gruppo di distribuzione)**.
   + Per creare una regola che si applichi a uno solo dei gruppi di distribuzione associati all'applicazione selezionata, scegli **Specific deployment group(s) (Gruppi di distribuzione specifici)**, quindi seleziona il nome del gruppo di distribuzione dall'elenco.

1. Verifica la configurazione delle regole per accertarti che soddisfi i tuoi requisiti di monitoraggio di eventi.

1. Nell'area **Targets** (Destinazioni), scegli **Add target\$1** (Aggiungi destinazione).

1. Nell'elenco **Select target type** (Seleziona tipo di destinazione), scegli il tipo di destinazione da utilizzare con questa regola, quindi configura le eventuali altre opzioni richieste da quel tipo. 

1. Scegli **Configura dettagli**.

1. Nella pagina **Configure rule details (Configura i dettagli della regola)**, digita un nome e una descrizione per la regola, quindi seleziona la casella **State (Stato)** per abilitare la regola non appena viene creata.

1. Se la regola ti soddisfa, scegli **Create rule** (Crea regola).