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](https://aws.amazon.com/cloudfront/features/#Edge_Computing) einsehen. CloudFront **So können Sie Funktionsmetriken in anzeigen CloudFront und erweitern CloudFront** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudFront Konsole unter[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home). 1. Wählen Sie im Navigationsbereich **Monitoring (Überwachung)** aus. 1. 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. 1. 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. 1. 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 standardmäßige Aktualisierungsrate beträgt 1 Minute. Sie können jedoch auch andere Optionen auswählen. 1. 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. **Topics** + [Standardmetriken für den CloudFront Vertrieb](#monitoring-console.distributions) + [Schalten Sie zusätzliche CloudFront Verteilungsmetriken ein](#monitoring-console.distributions-additional) + [Standardmetriken für Lambda@Edge-Funktionen](#monitoring-console.lambda-at-edge) + [Metriken für CloudFront Standardfunktionen](#monitoring-console.cloudfront-functions) ## 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`- und `HEAD`-Anforderungen heruntergeladenen Bytes. **Hochgeladene Bytes** Die Gesamtzahl der Byte, die Zuschauer hochgeladen CloudFront`OPTIONS`, 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](cloudwatch-csv.md). ## 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](#monitoring-console.distributions-additional-pricing). Diese zusätzlichen Metriken müssen für jede Verteilung separat aktiviert werden: **Cache-Trefferrate** Der Prozentsatz aller zwischenspeicherbaren Anfragen, für die 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 CloudFormation, mit der AWS Command Line Interface (AWS CLI) oder mit der CloudFront API aktivieren. ------ #### [ Console ] **So aktivieren Sie zusätzliche Metriken** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudFront Konsole unter[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home). 1. Wählen Sie im Navigationsbereich **Monitoring (Überwachung)** aus. 1. 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. 1. Wählen Sie **Manage additional metrics** (Zusätzliche Metriken verwalten) aus. 1. 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](cloudwatch-csv.md). ------ #### [ CloudFormation ] Verwenden Sie den `AWS::CloudFront::MonitoringSubscription` Ressourcentyp CloudFormation, um zusätzliche Messwerte für zu aktivieren. Das folgende Beispiel zeigt die 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: **So aktivieren Sie zusätzliche Metriken für eine Distribution** + Verwenden Sie den Befehl **create-monitoring-subscription** wie im folgenden Beispiel. {{EDFDVBD6EXAMPLE}}Ersetzen Sie es 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. {{EDFDVBD6EXAMPLE}}Ersetzen Sie es durch die ID der Verteilung, 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. {{EDFDVBD6EXAMPLE}}Ersetzen Sie es 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 CloudFront API-Operationen, um zusätzliche Metriken mit der API zu verwalten. + Um zusätzliche Metriken für eine Distribution zu aktivieren, verwenden Sie [CreateMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateMonitoringSubscription.html). + Um zu sehen, ob zusätzliche Metriken für eine Verteilung aktiviert sind, verwenden Sie [GetMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetMonitoringSubscription.html). + Um zusätzliche Metriken für eine Verteilung zu deaktivieren, verwenden Sie [DeleteMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteMonitoringSubscription.html). 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](https://aws.amazon.com/cloudwatch/pricing/) und im [CloudWatchPreisrechner](https://aws.amazon.com/cloudwatch/pricing/#Pricing_calculator). 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}} es sich um die ID der CloudFront Distribution handelt, der die Lambda @Edge -Funktion zugeordnet ist. Weitere Informationen zu CloudWatch Metriken finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). 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: + [So bestimmten Sie den Typ des Fehlers](lambda-edge-testing-debugging.md#lambda-edge-testing-debugging-failure-type) + [Vier Schritte zum Debuggen Ihrer Inhaltsbereitstellung am AWS](https://aws.amazon.com/blogs/networking-and-content-delivery/four-steps-for-debugging-your-content-delivery-on-aws/) ## 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](functions-event-structure.md)) 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 außerdem die folgenden Betriebskennzahlen 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 Kennzahlen 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 damit auch Alarme einrichten CloudWatch , die auf diesen Metriken basieren. 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 CloudWatch nur an Funktionen in der `LIVE` Phase, die als Reaktion auf Produktionsanfragen und -antworten ausgeführt werden. Wenn Sie [eine Funktion testen](test-function.md), 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 unter[Arten von Metriken für CloudFront](programming-cloudwatch-metrics.md).