Einen CloudWatch RUM-App-Monitor erstellen

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

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 unter Name des App-Monitors einen Namen ein, der zur Identifizierung dieses App-Monitors in der CloudWatch RUM-Konsole verwendet werden soll.

   • Geben Sie unter Liste der Anwendungsdomänen die registrierten Domainnamen ein, für die Ihre Anwendung über Administratorrechte 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 unbehandelte Fehler, die in Ihrer Anwendung aufgetreten sind JavaScript

     Sie können Unminify JavaScript Error-Stack-Traces auswählen, um nicht minimierte Fehler zu debuggen. JavaScript Um diese Funktion zu nutzen, laden Sie Ihre Quellzuordnungsdateien in einen Amazon S3 S3-Bucket oder -Ordner hoch und geben Sie die Amazon S3 S3-URI an. Nach der Aktivierung verwendet RUM diese Quellzuordnungen und bereichert JavaScript Fehlerereignisse durch Hinzufügen des nicht minimierten Stack-Trace. Beachten Sie, dass diese Funktion 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 Entminimierung von JavaScript Error-Stack-Traces.

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

   Wenn Sie diese Optionen auswählen, erhalten Sie mehr Informationen zu Ihrer Anwendung, es werden jedoch auch mehr CloudWatch RUM-Ereignisse generiert, sodass mehr Gebühren anfallen.

   Wenn Sie keine dieser Optionen auswählen, erfasst der App Monitor dennoch Ereignisse und Seiten zum Sitzungsstart, IDs sodass Sie sehen können, wie viele Benutzer Ihre Anwendung verwenden, einschließlich Aufschlüsselungen nach Betriebssystemtyp und -version, Browsertyp und -version, Gerätetyp und Standort.

6. Wählen Sie Diese Option aktivieren, damit der CloudWatch RUM-Webclient Cookies setzen kann, wenn Sie Benutzer IDs und Sitzung anhand IDs von Stichproben von Benutzersitzungen erfassen 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 anschließend gelöscht. Wenn Sie Kopien von RUM-Ereignissen in CloudWatch Logs speichern und konfigurieren möchten, wie lange diese Kopien aufbewahrt werden sollen, wählen Sie Diese Option aktivieren, um Ihre Anwendungstelemetriedaten in Ihrem CloudWatch Logs-Konto unter Datenspeicher zu speichern. Standardmäßig speichert die Protokollgruppe CloudWatch Logs die Daten 30 Tage lang. Sie können den Aufbewahrungszeitraum in der CloudWatch Logs-Konsole anpassen.

9. (Optional) Fügen Sie Ihrem App Monitor eine ressourcenbasierte Richtlinie hinzu, um zu steuern, wer PutRumEvents Anfragen an Ihren App Monitor senden kann. Wenn Sie Öffentliche Richtlinie erstellen wählen, wird eine Ressourcenrichtlinie an Ihren App Monitor angehängt, die es jedem ermöglicht, PutRumEvents Anfragen an Ihren App Monitor zu senden. Weitere Informationen zu dieser Methode finden Sie unterVerwendung ressourcenbasierter Richtlinien mit RUM CloudWatch .

10. Wenn Sie in Schritt 9 eine ressourcenbasierte Richtlinie angehängt haben, müssen Sie Anfragen an CloudWatch RUM nicht mit AWS Anmeldeinformationen signieren, und Sie können die Einrichtung der Autorisierung überspringen. Geben Sie andernfalls für Autorisierung an, ob Sie einen neuen oder vorhandenen Amazon Cognito 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 zum Senden von Daten an AWS.

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

11. (Optional) Wenn Sie den RUM-Codeausschnitt zu Ihrer Anwendung hinzufügen, fügt der Webclient das JavaScript Tag zur Überwachung der Nutzung standardmäßig in den HTML-Code aller Seiten Ihrer Anwendung ein. 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ändige Seite ein. URLs Um zusätzliche Seiten anzugeben, wählen Sie Add URL (URL hinzufügen) aus.

12. Um die AWS X-Ray Ablaufverfolgung der Benutzersitzungen zu aktivieren, die vom App Monitor erfasst werden, wählen Sie Aktives Tracing und dann Meinen Service verfolgen mit aus. AWS X-Ray

    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-Trace-Header hinzufügen, um die end-to-end Nachverfolgung von Benutzersitzungen bis hin zu nachgeschalteten AWS Managed Services zu ermöglichen. Weitere Informationen finden Sie unter X-Ray end-to-end Tracing aktivieren.

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 Ressourcen taggen AWS.

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, dass Sie JavaScriptoder wählen TypeScriptund NPM verwenden, CloudWatch um den RUM-Webclient als JavaScript Modul zu installieren.

    Alternativ können Sie HTML wählen, um ein Content Delivery Network (CDN) zur 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).