Benutzerdefinierte Metriken und erweiterte Messwerte, an die Sie senden können CloudWatch - Amazon CloudWatch
Benutzerdefinierte MetrikenErweiterte Metriken

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.

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.

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 PutRumMetricsDestinationund BatchCreateRumMetricDefinitions. 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 eine detailliertere Ansicht erhalten.

Weitere Informationen zu den CloudWatch Standard-RUM-Metriken finden Sie unter. CloudWatch Metriken, die Sie mit CloudWatch RUM sammeln können

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 WarmLaunchTimeSessionCount, 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 eine der beiden zu senden CloudWatch, finden Sie unter PutRumMetricsDestinationund BatchCreateRumMetricDefinitions.

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

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

  3. Wählen Sie den Namen des App-Monitors, der die Metriken senden soll.

  4. Wählen Sie den Tab Configuration (Konfiguration) und wählen Sie dann RUM extended metrics (erweiterte RUM-Metriken) aus.

  5. Wählen Sie Send metrics (Metriken senden) aus.

  6. Wählen Sie einen oder mehrere Metriknamen aus, um sie mit zusätzlichen Dimensionen zu senden.

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

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

    3. Um eine Metrik mit dem Betriebssystem als Dimension zu senden, wählen Sie unter Operating system (Betriebssystem) ein oder mehrere Betriebssysteme aus.

    4. Um eine Metrik mit dem Browsertyp als Dimension zu senden, wählen Sie unter Browser einen oder mehrere Browsers (Browser) aus.

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

  8. Wenn Sie mit Ihrer Auswahl fertig sind, wählen Sie Send metrics (Metriken senden) aus.

  9. (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. Eine Anleitung zum Einstellen eines Alarms für eine erweiterte CloudWatch RUM-Metrik finden Sie unterTutorial: Eine erweiterte Metrik erstellen und sie alarmieren.

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

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

  3. Wählen Sie den Namen des App-Monitors, der die Metriken senden soll.

  4. Wählen Sie den Tab Configuration (Konfiguration) und wählen Sie dann RUM extended metrics (erweiterte RUM-Metriken) aus.

  5. 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/.

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

  3. Wählen Sie den Namen des App-Monitors, der die Metrik senden soll.

  4. Wählen Sie den Tab Configuration (Konfiguration) und wählen Sie dann RUM extended metrics (erweiterte RUM-Metriken) aus.

  5. Wählen Sie Send metrics (Metriken senden) aus.

  6. Wählen Sie JSErrorAnzahl aus.

  7. 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 JsErrorCountund der Name der Dimension lauten Browser.

  8. Wählen Sie Send metrics (Metriken senden) aus.

  9. Wählen Sie in der Liste der erweiterten Messwerte in der Zeile, die JsErrorCountunter Name und Chrome unter angezeigt wird, die Option Alarm erstellen aus BrowserName.

  10. Vergewissern Sie sich unter Metrik und Bedingungen angeben, dass der Metrikname und die BrowserNameFelder vorab mit den richtigen Werten gefüllt sind.

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

  12. Wählen Sie unter Zeitraum die Option 5 Minuten aus.

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

  14. (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 Auswerten eines Alarms.

  15. Wählen Sie Weiter aus.

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

  17. Wählen Sie Weiter aus.

  18. Geben Sie einen Namen und optional eine Beschreibung für den Alarm ein und wählen Sie dann Next (Weiter).

  19. Prüfen Sie die Details und wählen Sie Create alarm (Alarm erstellen).