Funktionsmetriken anzeigen CloudFront und erweitern - Amazon CloudFront

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.

Funktionsmetriken anzeigen CloudFront und erweitern

In der Konsole können Sie Betriebsmetriken zu Ihren CloudFront Distributionen und Edge-Funktionen einsehen. CloudFront

So können Sie Funktionsmetriken in anzeigen CloudFront und erweitern CloudFront
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CloudFront Konsole unterhttps://console.aws.amazon.com/cloudfront/v4/home.

  2. Wählen Sie im Navigationsbereich Monitoring (Überwachung) aus.

  3. Um Diagramme zur Aktivität für eine bestimmte CloudFront Verteilungs- oder Edge-Funktion anzuzeigen, wählen Sie eine aus und wählen Sie dann Verteilungsmetriken anzeigen oder Metriken anzeigen aus.

  4. Sie können die Diagramme anpassen, indem Sie die folgenden Schritte ausführen:

    1. Zum Ändern des Zeitraums für die im Diagramm angezeigten Informationen wählen Sie 1h (1 Stunde), 3 h (3 Stunden) oder einen anderen Zeitraum aus. Alternativ können Sie auch einen benutzerdefinierten Bereich angeben.

    2. Um zu ändern, wie oft die Informationen im Diagramm CloudFront aktualisiert werden, klicken Sie auf den Abwärtspfeil neben dem Aktualisierungssymbol und wählen Sie dann eine Aktualisierungsrate aus. Die Standardaktualisierungsrate beträgt 1 Minute, Sie können jedoch auch andere Optionen wählen.

  5. Um CloudFront Diagramme in der CloudWatch Konsole anzuzeigen, wählen Sie Zum Dashboard hinzufügen. Sie müssen die Region USA Ost (Nord-Virginia) verwenden, um die Grafiken in der CloudWatch Konsole anzeigen zu können.

Standardmetriken für den CloudFront Vertrieb

Die folgenden Standardmetriken sind für alle CloudFront Verteilungen ohne zusätzliche Kosten enthalten:

Anforderungen

Die Gesamtzahl der Viewer-Anfragen CloudFront, die von allen HTTP-Methoden und sowohl für HTTP- als auch für HTTPS-Anfragen empfangen wurden.

Heruntergeladene Bytes

Die Gesamtzahl der von Viewern für GET-, HEAD- und OPTIONS-Anforderungen heruntergeladenen Bytes.

Hochgeladene Bytes

Die Gesamtzahl der Byte, die Zuschauer hochgeladen CloudFront, verwendet POST und PUT angefordert haben.

4xx-Fehlerrate

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 4xx lautet.

5xx-Fehlerrate

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 5xx lautet.

Gesamte Fehlerrate

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 4xx oder 5xx lautet.

Diese Metriken werden in Diagrammen für jede CloudFront Verteilung auf der Monitoring-Seite der CloudFront Konsole angezeigt. In jedem Diagramm wird die Gesamtzahl in Zeiteinheiten von 1 Minute angezeigt. Zusätzlich zum Anzeigen der Diagramme können Sie Metrikberichte auch als CSV-Dateien herunterladen.

Schalten Sie zusätzliche CloudFront Verteilungsmetriken ein

Zusätzlich zu den Standardmetriken können Sie für eine Zusatzgebühr weitere Metriken aktivieren. Weitere Informationen zu den Kosten finden Sie unter Schätzen Sie die Kosten für die zusätzlichen CloudFront Metriken.

Diese zusätzlichen Metriken müssen für jede Verteilung separat aktiviert werden:

Cache-Trefferrate

Der Prozentsatz aller zwischenspeicherbaren Anfragen, bei denen der Inhalt aus dem Cache CloudFront bereitgestellt wurde. HTTP POST- und PUT-Anforderungen und Fehler werden nicht als cachebare Anforderungen betrachtet.

Ursprungslatenz

