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

Modifica dello snippet di codice per configurare il client web CloudWatch RUM (opzionale)

È 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 CloudWatch RUM.

Ci sono quattro opzioni di configurazione che dovreste assolutamente conoscere, come illustrato in queste sezioni.

Impedire la raccolta di risorse URLs che potrebbero contenere informazioni personali

Per impostazione predefinita, il client web CloudWatch RUM è configurato per registrare le URLs risorse scaricate dall'applicazione. Queste risorse includono file HTML, immagini, file CSS, JavaScript file e così via. Per alcune applicazioni, URLs può contenere informazioni di identificazione personale (PII).

Se questo è il caso della tua applicazione, ti consigliamo vivamente di disabilitare la raccolta di risorse URLs impostando la configurazione dello snippet di codice, prima di inserirla recordResourceUrl: false 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 che corrisponde al percorso, ma potresti preferire 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, vedere Configurazioni specifiche dell'applicazione su. GitHub

Esempio di script incorporato:

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

JavaScript esempio di modulo:

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

Abilitazione del tracciamento X-Ray end-to-end

Quando si crea il monitor dell'app, selezionando Traccia il mio servizio con AWS 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 nella dashboard CloudWatch RUM e nelle pagine X-Ray Trace Map e Trace details.

Per impostazione predefinita, queste tracce lato client non sono collegate a tracce lato server a valle. Per connettere le tracce lato client alle tracce lato server e abilitare la end-to-end traccia, imposta l'addXRayTraceIdHeaderopzione su Nel client Web. true Questo fa sì che il client web 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 CloudWatch RUM

Invio di richieste non firmate a RUM CloudWatch

Per impostazione predefinita, il client web RUM firma tutte le richieste inviate a RUM. Se lo imposti signing:false nella configurazione del client, 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 politica basata su risorse pubbliche. Per ulteriori informazioni, consulta Utilizzo di politiche basate sulle risorse con RUM CloudWatch .