Konfiguration des RUM-Webclients CloudWatch - Amazon CloudWatch

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.

Konfiguration des RUM-Webclients CloudWatch

Ihre Anwendungen können eines der von RUM generierten Codefragmente verwenden, um den CloudWatch CloudWatch RUM-Webclient zu installieren. Die generierten Codefragmente unterstützen zwei Installationsmethoden: als JavaScript Modul über NPM oder über ein Content Delivery Network (CDN). Um die beste Leistung zu erzielen, empfehlen wir die NPM-Installationsmethode. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Als Modul installieren. JavaScript

Wenn Sie die CDN-Installationsoption verwenden, blockieren Werbeblocker möglicherweise das von RUM bereitgestellte Standard-CDN. CloudWatch Damit wird die Anwendungsüberwachung für Benutzer deaktiviert, die Werbeblocker installiert haben. Aus diesem Grund empfehlen wir, das Standard-CDN nur für das erste Onboarding mit RUM zu verwenden. CloudWatch Weitere Informationen zur Behebung dieses Problems finden Sie unter Instrumentierung dieser Anwendung.

Der Codeausschnitt befindet sich im <head>-Tag einer HTML-Datei und installiert den Webclient, indem es den Webclient herunterlädt und ihn dann für die zu überwachende Anwendung konfiguriert. Der Ausschnitt ist eine selbstausführende Funktion, die wie folgt aussieht. In diesem Beispiel wurde ein Großteil der Funktion des Ausschnitts 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', { /* Configuration Options Here */ } ); <script>

Argumente

Der Codeausschnitt akzeptiert sechs Argumente:

  • Ein Namespace zum Ausführen von Befehlen auf dem Webclient, wie 'cwr'

  • Die ID der App-Überwachung, wie z. B. '00000000-0000-0000-0000-000000000000'

  • Die Anwendungsversion wie z. B. '1.0.0'

  • Die AWS Region des App-Monitors, z. B. 'us-west-2'

  • Die URL des Web-Clients wie z. B. 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js'

  • Anwendungsspezifische Konfigurationsoptionen. Weitere Informationen finden Sie im folgenden Abschnitt.

Ignorieren von Fehlern

Der CloudWatch RUM-Webclient überwacht alle Arten von Fehlern, die in Ihren Anwendungen auftreten. Wenn Ihre Anwendung JavaScript Fehler ausgibt, die Sie nicht im CloudWatch RUM-Dashboard anzeigen möchten, können Sie den RUM-Webclient so konfigurieren, dass diese Fehler herausgefiltert werden, sodass Sie nur die relevanten Fehlerereignisse im CloudWatch RUM-Dashboard sehen. CloudWatch Sie könnten sich beispielsweise dafür entscheiden, einige JavaScript Fehler nicht im Dashboard anzuzeigen, weil Sie bereits eine Lösung für sie gefunden haben und die Menge dieser Fehler andere Fehler maskiert. Unter Umständen möchten Sie auch Fehler ignorieren, die Sie nicht beheben können, da sie mit einer Bibliothek eines Drittanbieters zusammenhängen.

Weitere Informationen zur Instrumentierung des Webclients zum Herausfiltern bestimmter JavaScript Fehler finden Sie im Beispiel unter Fehler in der Github-Dokumentation für den Webclient.

Konfigurationsoptionen

Informationen zu den für den CloudWatch RUM-Webclient verfügbaren Konfigurationsoptionen finden Sie in der CloudWatch RUM-Webclient-Dokumentation