Die Gesamtzeit zwischen dem CloudFront Empfang einer Anfrage und dem Beginn der Antwort an das Netzwerk (nicht an den Betrachter) für Anfragen, die vom Ursprung und nicht vom CloudFront Cache aus bedient werden. Dies wird auch als Latenz des ersten Byte oder bezeichnet time-to-first-byte.

Fehlerquote nach Statuscode

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort ein bestimmter Code im Bereich 4xx oder 5xx ist. Diese Metrik ist für alle folgenden Fehlercodes verfügbar: 401, 403, 404, 502, 503 und 504.

Sie können zusätzliche Metriken in der CloudFront Konsole, mit AWS CloudFormation, mit der AWS Command Line Interface (AWS CLI) oder mit der CloudFront API aktivieren.

Console
Um zusätzliche Metriken zu aktivieren
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CloudFront Konsole unterhttps://console.aws.amazon.com/cloudfront/v4/home.

  2. Wählen Sie im Navigationsbereich Monitoring (Überwachung) aus.

  3. Wählen Sie die Verteilung aus, für die zusätzliche Metriken aktiviert werden sollen, und wählen Sie View distribution metrics (Verteilungsmetriken anzeigen) aus.

  4. Wählen Sie Manage additional metrics (Zusätzliche Metriken verwalten) aus.

  5. Aktivieren Sie im Fenster Manage additional metrics (Zusätzliche Metriken verwalten) die Option Enabled (Aktiviert). Nachdem Sie die zusätzlichen Metriken aktiviert haben, können Sie das Fenster Manage additional metrics (Zusätzliche Metriken verwalten) schließen.

    Nachdem Sie die zusätzlichen Metriken aktiviert haben, werden sie in Diagrammen angezeigt. In jedem Diagramm wird die Gesamtzahl in Zeiteinheiten von 1 Minute angezeigt. Zusätzlich zum Anzeigen der Diagramme können Sie Metrikberichte auch als CSV-Dateien herunterladen.

CloudFormation

Verwenden Sie den AWS::CloudFront::MonitoringSubscription Ressourcentyp CloudFormation, um zusätzliche Metriken mit zu aktivieren. Das folgende Beispiel zeigt die AWS CloudFormation Vorlagensyntax im YAML-Format zur Aktivierung zusätzlicher Metriken.

Type: AWS::CloudFront::MonitoringSubscription Properties: DistributionId: EDFDVBD6EXAMPLE MonitoringSubscription: RealtimeMetricsSubscriptionConfig: RealtimeMetricsSubscriptionStatus: Enabled
CLI

Verwenden Sie einen der folgenden Befehle, um zusätzliche Metriken mit dem AWS Command Line Interface (AWS CLI) zu verwalten:

Um zusätzliche Metriken für eine Verteilung zu aktivieren
  • Verwenden Sie den Befehl create-monitoring-subscription wie im folgenden Beispiel. Ersetzen Sie EDFDVBD6EXAMPLE durch die ID der Verteilung, für die Sie zusätzliche Metriken aktivieren.

    aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
Um zu sehen, ob zusätzliche Metriken für eine Verteilung aktiviert sind
  • Verwenden Sie den Befehl get-monitoring-subscription wie im folgenden Beispiel. Ersetzen Sie EDFDVBD6EXAMPLE durch die ID der Distribution, die Sie überprüfen.

    aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
Um zusätzliche Metriken für eine Verteilung zu deaktivieren
  • Verwenden Sie den Befehl delete-monitoring-subscription wie im folgenden Beispiel. Ersetzen Sie EDFDVBD6EXAMPLE durch die ID der Verteilung, für die Sie zusätzliche Metriken deaktivieren möchten.

    aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
API

Verwenden Sie eine der folgenden API-Operationen, um zusätzliche Metriken mit der CloudFront API zu verwalten.

Weitere Informationen zu diesen API-Vorgängen finden Sie in der API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client.

Schätzen Sie die Kosten für die zusätzlichen CloudFront Metriken

