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

# Creazione di un monitor di app CloudWatch RUM per un'applicazione web
<a name="CloudWatch-RUM-get-started-create-app-monitor"></a>

Per iniziare a utilizzare CloudWatch RUM con la tua applicazione, devi creare un *app monitor*. Quando viene creato l'app monitor, RUM genera un frammento di codice da incollare nell'applicazione. Lo snippet inserisce il codice client RUM. Il client RUM acquisisce i dati dalle sessioni utente dell'applicazione e li invia a RUM.

## Per creare un app monitor per una piattaforma web
<a name="web-platform-app-monitor"></a>

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 **Application Signals**, **RUM**.

1. Scegli **Aggiungere un monitor app**.

1. Per **il nome del monitor dell'app**, inserisci un nome da utilizzare per identificare questo app monitor all'interno della console CloudWatch RUM.

1. Seleziona **Web** come piattaforma.

1. Per **Elenco dominio applicazione**, inserire i nomi di dominio registrati in cui l'applicazione dispone dell'autorità amministrativa. Puoi anche utilizzare un carattere jolly `*` per consentire qualsiasi sottodominio o dominio di primo livello (ad esempio, \$1.amazon.com, amazon.\$1 o \$1.amazon.\$1).

1. Per **Configurazione della raccolta dei dati**, specificare se si desidera che il monitor dell'app raccolga ciascuno dei seguenti elementi:
   + **Telemetria delle prestazioni**— Raccoglie informazioni sul caricamento della pagina e sui tempi di caricamento delle risorse
   + **JavaScript errori**: raccoglie informazioni sugli JavaScript errori non gestiti generati dall'applicazione

     È possibile selezionare **Unminify JavaScript error stack trace per eseguire il debug degli errori** non minimizzati. JavaScript Per utilizzare questa funzionalità, carica i file delle mappe di origine in un bucket o in una cartella Amazon S3 e fornisci l'URI Amazon S3. Una volta abilitata, RUM utilizzerà queste mappe di origine e arricchirà gli eventi di JavaScript errore aggiungendo lo stack trace non minimizzato. Nota che, dopo l'attivazione, questa funzionalità elabora solo nuovi eventi di JavaScript errore e non può essere utilizzata su dati raccolti in precedenza. Per ulteriori informazioni, consulta [Abilitazione della riduzione delle tracce dello stack di JavaScript errori](CloudWatch-RUM-JavaScriptStackTraceSourceMaps.md).
   + **Errori HTTP**— Raccoglie informazioni sugli errori HTTP generati dall'applicazione

   La selezione di queste opzioni fornisce ulteriori informazioni sull'applicazione, ma genera anche più eventi CloudWatch RUM e quindi comporta costi aggiuntivi.

   Se non selezioni nessuna di queste opzioni, l'app monitor raccoglie comunque gli eventi e la pagina di inizio della sessione IDs in modo da poter vedere quanti utenti stanno utilizzando l'applicazione, comprese le suddivisioni per tipo e versione del sistema operativo, tipo e versione del browser, tipo di dispositivo e posizione.

