Creazione di un monitor per app CloudWatch RUM - Amazon CloudWatch

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 per app CloudWatch RUM

Per iniziare a utilizzare CloudWatch RUM con la tua applicazione, devi creare un app monitor. Quando viene creato l'app monitor, RUM genera uno JavaScript snippet 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 CloudWatch console 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 il nome del monitor dell'app, inserisci un nome da utilizzare per identificare questo app monitor all'interno della console CloudWatch RUM.

    • Per l'elenco dei domini dell'applicazione, inserisci i nomi di dominio registrati su cui l'applicazione ha l'autorità amministrativa. Puoi anche utilizzare un carattere jolly * per consentire qualsiasi sottodominio o dominio di primo livello (ad esempio, *.amazon.com, amazon.*, *.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

    • JavaScript errori: JavaScript raccoglie informazioni sugli 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.

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

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

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

  9. (Facoltativo) Scegli di aggiungere una policy basata sulle risorse al monitor dell'app per controllare chi può inviare PutRumEvents richieste al monitor dell'app. Se scegli Crea policy pubblica, al monitor dell'app verrà allegata una policy relativa alle risorse che consente a chiunque di inviare PutRumEvents richieste al monitor dell'app. Per ulteriori informazioni su questo metodo, consultaUtilizzo di politiche basate sulle risorse con RUM CloudWatch .

  10. Se hai allegato una politica basata sulle risorse nel passaggio 9, non è necessario firmare le richieste a CloudWatch RUM con le AWS credenziali e puoi saltare l'impostazione dell'autorizzazione. Altrimenti, per l'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: autorizza l'applicazione a inviare dati a AWS.

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

  11. (Facoltativo) Per impostazione predefinita, quando aggiungi 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.

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

  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 Tagging Resources. AWS

  14. Scegli 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 JavaScripto TypeScriptutilizzare NPM per installare il client web CloudWatch RUM come JavaScript modulo.

    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.

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