Wenn Sie zusätzliche Metriken für eine Verteilung aktivieren, werden bis zu 8 Messwerte CloudWatch in die Region USA Ost (Nord-Virginia) CloudFront gesendet. CloudWatch berechnet für jede Metrik einen niedrigen, festen Tarif. Diese Rate wird nur einmal pro Monat pro Metrik berechnet (bis zu 8 Metriken pro Distribution). Da es sich um einen festen Tarif handelt, bleiben Ihre Kosten gleich, unabhängig von der Anzahl der Anfragen oder Antworten, die die CloudFront Distribution empfängt oder sendet. Die Rate pro Metrik finden Sie auf der CloudWatch Amazon-Preisseite und im CloudWatchPreisrechner. Zusätzliche API-Gebühren fallen an, wenn Sie die Metriken mit der CloudWatch API abrufen.

Standardmetriken für Lambda @Edge -Funktionen

Sie können CloudWatch Metriken verwenden, um Probleme mit Ihren Lambda @Edge -Funktionen in Echtzeit zu überwachen. Für diese Metriken fallen keine zusätzlichen Gebühren an.

Wenn Sie eine Lambda @Edge -Funktion an ein Cache-Verhalten in einer CloudFront Distribution anhängen, beginnt Lambda, automatisch Metriken an zu CloudWatch senden. Metriken sind für alle Lambda-Regionen verfügbar, aber um Metriken in der CloudWatch Konsole anzuzeigen oder die Metrikdaten von der CloudWatch API abzurufen, müssen Sie die Region USA Ost (Nord-Virginia) verwenden (us-east-1). Der Name der Metrikgruppe ist wie folgt formatiert:AWS/CloudFront/distribution-ID, wobei Distribution-ID die ID der CloudFront Distribution ist, der die Lambda @Edge -Funktion zugeordnet ist. Weitere Informationen zu CloudWatch Metriken finden Sie im CloudWatch Amazon-Benutzerhandbuch.

Die folgenden Standardmetriken werden in Diagrammen für jede Lambda @Edge -Funktion auf der Monitoring-Seite der CloudFront Konsole angezeigt:

  • 5xx-Fehlerrate für Lambda@Edge

  • Lambda-Ausführungsfehler

  • Ungültige Lambda-Antworten

  • Lambda-Drosselungen

Die Diagramme umfassen die Anzahl der Aufrufe, Fehler, Drosselungen und so weiter. In jedem Diagramm wird die Gesamtzahl in Zeiteinheiten von 1 Minute, gruppiert nach AWS -Region, angezeigt.

Wenn Sie einen Anstieg der Fehler feststellen, die Sie untersuchen möchten, können Sie eine Funktion auswählen und dann die Protokolldateien nach AWS Regionen anzeigen, bis Sie festgestellt haben, welche Funktion die Probleme verursacht und in welcher AWS Region. Weitere Informationen zur Behebung von Lambda@Edge-Fehlern finden Sie unter:

Metriken für CloudFront Standardfunktionen