1. Seleziona **Seleziona questa opzione per consentire al CloudWatch RUM Web Client di impostare i cookie** se desideri poter raccogliere utenti IDs e sessioni IDs da sessioni utente campionate. Gli utenti IDs vengono generati casualmente da RUM. Per ulteriori informazioni, consulta [CloudWatch Cookie del client web RUM (o tecnologie simili)](CloudWatch-RUM-privacy.md#CloudWatch-RUM-cookies).

1. Per **Esempi di sessione**, inserire la percentuale di sessioni utente che verranno utilizzate per raccogliere i dati RUM. Il valore di default è 100%. La riduzione di questo numero consente di ottenere meno dati, ma riduce i costi. Per ulteriori informazioni sui prezzi di RUM, consulta [Prezzi di RUM](CloudWatch-RUM.md#RUMpricing).

1. I dati degli utenti finali raccolti per CloudWatch RUM vengono conservati per 30 giorni e quindi eliminati. **Se desideri conservare copie degli eventi RUM nei CloudWatch registri e configurare per quanto tempo conservare tali copie, scegli **Seleziona questa opzione per memorizzare i dati di telemetria dell'applicazione nel tuo account CloudWatch Logs in Archiviazione dati**.** Per impostazione predefinita, il gruppo di CloudWatch log Logs conserva i dati per 30 giorni. È possibile modificare il periodo di conservazione nella console CloudWatch Logs.

1. (Facoltativo) Scegli di aggiungere una policy basata sulle risorse al monitor dell'app per controllare chi può inviare richieste `PutRumEvents` al monitor stesso. Se scegli **Crea policy pubblica**, al monitor dell'app verrà allegata una policy relativa alle risorse che consente a chiunque di inviare richieste `PutRumEvents` al monitor stesso. Per ulteriori informazioni su questo metodo, consulta [Utilizzo di politiche basate sulle risorse con RUM CloudWatch](CloudWatch-RUM-resource-policies.md).

1. Se hai allegato una politica basata sulle risorse nel passaggio precedente, non è necessario firmare le richieste a CloudWatch RUM con le AWS credenziali e puoi saltare la configurazione dell'autorizzazione. Altrimenti, per **Autorizzazione**, specifica se utilizzare un pool di identità Amazon Cognito nuovo o esistente o utilizzare un provider di identità diverso. La creazione di un nuovo pool di identità è l'opzione più semplice che non richiede altri passaggi di configurazione. Per ulteriori informazioni, consultare le [Autorizza la tua applicazione web a inviare dati a AWS](CloudWatch-RUM-get-started-authorization.md).

   La creazione di un nuovo pool di identità Amazon Cognito richiede autorizzazioni amministrative. Per ulteriori informazioni, consulta [Politiche IAM per l'utilizzo di RUM CloudWatch](CloudWatch-RUM-permissions.md).

1. (Facoltativo) Per impostazione predefinita, quando aggiungete lo snippet di codice RUM all'applicazione, il client Web inserisce il JavaScript tag per monitorare l'utilizzo nel codice HTML di tutte le pagine dell'applicazione. Per modificarlo, scegli **Configura le pagine** e poi scegli tra **Includi solo queste pagine** o **Escludi queste pagine**. Quindi, specificare le pagine da includere o escludere. Per specificare una pagina da includere o escludere, inserite la pagina completa. URLs Per specificare pagine aggiuntive, scegli **Aggiungi URL**.

1. Per abilitare il AWS X-Ray tracciamento delle sessioni utente campionate dall'app monitor, scegli **Tracciamento attivo** e seleziona **Trace my** service with. AWS X-Ray

   Se si seleziona questo,`XMLHttpRequest` e `fetch` vengono tracciate le richieste effettuate durante le sessioni utente campionate dal monitor dell'app. È quindi possibile visualizzare tracce e segmenti di queste sessioni utente nel pannello di controllo RUM, dalla mappa di tracciamento X-Ray e dalle pagine dei dettagli della traccia. Queste sessioni utente verranno visualizzate anche come pagine client in [Application Signals](CloudWatch-Application-Monitoring-Sections.md) dopo che l'avrai abilitata per la tua applicazione.

   Apportando ulteriori modifiche alla configurazione del client Web CloudWatch RUM, è possibile aggiungere un'intestazione di traccia X-Ray alle richieste HTTP per consentire il end-to-end tracciamento delle sessioni utente fino ai servizi gestiti a valle. AWS Per ulteriori informazioni, consulta [Abilitazione del tracciamento X-Ray end-to-end](CloudWatch-RUM-modify-snippet.md#CloudWatch-RUM-xraytraceheader).

1. (Facoltativo) Per aggiungere tag al monitor dell'app, seleziona **Tag**, **Aggiungi nuovo tag**.

   Poi, per **Chiave**, inserire un nome per il tag. È possibile aggiungere un valore facoltativo al tag in **Value** (Valore). 

   Per aggiungere un altro tag, scegli nuovamente **Add tag** (Aggiungi tag).

   Per ulteriori informazioni, consulta [Assegnazione di tag alle risorse AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).

1. Scegliere **Aggiungere un monitor app**.

1. Nella sezione **Sample code** (Codice di esempio), puoi copiare lo snippet di codice da aggiungere alla tua applicazione. Ti consigliamo di scegliere **JavaScript**o **TypeScript**utilizzare NPM per installare il client web CloudWatch RUM come modulo. JavaScript

   In alternativa, puoi scegliere **HTML** per utilizzare una rete di distribuzione dei contenuti (CDN) per installare il client web CloudWatch RUM. Lo svantaggio dell'utilizzo di una CDN è che il client Web viene spesso bloccato dalle estensioni di blocco degli annunci pubblicitari.

1. Scegli **Copy** (Copia) o **Download** (Scarica), quindi scegli **Done** (Fatto).