Modifica del frammento di codice per configurare il client web CloudWatch RUM (facoltativo)

È possibile modificare lo snippet di codice prima di inserirlo nell'applicazione, per attivare o disattivare diverse opzioni. Per ulteriori informazioni, consulta la documentazione del client web di CloudWatch RUM.

Ci sono quattro opzioni di configurazione di cui si deve assolutamente essere a conoscenza, come discusso in queste sezioni.

Impedire la raccolta di URL delle risorse che potrebbero contenere informazioni personali

Per impostazione predefinita, il client Web di CloudWatch RUM è configurato per registrare gli URL delle risorse scaricate dall'applicazione. Queste risorse includono file HTML, immagini, file CSS, file JavaScript e così via. Per alcune applicazioni, gli URL possono contenere informazioni personali di identificazione (PII).

Se è così per la vostra applicazione, consigliamo di disattivare la raccolta degli URL delle risorse impostando recordResourceUrl: false nella configurazione dello snippet di codice, prima di inserirlo nell'applicazione.

Registrazione manuale delle visualizzazioni di pagina

Per impostazione predefinita, il client Web registra le visualizzazioni di pagina quando la pagina viene caricata per la prima volta e quando viene chiamata l'API della cronologia del browser. L'ID di pagina predefinito è window.location.pathname. Tuttavia, in alcuni casi potresti voler ignorare questo comportamento e utilizzare l'applicazione per registrare le visualizzazioni di pagina a livello di codice. In questo modo potrai controllare l'ID della pagina e quando viene registrata. Ad esempio, si consideri un'applicazione Web che dispone di un URI con un identificatore variabile, ad esempio /entity/123 o/entity/456. Per impostazione predefinita, CloudWatch RUM genera un evento di visualizzazione della pagina per ogni URI con un ID di pagina distinto corrispondente al percorso, ma puoi decidere di raggrupparli in base allo stesso ID di pagina. A tale scopo, disabilita l'automazione della visualizzazione delle pagine del client Web utilizzando la configurazione disableAutoPageView e utilizza il comando recordPageView per impostare l'ID di pagina desiderato. Per ulteriori informazioni, consulta Configurazioni specifiche dell'applicazione su GitHub.

Esempio di script incorporato:

cwr('recordPageView', { pageId: 'entityPageId' });

Esempio di modulo JavaScript:

awsRum.recordPageView({ pageId: 'entityPageId' });

Abilitazione di tracciamento end-to-end di X-Ray

Quando si crea il monitor dell'app, selezionando Traccia il mio servizio conAWS X-Ray consente il tracciamento di richieste XMLHttpRequest e fetch effettuate durante le sessioni utente che vengono campionate dal monitor dell'app. È quindi possibile visualizzare le tracce di queste richieste HTTP nel pannello di controllo di CloudWatch RUM, dalla mappa ditracciamento X-Ray e dalle pagine dei dettagli della traccia.

Per impostazione predefinita, queste tracce lato client non sono collegate a tracce lato server a valle. Per connettere le tracce lato client alle tracce sul lato server e abilitare il tracciamento end-to-end, impostare l'opzione addXRayTraceIdHeader per true nel client Web. Ciò fa sì che il client Web di CloudWatch RUM aggiunga un'intestazione di traccia X-Ray alle richieste HTTP.

Il seguente blocco di codice mostra un esempio di aggiunta di tracce lato client. Alcune opzioni di configurazione vengono omesse da questo esempio per la leggibilità.

<script>
    (function(n,i,v,r,s,c,u,x,z){...})(
        'cwr',
        '00000000-0000-0000-0000-000000000000',
        '1.0.0',
        'us-west-2',
        'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
        {
            enableXRay: true,
            telemetries: [ 
                'errors', 
                'performance',
                [ 'http', { addXRayTraceIdHeader: true } ]
            ]
        }
    );
</script>

Per ulteriori informazioni, consulta la documentazione del client web di CloudWatch RUM.

Invio di richieste non firmate a CloudWatch RUM

Per impostazione predefinita, il client web RUM firma tutte le richieste inviate a RUM. Se nella configurazione del client imposti signing:false, le richieste non saranno firmate quando vengono inviate a CloudWatch RUM. I dati verranno importati in RUM solo se al monitor dell'app è allegata una policy basata su risorse pubbliche. Per ulteriori informazioni, consulta Utilizzo di policy basate sulle risorse con CloudWatch RUM.