CloudFront Functions sendet Betriebsmetriken an Amazon, CloudWatch damit Sie Ihre Funktionen überwachen können. Das Anzeigen dieser Metriken kann Ihnen helfen, Probleme zu beheben, zu verfolgen und zu debuggen. CloudFront Functions veröffentlicht die folgenden Kennzahlen an CloudWatch:

  • Invocations (FunctionInvocations) – Die Häufigkeit, mit der die Funktion in einem bestimmten Zeitraum gestartet (aufgerufen) wurde.

  • Validierungsfehler (FunctionValidationErrors) – Die Anzahl der Validierungsfehler, die von der Funktion in einem bestimmten Zeitraum erzeugt werden. Validierungsfehler treten auf, wenn die Funktion erfolgreich ausgeführt wird, aber ungültige Daten (ein ungültiges Ereignisobjekt) zurückgibt.

  • Ausführungsfehler (FunctionExecutionErrors) – Die Anzahl der Ausführungsfehler, die in einem bestimmten Zeitraum aufgetreten sind. Ausführungsfehler treten auf, wenn die Funktion nicht erfolgreich abgeschlossen werden kann.

  • Auslastung berechnen (FunctionComputeUtilization) – Die Zeit, die die Ausführung der Funktion in Anspruch nahm, als Prozentsatz der maximal zulässigen Zeit. Zum Beispiel bedeutet ein Wert von 35, dass die Funktion in 35 % der maximal zulässigen Zeit abgeschlossen wurde. Diese Metrik ist eine Zahl zwischen 0 und 100.

    Wenn dieser Wert 100 erreicht oder nahe 100 liegt, hat die Funktion die zulässige Ausführungszeit verwendet oder ist kurz davor, sie zu nutzen, und nachfolgende Anfragen werden möglicherweise gedrosselt. Wenn Ihre Funktion bei einer Auslastung von 80% oder mehr ausgeführt wird, empfehlen wir Ihnen, Ihre Funktion zu überprüfen, um die Ausführungszeit zu verkürzen und die Auslastung zu verbessern. Beispielsweise möchten Sie möglicherweise nur Fehler protokollieren, komplexe Regex-Ausdrücke vereinfachen oder unnötiges Parsen komplexer JSON-Objekte vermeiden.

  • Drosselungen (FunctionThrottles) – Die Häufigkeit, mit der die Funktion in einem bestimmten Zeitraum gedrosselt wurde. Funktionen können aus folgenden Gründen gedrosselt werden:

    • Die Funktion überschreitet kontinuierlich die maximal zulässige Ausführungszeit.

    • Die Funktion führt zu Kompilierungsfehlern.

    • Es gibt eine ungewöhnlich hohe Anzahl von Anforderungen pro Sekunde.

CloudFront KeyValueStore sendet außerdem die folgenden Betriebskennzahlen an Amazon CloudWatch:

  • Anfragen lesen (KvsReadRequests) — Gibt an, wie oft die Funktion innerhalb eines bestimmten Zeitraums erfolgreich aus dem Schlüsselwertspeicher gelesen hat.

  • KvsReadErrorsLesefehler () — Gibt an, wie oft die Funktion innerhalb eines bestimmten Zeitraums nicht aus dem Schlüsselwertspeicher lesen konnte.

Alle diese Metriken werden CloudWatch in der Region USA Ost (Nord-Virginia) (us-east-1) im CloudFront Namespace veröffentlicht. Sie können diese Metriken auch in der CloudWatch Konsole anzeigen. In der CloudWatch Konsole können Sie die Metriken pro Funktion oder pro Funktion pro Verteilung anzeigen.

Sie können sie auch verwenden CloudWatch , um Alarme auf der Grundlage dieser Metriken einzustellen. Sie können beispielsweise einen Alarm basierend auf der Ausführungszeitmetrik (FunctionComputeUilization) festlegen, die den Prozentsatz der verfügbaren Zeit darstellt, die Ihre Funktion zur Ausführung benötigte. Wenn die Ausführungszeit für einen bestimmten Zeitraum einen bestimmten Wert erreicht. Wenn Sie beispielsweise mehr als 70% der verfügbaren Zeit für 15 ununterbrochene Minuten wählen, wird der Alarm ausgelöst. Sie geben den Wert des Alarms und seine Zeiteinheit an, wenn Sie den Alarm erstellen.

Anmerkung

CloudFront Functions sendet CloudWatch nur Metriken an Funktionen in der LIVE Phase, die als Reaktion auf Produktionsanfragen und -antworten ausgeführt werden. Wenn Sie eine Funktion testen, sendet CloudFront keine Metriken an CloudWatch. Die Testausgabe enthält Informationen über Fehler, Rechenauslastung und Funktionsprotokolle (console.log()Anweisungen), aber diese Informationen werden nicht an gesendet CloudWatch.

Informationen darüber, wie Sie diese Metriken mit der CloudWatch API abrufen können, finden Sie unterMetriken mithilfe der CloudWatch Amazon-API abrufen.