Anzeigen von CloudFront- und Edge-Funktionsmetriken - Amazon CloudFront
Standardmetriken für CloudFront-DistributionenAktivieren zusätzlicher CloudFront-DistributionsmetrikenStandardmetriken für Lambda@Edge-FunktionenStandardmetriken für CloudFront Functions

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.

Anzeigen von CloudFront- und Edge-Funktionsmetriken

Sie können Betriebsmetriken zu Ihren CloudFront-Verteilungen und Edge-Funktionen in der CloudFront-Konsole anzeigen.

So zeigen Sie CloudFront- und Edge-Funktionsmetriken in CloudFront an

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die CloudFront-Konsole unter https://console.aws.amazon.com/cloudfront/v4/home.

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

  3. Zum Anzeigen von Diagrammen zu der Aktivität für eine bestimmte CloudFront-Verteilung oder Edge-Funktion wählen Sie eine aus und wählen Sie dann View distribution metrics (Verteilungsmetriken anzeigen) oder View metrics (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 CloudFront die Informationen im Diagramm aktualisiert, wählen Sie den Abwärtspfeil neben dem Aktualisierungssymbol und dann eine Aktualisierungsrate aus. Die standardmäßige Aktualisierungsrate beträgt 1 Minute. Sie können jedoch auch andere Optionen auswählen.

  5. Zum Anzeigen von CloudFront-Diagrammen in der CloudWatch-Konsole wählen Sie Add to dashboard (Zum Dashboard hinzufügen) aus. Sie müssen die Region USA Ost (Nord-Virginia) verwenden, um die Diagramme in der CloudWatch-Konsole anzuzeigen.

Standardmetriken für CloudFront-Distributionen

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

Anforderungen

Die Gesamtzahl der von CloudFront empfangenen Viewer-Anforderungen für alle HTTP-Methoden sowie für HTTP- und HTTPS-Anforderungen.

Heruntergeladene Bytes

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

Hochgeladene Bytes

Die Gesamtzahl der Bytes, die Viewer unter Verwendung von OPTIONS-, POST- und PUT-Anforderungen in CloudFront hochgeladen 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-Distribution auf der Seite Überwachung in 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.

Aktivieren zusätzlicher CloudFront-Distributionsmetriken

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ätzung der 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 cachebaren Anforderungen, für die CloudFront den Inhalt aus seinem Cache bereitgestellt hat. HTTP POST- und PUT-Anforderungen und Fehler werden nicht als cachebare Anforderungen betrachtet.

Ursprungslatenz

Die Gesamtzeit, die ab dem Empfang einer Anforderung durch CloudFront bis zum Zeitpunkt der Bereitstellung einer Antwort für das Netzwerk (nicht für den Viewer) für Anforderungen aufgewendet wird, die vom Ursprung und nicht vom CloudFront-Cache bedient werden. Dies wird auch als First-Byte-Latenz oder time-to-first-byte bezeichnet.

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, über die CloudFormation, über die AWS Command Line Interface (AWS CLI) oder über die CloudFront-API aktivieren.

Console
So aktivieren Sie zusätzliche Metriken

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die CloudFront-Konsole unter https://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 Ressourcentyp AWS::CloudFront::MonitoringSubscription, um zusätzliche Metriken mit CloudFormation zu aktivieren. Das folgende Beispiel zeigt die CloudFormation-Vorlagensyntax im YAML-Format zum Aktivieren 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 über die AWS Command Line Interface (AWS CLI) zu verwalten.

So aktivieren Sie zusätzliche Metriken für eine Distribution

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

    
aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
So prüfen Sie, ob zusätzliche Metriken für eine Distribution 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
So deaktivieren Sie zusätzliche Metriken für eine Distribution

  • Verwenden Sie den Befehl delete-monitoring-subscription wie im folgenden Beispiel. Ersetzen Sie EDFDVBD6EXAMPLE durch die ID der Distribution, für die Sie zusätzliche Metriken deaktivieren.

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

Verwenden Sie einen der folgenden API-Vorgänge, um zusätzliche Metriken mit der CloudFront-API zu verwalten.

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

Schätzung der Kosten für die zusätzlichen CloudFront-Metriken

Wenn Sie zusätzliche Metriken für eine Verteilung aktivieren, sendet CloudFront bis zu 8 Metriken an CloudWatch in der Region USA Ost (Nord-Virginia). CloudWatch berechnet eine niedrige, feste Rate für jede Metrik. Diese Rate wird nur einmal pro Monat pro Metrik berechnet (bis zu 8 Metriken pro Distribution). Dies ist eine feste Rate, sodass Ihre Kosten unabhängig von der Anzahl der Anforderungen oder Antworten, die die CloudFront-Verteilung empfängt oder sendet, gleich bleiben. Die Rate pro Metrik finden Sie auf der Amazon CloudWatch-Preisseite und im CloudWatch-Preisrechner. 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 eine Cache-Verhaltensweise in einer CloudFront-Verteilung anfügen, beginnt Lambda, automatisch Metriken an CloudWatch zu senden. Metriken sind für alle Lambda-Regionen verfügbar. Um jedoch Metriken in der CloudWatch-Konsole anzuzeigen oder die Metrikdaten von der CloudWatch-API abzurufen, müssen Sie die Region USA Ost (Nord-Virginia) (us-east-1) verwenden. Der Name der Metrikgruppe ist wie folgt formatiert: AWS/CloudFront/distribution-ID, wobei distribution-ID die ID der CloudFront-Verteilung ist, der die Lambda@Edge-Funktion zugeordnet ist. Weitere Informationen über CloudWatch-Metriken finden Sie im Amazon CloudWatch-Benutzerhandbuch.

Die folgenden Standardmetriken werden in Diagrammen für jede Lambda@Edge-Funktion auf der Seite Überwachung in 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 eine steiler Anstieg von Fehlern zu beobachten ist, die Sie untersuchen möchten, können Sie eine Funktion auswählen und die Protokolldateien dann nach AWS-Region anzeigen, bis Sie erkennen, welche Funktion die Probleme in welcher AWS-Region verursacht. Weitere Informationen zur Behebung von Lambda@Edge-Fehlern finden Sie unter:

Standardmetriken für CloudFront Functions

CloudFront Functions sendet operative Metriken 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 Metriken 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 sich diesem Wert annähert, hat die Funktion die zulässige Ausführungszeit vollständig oder fast aufgebraucht und nachfolgende Anforderungen 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 können Sie 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 auch die folgenden Betriebsmetriken an Amazon CloudWatch:

  • Leseanforderungen (KvsReadRequests) – wie oft die Funktion innerhalb eines bestimmten Zeitraums Daten aus dem Schlüsselwertspeicher erfolgreich gelesen hat.

  • Lesefehler (KvsReadErrors) – wie oft die Funktion innerhalb eines bestimmten Zeitraums Daten aus dem Schlüsselwertspeicher nicht lesen konnte.

Alle diese Metriken werden in CloudWatch in der Region USA Ost (Nord-Virginia) (us-east-1) im CloudFront-Namespace veröffentlicht. Diese Metriken können Sie 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 CloudWatch auch verwenden, um Alarme basierend auf diesen Metriken festzulegen. Sie können beispielsweise einen Alarm basierend auf der Ausführungszeitmetrik (FunctionComputeUtilization) festlegen, die den Prozentsatz der verfügbaren Zeit darstellt, die Ihre Funktion zur Ausführung benötigte. Wenn die Ausführungszeit für eine bestimmte Zeit einen bestimmten Wert erreicht. Wenn Sie beispielsweise mehr als 70 % der verfügbaren Zeit für 15 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 Metriken nur für Funktionen in der LIVE-Phase, die als Reaktion auf Produktionsanfragen und -antworten ausgeführt werden, an CloudWatch. Wenn Sie eine Funktion testen, sendet CloudFront keine Metriken oder Protokolle an CloudWatch. Die Testausgabe enthält Informationen über Fehler, Rechenauslastung und Funktionsprotokolle (console.log()-Anweisungen), aber diese Informationen werden nicht an CloudWatch gesendet.

Weitere Informationen zum Abrufen dieser Metriken über die CloudWatch-API finden Sie unter Arten von Metriken für CloudFront.