Creazione di un monitor dell'app in CloudWatch RUM - Amazon CloudWatch

Creazione di un monitor dell'app in CloudWatch RUM

Per iniziare a utilizzare CloudWatch RUM con la tua applicazione, creare un monitor dell'app. Quando viene creato il monitor dell'app, RUM genera uno snippet JavaScript da incollare nell'applicazione. Lo snippet inserisce il codice del client Web RUM. Il client Web RUM acquisisce i dati da una percentuale delle sessioni utente dell'applicazione e li invia a RUM.

Creazione di un monitor dell'app

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

  2. Nel riquadro di navigazione, scegli Application Signals, RUM.

  3. Scegli Aggiungere un monitor app.

  4. Inserire le informazioni e le impostazioni per la propria applicazione:

    • Per Nome del monitor app, inserire un nome da utilizzare per identificare questo monitor dell'app all'interno della console RUM di CloudWatch.

    • 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, *.amazon.com, amazon.* o *.amazon.*).

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

    • Errori JavaScript— Raccoglie informazioni sugli errori JavaScript non gestiti generati dall'applicazione

      Puoi selezionare Deminifica le tracce di stack degli errori JavaScript per eseguire il debug degli errori JavaScript deminificati. 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 abilitato, RUM utilizzerà queste mappe di origine e arricchirà gli eventi di errore JavaScript aggiungendo la traccia di stack deminificata. Tieni presente che dopo l'attivazione, questa funzionalità elabora solo i nuovi eventi di errore JavaScript e non può essere utilizzata su dati raccolti in precedenza. Per ulteriori informazioni, consulta Abilitazione della deminificazione delle tracce di stack degli errori JavaScript.

    • Errori HTTP— Raccoglie informazioni sugli errori HTTP generati dall'applicazione

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

    Se non si seleziona nessuno di questi, il monitor dell'app raccoglie ancora gli eventi di avvio della sessione e gli ID di pagina in modo da poter vedere quanti utenti utilizzano l'applicazione, inclusi i guasti per tipo e versione del sistema operativo, tipo e versione del browser, tipo di dispositivo e posizione.

  6. Seleziona Seleziona questa opzione per consentire a CloudWatch RUM Web Client di impostare i cookie se vuoi poter raccogliere ID utente e ID di sessione da sessioni utente campionate. Gli ID utente vengono generati casualmente da RUM. Per ulteriori informazioni, consulta Cookie web client di CloudWatch RUM (o tecnologie simili).

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

  8. I dati dell'utente finale raccolti per CloudWatch RUM vengono conservati per 30 giorni e quindi eliminati. Se desideri conservare copie degli eventi RUM in CloudWatch Logs e configurare per quanto tempo conservare queste copie, scegli Seleziona questa opzione per archiviare i dati di telemetria delle applicazioni nel tuo account CloudWatch Logs sotto Archiviazione dati. Per impostazione predefinita, il gruppo di log di CloudWatch Logs conserva i dati per 30 giorni. Puoi gestire il periodo di conservazione dei log nella console CloudWatch Logs.

  9. (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 policy basate sulle risorse con CloudWatch RUM.

  10. Se hai allegato una policy basata sulle risorse nel passaggio 9, non è necessario firmare le richieste a CloudWatch RUM con le credenziali AWS 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, consulta le Passaggio 1: autorizzare la richiesta a inviare dati a AWS.

    La creazione di un nuovo pool di identità Amazon Cognito richiede autorizzazioni amministrative. Per ulteriori informazioni, consulta Policy IAM per l'utilizzo di CloudWatch RUM.

  11. (Facoltativo) Per impostazione predefinita, quando si aggiunge lo snippet di codice RUM all'applicazione, il client Web inietta il tag JavaScript 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, inserire gli URL completi. Per specificare pagine aggiuntive, scegli Aggiungi URL.

  12. Per abilitare il tracciamento dello AWS X-Ray delle sessioni utente campionate dal monitor dell'app, scegli Tracciamento attivo e seleziona Traccia il mio servizio con 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 dopo che l'avrai abilitata per la tua applicazione.

    Apportando ulteriori modifiche alla configurazione al client Web di CloudWatch RUM, è possibile aggiungere un'intestazione di traccia X-Ray alle richieste HTTP per abilitare il tracciamento end-to-end delle sessioni utente fino ai servizi gestiti a valle di AWS. Per ulteriori informazioni, consulta Abilitazione di tracciamento end-to-end di X-Ray.

  13. (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.

  14. Scegliere Aggiungere un monitor app.

  15. 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 e utilizzare NPM per installare il client Web di CloudWatch RUM come modulo JavaScript.

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

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