Erstellen einer CloudWatch-RUM-App-Überwachung

App-Überwachung erstellen

1. Öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie im Navigationsbereich Application Signals, RUM.

3. Wählen Sie Add app monitor (App-Überwachung hinzufügen) aus.

4. Geben Sie die Informationen und Einstellungen für Ihre Anwendung ein:

   • Geben Sie für Name der App-Überwachung einen Namen ein, der zur Identifizierung dieser App-Überwachung in der CloudWatch-RUM-Konsole verwendet werden soll.

   • Geben Sie für Domainliste der Anwendung die registrierten Domainnamen ein, unter denen Ihre Anwendung über Verwaltungsberechtigung verfügt. Sie können auch ein Platzhalterzeichen * verwenden, um jede Subdomain oder Top-Level-Domains (z. B. *.amazon.com, amazon.*, *.amazon.*) zuzulassen.

5. Geben Sie für Configure RUM data collection (RUM-Datensammlung konfigurieren) an, ob die App-Überwachung alle folgenden Aspekte sammeln soll:

   • Performance-Telemetrie – Sammelt Informationen über Seitenlade- und Ressourcenladezeiten

   • JavaScript-Fehler – Sammelt Informationen über nicht behandelte JavaScript-Fehler, die von Ihrer Anwendung gemeldet werden

     Sie können Fehler-Stack-Traces zur Aufhebung der Minimierung von JavaScript auswählen, um Fehler zu nicht minimierten JavaScripts zu beheben. Um dieses Feature zu nutzen, laden Sie Ihre Quellkartendateien in einen Amazon-S3-Bucket oder -Ordner hoch und geben Sie die Amazon-S3-URI an. Nach der Aktivierung verwendet RUM diese Quellkarten und reichert JavaScript-Fehlerereignisse durch Hinzufügen des nicht minimierten Stack-Trace an. Beachten Sie, dass dieses Feature nach der Aktivierung nur neue JavaScript-Fehlerereignisse verarbeitet und nicht für zuvor gesammelte Daten verwendet werden kann. Weitere Informationen finden Sie unter Aktivierung der Aufhebung der Minimierung von JavaScript-Fehler-Stack-Traces.

   • HTTP-Fehler – Sammelt Informationen über HTTP-Fehler, die von Ihrer Anwendung ausgegeben werden

   Wenn Sie diese Optionen auswählen, erhalten Sie weitere Informationen über Ihre Anwendung. Es werden aber auch weitere CloudWatch-RUM-Ereignisse generiert und es entstehen somit mehr Gebühren.

   Wenn Sie keine dieser Optionen auswählen, sammelt die App-Überwachung weiterhin Sitzungsstartereignisse und Seiten-IDs, sodass Sie sehen, wie viele Benutzer Ihre Anwendung verwenden. Sie können außerdem Störungen nach Betriebssystemtyp und -version, Browsertyp und -version, Gerätetyp und Speicherort anzeigen.

6. Wählen Sie Check this option to allow the CloudWatch RUM Web Client to set cookies (Aktivieren Sie diese Option, damit der CloudWatch-RUM-Webclient Cookies festlegen kann) aus, wenn Sie Benutzer-IDs und Sitzungs-IDs aus Stichproben-Benutzersitzungen sammeln möchten. Die Benutzer-IDs werden nach dem Zufallsprinzip von RUM generiert. Weitere Informationen finden Sie unter CloudWatch-RUM-Webclient-Cookies (oder ähnliche Technologien).

7. Geben Sie für Session samples (Sitzungsbeispiele) den Prozentsatz der Benutzersitzungen ein, die zum Sammeln von RUM-Daten verwendet werden. Der Standardwert ist 100 %. Wenn Sie diese Zahl reduzieren, erhalten Sie weniger Daten und die Gebühren sinken. Weitere Informationen zu den Preisen für RUM erhalten Sie unter RUM – Preise.

8. Endbenutzerdaten, die Sie für CloudWatch RUM sammeln, werden 30 Tage lang aufbewahrt und danach gelöscht. Wenn Sie Kopien von RUM-Ereignissen in CloudWatch Logs behalten und konfigurieren möchten, wie lange diese Kopien aufbewahrt werden sollen, wählen Sie unter Data Storage (Datenspeicher) Check this option to store your application telemetry data in your CloudWatch Logs account (Aktivieren Sie diese Option, um Ihre Anwendungstelemetriedaten in Ihrem CloudWatch-Logs-Konto zu speichern) aus. Standardmäßig speichert die CloudWatch-Logs-Protokollgruppe die Daten 30 Tage lang. Sie können den Aufbewahrungszeitraum in der CloudWatch-Logs-Konsole anpassen.

