Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ändern des Codeausschnitts zur Konfiguration des CloudWatch RUM-Webclients (optional)

Sie können den Codeausschnitt ändern, bevor Sie ihn in Ihre Anwendung einfügen, um mehrere Optionen zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie in der CloudWatch RUM-Webclient-Dokumentation.

Es gibt drei Konfigurationsoptionen, die Sie unbedingt beachten sollten, wie in diesen Abschnitten beschrieben.

Verhinderung der Erfassung von Ressourcen URLs , die persönliche Informationen enthalten könnten

Standardmäßig ist der CloudWatch RUM-Webclient so konfiguriert, dass er die URLs von der Anwendung heruntergeladenen Ressourcen aufzeichnet. Zu diesen Ressourcen gehören HTML-Dateien, Bilder, JavaScript CSS-Dateien, Dateien usw. Bei einigen Anwendungen URLs können sie persönlich identifizierbare Informationen (PII) enthalten.

Wenn dies bei Ihrer Anwendung der Fall ist, empfehlen wir Ihnen dringend, die Erfassung von Ressourcen zu deaktivieren, URLs indem Sie dies recordResourceUrl: false in der Konfiguration des Codeausschnitts festlegen, bevor Sie sie in Ihre Anwendung einfügen.

Manuelle Aufzeichnung von Seitenaufrufen

Standardmäßig zeichnet der Webclient Seitenaufrufe auf, wenn die Seite zum ersten Mal geladen wird und wenn die Browser-Verlaufs-API aufgerufen wird. Die Standardseiten-ID ist window.location.pathname. In manchen Fällen möchten Sie dieses Verhalten jedoch außer Kraft setzen und die Anwendung so instrumentieren, dass die Seitenaufrufe programmatisch aufgezeichnet werden. Auf diese Weise haben Sie die Kontrolle über die Seiten-ID und den Zeitpunkt ihrer Aufzeichnung. Nehmen wir zum Beispiel eine Webanwendung, die eine URI mit einer variablen ID hat, wie /entity/123 oder /entity/456. Standardmäßig generiert CloudWatch RUM für jeden URI ein Seitenaufrufereignis mit einer eindeutigen Seiten-ID, die dem Pfadnamen entspricht. Möglicherweise möchten Sie sie jedoch stattdessen nach derselben Seiten-ID gruppieren. Deaktivieren Sie dazu in der disableAutoPageView-Konfiguration die Automatisierung der Seitenansicht des Webclients und verwenden Sie den Befehl recordPageView zum Festlegen der gewünschten Seiten-ID. Weitere Informationen finden Sie unter Anwendungsspezifische Konfigurationen unter. GitHub

Beispiel für eingebettetes Skript:

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

JavaScript Beispiel für ein Modul:

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

X-Ray end-to-end Tracing aktivieren

Wenn Sie die App-Überwachung erstellen, wählen Sie Meinen Service nachverfolgen mit AWS X-Ray aus. Dies ermöglicht das Nachverfolgen von XMLHttpRequest- und fetch-Anforderungen, die während Benutzersitzungen gestellt werden, die von der App-Überwachung als Stichprobe ausgewählt werden. Sie können dann die Traces dieser HTTP-Anfragen im CloudWatch RUM-Dashboard sowie auf den Seiten X-Ray Trace Map und Trace-Details sehen.

Standardmäßig sind diese clientseitigen Ablaufverfolgungen nicht mit nachgelagerten serverseitigen Ablaufverfolgungen verbunden. Um clientseitige Traces mit serverseitigen Traces zu verbinden und end-to-end Tracing zu aktivieren, setzen Sie die addXRayTraceIdHeader Option true im Webclient auf. Dadurch fügt der CloudWatch RUM-Webclient HTTP-Anfragen einen X-Ray-Trace-Header hinzu.

Der folgende Codeblock zeigt ein Beispiel für das Hinzufügen clientseitiger Ablaufverfolgungen. Einige Konfigurationsoptionen werden aus diesem Beispiel zu Gunsten der Lesbarkeit weggelassen.

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

Weitere Informationen finden Sie in der CloudWatch RUM-Webclient-Dokumentation