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 del frammento di codice per configurare il client web (opzionale) CloudWatch RUM

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

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

Impedire la raccolta di risorse URLs che potrebbero contenere informazioni personali

Per impostazione predefinita, il client CloudWatch RUM Web è configurato per registrare URLs le risorse scaricate dall'applicazione. Queste risorse includono HTML file, immagini, CSS file, 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 richiamata la cronologia API 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 identificatore URI con una variabile, ad esempio /entity/123 o/entity/456. Per impostazione predefinita, CloudWatch RUM genera un evento di visualizzazione della pagina per ognuna URI con un ID di pagina distinto corrispondente al percorso, ma potresti invece volerli raggruppare 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' });

JavaScript esempio di modulo:

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

Abilitazione del tracciamento X-Ray end-to-end

Quando crei l'app monitor, selezionando Trace my service with AWS X-Rayabilita il tracciamento XMLHttpRequest e fetch le richieste effettuate durante le sessioni utente che vengono campionate dal monitor dell'app. È quindi possibile visualizzare le tracce di queste HTTP richieste nella CloudWatch RUM dashboard 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 Ciò fa sì che il client CloudWatch RUM Web 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 CloudWatch RUM Web