9. (Optional) Fügen Sie Ihrer App-Überwachung eine ressourcenbasierte Richtlinie hinzu, um zu steuern, wer PutRumEvents-Anforderungen an Ihre App-Überwachung senden kann. Wenn Sie Öffentliche Richtlinie erstellen wählen, wird eine Ressourcenrichtlinie an Ihre App-Überwachung angehängt, die es jedem ermöglicht, PutRumEvents-Anforderungen an Ihre App-Überwachung zu senden. Weitere Informationen zu dieser Methode finden Sie unter Verwenden von ressourcenbasierten Richtlinien in CloudWatch RUM.

10. Wenn Sie in Schritt 9 eine ressourcenbasierte Richtlinie angehängt haben, müssen Sie Anforderungen an CloudWatch RUM nicht mit AWS-Anmeldeinformationen signieren, und Sie können die Einrichtung der Autorisierung überspringen. Geben Sie ansonsten für Autorisierung an, ob Sie einen neuen oder vorhandenen Amazon-Cognito-Identitätspool oder einen anderen Identitätsanbieter verwenden möchten. Das Erstellen eines neuen Identitätspools ist die einfachste Option, die keine anderen Einrichtungsschritte erfordert. Weitere Informationen hierzu finden Sie unter Schritt 1: Autorisieren Sie Ihre Anwendung, um Daten an AWS zu senden..

    Das Erstellen eines neuen Amazon-Cognito-Identitätspools erfordert Administratorberechtigungen. Weitere Informationen finden Sie unter IAM-Richtlinien zur Verwendung von CloudWatch RUM.

11. (Optional) Wenn Sie den RUM-Codeausschnitt zu Ihrer Anwendung hinzufügen, injiziert der Webclient standardmäßig das JavaScript-Tag, um die Verwendung des HTML-Code aller Seiten Ihrer Anwendung zu überwachen. Um dies zu ändern, wählen Sie Configure pages (Seiten konfigurieren) und anschließend entweder Include only these pages (Nur diese Seiten einschließen) oder Exclude these pages (Diese Seiten ausschließen) aus. Geben Sie dann die Seiten an, die ein- oder ausgeschlossen werden sollen. Um eine Seite anzugeben, die ein- oder ausgeschlossen werden soll, geben Sie die vollständigen URLs ein. Um zusätzliche Seiten anzugeben, wählen Sie Add URL (URL hinzufügen) aus.

12. Um die AWS X-Ray-Nachverfolgung von Benutzersitzungen zu aktivieren, die von der App-Überwachung als Stichprobe ausgewählt werden, wählen Sie Aktive Nachverfolgung und dann Meinen Service nachverfolgen mitAWS X-Ray aus.

    Wenn Sie diese Auswahl treffen, werden XMLHttpRequest- und fetch-Anforderungen, die während Benutzersitzungen, die von der App-Überwachung im Rahmen einer Stichprobe ausgewählt werden, nachverfolgt. Sie sehen dann Ablaufverfolgungen und Segmente aus diesen Benutzersitzungen im RUM-Dashboard sowie die X-Ray-Trace-Karte und die Trace-Detailseiten. Diese Benutzersitzungen werden auch als Client-Seiten in Application Signals angezeigt, nachdem Sie sie für Ihre Anwendung aktiviert haben.

    Indem Sie zusätzliche Konfigurationsänderungen am CloudWatch-RUM-Webclient vornehmen, können Sie HTTP-Anfragen einen X-Ray-Ablaufverfolgungs-Header hinzufügen, um die End-to-End-Verfolgung von Benutzersitzungen bis zu verwalteten AWS-Downstream-Services zu aktivieren. Weitere Informationen finden Sie unter Aktivieren der End-to-End-Ablaufverfolgung von X-Ray.

13. (Optional) Um Tags zur App-Überwachung hinzuzufügen, wählen Sie Tags (Tags), Add new tag (Neues Tag hinzufügen) aus.

    Geben Sie für Key (Schlüssel) einen Namen für das Tag ein. Sie können einen optionalen Wert für das Tag unter Value (Wert) hinzufügen.

    (Optional) Zum Hinzufügen eines weiteren Tags wählen Sie Add new tag (Neues Tag hinzufügen) erneut aus.

    Weitere Informationen finden Sie unter Markieren von AWS-Ressourcen.

14. Wählen Sie Add app monitor (App-Überwachung hinzufügen) aus.

15. Im Abschnitt Sample code (Beispiel-Code) können Sie den Codeausschnitt kopieren, um ihn in Ihre Anwendung einzufügen. Wir empfehlen Ihnen, JavaScript oder TypeScript zu wählen und NPM zu verwenden, um den CloudWatch RUM-Webclient als JavaScript-Modul zu installieren.

    Alternativ können Sie HTML wählen, um ein Content Delivery Network (CDN) für die Installation des CloudWatch RUM-Webclients zu verwenden. Der Nachteil der Verwendung eines CDN ist, dass der Webclient oft von Werbeblockern blockiert wird.

16. Wählen Sie Copy (Kopieren) oder Download (Herunterladen), und klicken Sie dann auf Done (Fertig).