Schritt 2: Erstellen Sie einer App-Überwachung

Um die Verwendung CloudWatch RUM mit Ihrer Anwendung zu beginnen, erstellen Sie einen App-Monitor. Wenn der App-Monitor erstellt wird, RUM generiert er einen JavaScript Ausschnitt, den Sie in Ihre Anwendung einfügen können. Das Snippet ruft den Webclient-Code ab. RUM Der RUM Webclient erfasst Daten aus einem bestimmten Prozentsatz der Benutzersitzungen Ihrer Anwendung und sendet sie an. RUM

App-Überwachung erstellen

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

2. Wählen Sie im Navigationsbereich Application Signals, aus 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 unter Name des App-Monitors einen Namen ein, der zur Identifizierung dieses App-Monitors in der CloudWatch RUM Konsole verwendet werden soll.

   • Geben Sie für Domain der Anwendung den Domainnamen der obersten Ebene ein, unter der Ihre Anwendung über Verwaltungsberechtigung verfügt. Dieser muss in einem URL Domänenformat vorliegen.

     Wählen Sie Include sub domains (Untergeordnete Domains einbeziehen) aus, damit die App-Überwachung auch Daten von allen untergeordneten Domains unter der Domain der obersten Ebene sammelt.

5. Geben Sie unter RUM Datenerfassung konfigurieren an, ob der App Monitor die folgenden Daten erfassen soll:

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

   • JavaScript Fehler — Sammelt Informationen über unbehandelte JavaScript Fehler, die von Ihrer Anwendung ausgelöst wurden

   • HTTPFehler — Sammelt Informationen über HTTP Fehler, die von Ihrer Anwendung ausgelöst wurden

   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 trotzdem Sitzungsstarts und die Seite, 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 generiert vonRUM. Weitere Informationen finden Sie unter CloudWatch RUMWebclient-Cookies (oder ähnliche Technologien).

7. Geben Sie für 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 zur RUM Preisgestaltung finden Sie unter RUMPreise.

8. Endbenutzerdaten, für CloudWatch RUM die Sie sammeln, werden 30 Tage lang aufbewahrt und dann 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. Geben Sie für Authorization (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 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 IAMZu verwendende Richtlinien CloudWatch RUM.

10. (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 weitere Seiten anzugeben, wählen Sie Hinzufügen URL.

11. 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 können dann Traces und Segmente aus diesen Benutzersitzungen im RUM Dashboard sowie auf den Seiten mit der X-Ray-Trace-Map und den Trace-Details sehen. 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.

12. (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 kennzeichnen. AWS

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

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

    Sie können auch ein Content Delivery Network (CDN) für die Installation des CloudWatch RUM Webclients verwenden. HTML Der Nachteil der Verwendung von a CDN besteht darin, dass der Webclient häufig durch Werbeblocker blockiert wird.

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