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. # Benutzerdefinierte Metriken und erweiterte Messwerte, an die Sie senden können CloudWatch Standardmäßig senden RUM-App-Monitore Metriken an. CloudWatch Diese Standardmetriken und -dimensionen sind in [CloudWatch Metriken aufgeführt, die Sie mit CloudWatch RUM sammeln können](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html). Sie können auch eine App-Überwachung einrichten, um Metriken zu exportieren. Die App-Überwachung kann erweiterte Metriken, benutzerdefinierte Metriken oder beides senden. Es kann sie an senden CloudWatch. + **Benutzerdefinierte Metriken** — Benutzerdefinierte Metriken sind Metriken, die Sie definieren. Bei benutzerdefinierten Metriken können Sie einen beliebigen Metriknamen und Namespace verwenden. Um die Metriken zu erhalten, können Sie beliebige benutzerdefinierte Ereignisse, integrierte Ereignisse, benutzerdefinierte Attribute oder Standardattribute verwenden. Sie können benutzerdefinierte Metriken an senden CloudWatch. + **Erweiterte Metriken** — Sie können jede der CloudWatch Standard-RUM-Metriken CloudWatch mit zusätzlichen Dimensionen an senden. Auf diese Weise können diese Metriken Ihnen einen detaillierteren Überblick verschaffen. **Topics** + [Benutzerdefinierte Metriken](#CloudWatch-RUM-custom-metrics) + [Erweiterte Metriken](#CloudWatch-RUM-vended-metrics) ## Benutzerdefinierte Metriken Um benutzerdefinierte Metriken zu senden, müssen Sie die AWS APIs oder AWS CLI anstelle der Konsole verwenden. Weitere Informationen zur Verwendung von finden Sie unter [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)und [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). AWS APIs Die maximale Anzahl von erweiterten und benutzerdefinierten Metrikdefinitionen, die ein Ziel enthalten kann, beträgt 2 000. Für jede benutzerdefinierte Metrik oder erweiterte Metrik, die Sie an jedes Ziel senden, zählt jede Kombination aus Dimensionsname und Dimensionswert für dieses Limit. Für benutzerdefinierte Messwerte, die aus Ereignissen oder Attributen von CloudWatch RUM abgeleitet wurden, fallen keine Gebühren an. Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Metrik erstellen, die von einem benutzerdefinierten Ereignis abgeleitet ist. Hier das Beispiel für das verwendete benutzerdefinierte Ereignis: ``` cwr('recordEvent', { type: 'my_custom_event', data: { location: 'IAD', current_url: 'amazonaws.com', user_interaction: { interaction_1 : "click", interaction_2 : "scroll" }, visit_count:10 } }) ``` Mit diesem benutzerdefinierten Ereignis können Sie eine benutzerdefinierte Metrik erstellen, die die Anzahl der Besuche auf der URL `amazonaws.com` von Chrome-Browsern aus zählt. Die folgende Definition erstellt eine Metrik namens `AmazonVisitsCount` in Ihrem Konto im `RUM/CustomMetrics/PageVisits`-Namespace. ``` { "AppMonitorName":"customer-appMonitor-name", "Destination":"CloudWatch", "MetricDefinitions":[ { "Name":"AmazonVisitsCount", "Namespace":"PageVisit", "ValueKey":"event_details.visit_count", "UnitLabel":"Count", "DimensionKeys":{ "event_details.current_url": "URL" }, "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" } ] } ``` ## Erweiterte Metriken Wenn Sie erweiterte Metriken einrichten, können Sie jede der CloudWatch Standard-RUM-Metriken CloudWatch mit zusätzlichen Dimensionen an senden, sodass Sie anhand der Metriken einen detaillierteren Überblick erhalten. Weitere Informationen zu den CloudWatch Standard-RUM-Metriken finden Sie unter. [CloudWatch Metriken, die Sie mit CloudWatch RUM sammeln können](CloudWatch-RUM-metrics.md) Die maximale Anzahl von erweiterten und benutzerdefinierten Metrikdefinitionen, die ein Ziel enthalten kann, beträgt 2 000. Für jede erweiterte oder benutzerdefinierte Metrik, die Sie an jedes Ziel senden, zählt jede Kombination aus Dimensionsname und Dimensionswert als eine erweiterte Metrik für dieses Limit. Wenn Sie erweiterte Messwerte an senden CloudWatch, können Sie die CloudWatch RUM-Konsole verwenden, um CloudWatch Alarme für sie zu erstellen. Erweiterte Metriken, die für die Standardmetriken von CloudWatch RUM erstellt wurden, werden Ihnen nicht in Rechnung gestellt. ### Erweiterte Metriken für Webanwendungen Die folgenden Dimensionen werden für erweiterte Metriken für Webanwendungen unterstützt: + `BrowserName` Beispiel für Dimensionswerte: `Chrome`, `Firefox`, `Chrome Headless` + `CountryCode` Dabei wird das ISO-3166-Format mit zweibuchstabigen Codes verwendet. Beispiel für Dimensionswerte: `US`, `JP`, `DE` + `DeviceType` Beispiel für Dimensionswerte: `desktop`, `mobile`, `tablet`, `embedded` + `FileType` Beispiel für Dimensionswerte: `Image`, `Stylesheet` + `OSName` Beispiel für Dimensionswerte: `Linux`, `Windows`, `iOS`, `Android` + `PageId` ### Erweiterte Metriken für mobile Anwendungen Die folgenden Dimensionen werden für erweiterte Metriken für mobile Anwendungen unterstützt: + `ScreenName` + Wert aus dem Bildschirmnamenattribut `attributes.screen.name` Ihrer Anwendung + Beispielwerte: HomeScreen, SettingsView, ProfilePage + `DeviceModel` + Wert aus dem Gerätemodellattribut - `resource.attributes.device.model.name` + Beispielwerte: iPhone14,3, SM-G998B + `OSVersion` + Wert aus dem Versionsattribut des Betriebssystems - `resource.attributes.os.version` + Beispielwerte: 16.0, 13.0 **Anmerkung** Derzeit unterstützte Standardmetriken für mobile Anwendungen:`ScreenLoadTime`,`ScreenLoadCount`,`NetworkLatency`,`Http4xxCount`,,`Http5xxCount`,`CrashCount`,`ANRCount`,`AppHangCount`,`ColdLaunchTime`, `WarmLaunchTime``SessionCount`, `SpanPayloadSize` und. `LogPayloadSize` ### Erweiterte Metriken über die Konsole einrichten Gehen Sie wie folgt vor, um die Konsole zum Senden erweiterter Messwerte zu CloudWatch verwenden. Informationen zur Verwendung von AWS APIs , um erweiterte Messwerte an beide zu senden CloudWatch, finden Sie unter [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)und [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). **So richten Sie mit der Konsole einen App-Monitor ein und senden erweiterte RUM-Metriken an CloudWatch** 1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Wählen Sie im Navigationsbereich **Application Signals**, **RUM**. 1. Wählen Sie den Namen des App-Monitors, der die Metriken senden soll. 1. Wählen Sie den Tab **Configuration** (Konfiguration) und wählen Sie dann **RUM extended metrics** (erweiterte RUM-Metriken) aus. 1. Wählen Sie **Send metrics** (Metriken senden) aus. 1. Wählen Sie einen oder mehrere Metriknamen aus, um sie mit zusätzlichen Dimensionen zu senden. 1. Wählen Sie einen oder mehrere Faktoren aus, die als Dimensionen für diese Metriken verwendet werden sollen. Während Sie Ihre Auswahl treffen, wird die Anzahl der erweiterten Metriken, die durch Ihre Auswahl erstellt wurden, unter **Number of extended metrics** (Anzahl der erweiterten Metriken) angezeigt. Diese Zahl wird berechnet, indem die Anzahl der ausgewählten Metriknamen mit der Anzahl der verschiedenen Dimensionen, die Sie erstellen, multipliziert wird. 1. Um eine Metrik mit Seiten-ID als Dimension zu senden, wählen Sie **Nach Seiten-ID suchen** und wählen Sie dann die Seite aus, die Sie verwenden IDs möchten. 1. Um eine Metrik mit dem Gerätetyp als Dimension zu senden, wählen Sie entweder **Desktop devices** (Desktop-Geräte) oder **Mobile and tablets** (Mobil und Tablets) aus. 1. Um eine Metrik mit dem Betriebssystem als Dimension zu senden, wählen Sie unter **Operating system** (Betriebssystem) ein oder mehrere Betriebssysteme aus. 1. Um eine Metrik mit dem Browsertyp als Dimension zu senden, wählen Sie unter Browser einen oder mehrere **Browsers** (Browser) aus. 1. Um eine Metrik mit Geolokalisierung als Dimension zu senden, wählen Sie unter Standorte einen oder mehrere **Locations** (Standorte) aus. Nur die Standorte, von denen dieser Anwendungsmonitor Messwerte gemeldet hat, werden in der Liste angezeigt, aus denen Sie auswählen können. 1. Wenn Sie mit Ihrer Auswahl fertig sind, wählen Sie **Send metrics** (Metriken senden) aus. 1. (Optional) Um einen Alarm zu erstellen, der eine der Metriken überwacht, wählen Sie in der Liste der **Extended metrics** (erweiterte Metriken) in der Zeile dieser Metrik die Option **Create alarm** (Alarm erstellen) aus. Allgemeine Informationen zu CloudWatch Alarmen finden Sie unter[CloudWatch Amazon-Alarme verwenden](CloudWatch_Alarms.md). Eine Anleitung zum Einstellen eines Alarms für eine erweiterte CloudWatch RUM-Metrik finden Sie unter[Tutorial: Eine erweiterte Metrik erstellen und sie alarmieren](#CloudWatch-RUM-extended-metrics-alarmtutorial). **Das Senden erweiterter Metriken beenden** **So verwenden Sie die Konsole, um das Senden erweiterter Metriken zu beenden** 1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Wählen Sie im Navigationsbereich **Application Signals**, **RUM**. 1. Wählen Sie den Namen des App-Monitors, der die Metriken senden soll. 1. Wählen Sie den Tab **Configuration** (Konfiguration) und wählen Sie dann **RUM extended metrics** (erweiterte RUM-Metriken) aus. 1. Wählen Sie eine oder mehrere Kombinationen aus Metriknamen und Dimensionen aus, um das Senden zu beenden. Wählen Sie dann **Actions** (Aktionen), **Delete** (Löschen). ### Tutorial: Eine erweiterte Metrik erstellen und sie alarmieren Dieses Tutorial zeigt, wie Sie eine erweiterte Metrik einrichten, an die gesendet werden soll CloudWatch, und dann, wie Sie einen Alarm für diese Metrik einrichten. In diesem Tutorial erstellen Sie eine Metrik, die JavaScript Fehler im Chrome-Browser verfolgt. **So richten Sie diese erweiterte Metrik ein und stellen einen Alarm dafür ein** 1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Wählen Sie im Navigationsbereich **Application Signals**, **RUM**. 1. Wählen Sie den Namen des App-Monitors, der die Metrik senden soll. 1. Wählen Sie den Tab **Configuration** (Konfiguration) und wählen Sie dann **RUM extended metrics** (erweiterte RUM-Metriken) aus. 1. Wählen Sie **Send metrics** (Metriken senden) aus. 1. Wählen Sie **JSErrorAnzahl** aus. 1. Wählen Sie unter **Browsers** (Browser) **Chrome** (Chrome) aus. Diese Kombination aus **JSErrorCount** und **Chrome** sendet eine erweiterte Metrik an CloudWatch. Die Metrik zählt JavaScript Fehler nur für Benutzersitzungen, die den Chrome-Browser verwenden. Der Metrikname **JsErrorCount**und der Name der Dimension lauten **Browser**. 1. Wählen Sie **Send metrics** (Metriken senden) aus. 1. Wählen Sie in der Liste der **erweiterten Messwerte** in der Zeile, die **JsErrorCount**unter **Name** und **Chrome** unter angezeigt wird, die Option **Alarm erstellen** aus **BrowserName**. 1. Vergewissern Sie sich unter **Metrik und Bedingungen angeben**, dass der **Metrikname** und die **BrowserName**Felder vorab mit den richtigen Werten gefüllt sind. 1. Wählen Sie unter **Statistic** (Statistik) die Statistik aus, die Sie für den Alarm verwenden möchten. Der **Average** (Durchschnitt) ist eine gute Wahl für diese Art von Zählmetrik. 1. Wählen Sie unter **Zeitraum** die Option **5 Minuten** aus. 1. Führen Sie unter **Bedingungen** die folgenden Schritte aus: + Wählen Sie **Static** (Statisch). + Wählen Sie **Greater** (Größer), um festzulegen, dass der Alarm in den Zustand ALARM wechseln soll, wenn die Anzahl der Fehler den Schwellenwert überschreitet, den Sie gerade angeben möchten. + Unter **than ...** (als ...), geben Sie die Zahl für den Alarmschwellenwert ein. Der Alarm geht in den Zustand ALARM über, wenn die Anzahl der Fehler über einen Zeitraum von 5 Minuten diesen Wert überschreitet. 1. (Optional) Standardmäßig wechselt der Alarm in den Zustand ALARM, sobald die Anzahl der Fehler den von Ihnen festgelegten Schwellenwert innerhalb eines Zeitraums von 5 Minuten überschreitet. Sie können dies optional ändern, sodass der Alarm nur dann in den Zustand ALARM wechselt, wenn diese Zahl für mehr als einen Zeitraum von 5 Minuten überschritten wird. Wählen Sie dazu **Additional configuration** (Zusätzliche Konfiguration) und geben Sie dann für **Datapoints to alarm** (zu alarmierende Datenpunkte) an, wie viele 5-Minuten-Zeiträume die Fehlernummer über dem Schwellenwert liegen muss, um den Alarm auszulösen. Sie können beispielsweise 2 von 2 auswählen, damit der Alarm nur ausgelöst wird, wenn zwei aufeinanderfolgende 5-Minuten-Zeiträume den Schwellenwert überschreiten, oder 2 von 3, um den Alarm auszulösen, wenn zwei von drei aufeinanderfolgenden 5-Minuten-Zeiträumen den Schwellenwert überschreiten. Weitere Informationen zu den verschiedenen Arten der Alarmauswertung finden Sie unter [Auswertung von Alarmen](alarm-evaluation.md). 1. Wählen Sie **Weiter** aus. 1. Geben Sie unter **Configure actions** (Aktionen konfigurieren) an, was passieren soll, wenn der Alarm in den Alarmzustand wechselt. Führen Sie Folgendes aus, um eine Benachrichtigung mit Amazon SNS zu erhalten: + Wählen Sie **Add notification (Benachrichtigung hinzufügen)** aus. + Wählen Sie **In Alarm** aus. + Wählen Sie ein vorhandenes SNS-Thema aus oder erstellen Sie ein neues Thema. Wenn Sie eine neue erstellen, geben Sie einen Namen für sie an und fügen Sie mindestens eine E-Mail-Adresse hinzu. 1. Wählen Sie **Weiter** aus. 1. Geben Sie einen Namen und optional eine Beschreibung für den Alarm ein und wählen Sie dann **Next** (Weiter). 1. Prüfen Sie die Details und wählen Sie **Create alarm** (Alarm erstellen).