Arten von Metriken für CloudFront - Amazon CloudFront
Werte für alle CloudFront-MetrikenWerte für CloudFront-VerteilungsmetrikenWerte für CloudFront-Funktionsmetriken

Arten von Metriken für CloudFront

Sie können die CloudWatch-API oder die AWS Command Line Interface (AWS CLI) verwenden, um die CloudFront-Metriken in Programmen oder Anwendungen abzurufen, die Sie erstellen. Sie können die Rohdaten verwenden, um eigene benutzerdefinierte Dashboards, eigene alarmierende Tools usw. zu erstellen.

Weitere Informationen finden Sie unter get-metric-data in der AWS CLI-Befehlsreferenz oder der API-Operation GetMetricData in der API-Referenz für Amazon CloudWatch.

Anmerkung

Zum Abrufen der CloudFront-Metriken aus der CloudWatch-API müssen Sie die Region USA Ost (Nord-Virginia) () verwen (us-east-1). Sie müssen auch bestimmte Werte und Typen für jede Metrik kennen.

Werte für alle CloudFront-Metriken

Die folgenden Werte gelten für alle CloudFront-Metriken:

Namespace

Der Wert für Namespace ist immer AWS/CloudFront.

Dimensionen

Jede CloudFront-Metrik besitzt die folgenden Dimensionen:

DistributionId

Die ID der CloudFront-Verteilung, für die Sie Metriken abrufen möchten.

FunctionName

Der Name der Funktion (in CloudFront Functions), für die Sie Metriken abrufen möchten.

Diese Dimension gilt nur für Funktionen.

Region

Der Wert für Region ist immer Global, weil es sich bei CloudFront um einen globalen Service handelt.

Werte für CloudFront-Verteilungsmetriken

Verwenden Sie die Informationen aus der folgenden Liste, um Details zu bestimmten CloudFront-Verteilungsmetriken aus der CloudWatch-API abzurufen. Einige dieser Metriken sind nur verfügbar, wenn Sie zusätzliche Metriken für die Verteilung aktiviert haben.

Anmerkung

Für jede Metrik ist nur eine Statistik, Average oder Sum, anwendbar. Die folgende Liste gibt an, welche Statistik auf diese Metrik anwendbar ist.

4xx-Fehlerrate

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

  • Metrikname: 4xxErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

401-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 401 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 401ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

403-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 403 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 403ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

404-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 404 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 404ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

5xx-Fehlerrate

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

  • Metrikname: 5xxErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

502-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 502 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 502ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

503-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 503 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 503ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

504-Fehlerquote

Der Prozentsatz aller Viewer-Anforderungen, für die der HTTP-Statuscode der Antwort 504 lautet. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: 504ErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

Heruntergeladene Bytes

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

  • Metrikname: BytesDownloaded

  • Gültige Statistik: Sum

  • Einheit: None

Hochgeladene Bytes

Die Gesamtzahl der Bytes, die Viewer unter Verwendung von OPTIONS-, POST- und PUT-Anforderungen in CloudFront hochgeladen haben.

  • Metrikname: BytesUploaded

  • Gültige Statistik: Sum

  • Einheit: None

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. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: CacheHitRate

  • Gültige Statistik: Average

  • Einheit: Percent

Ursprungslatenz

Die Gesamtzeit in Millisekunden, 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. Um diese Metrik abzurufen, müssen Sie zunächst zusätzliche Metriken aktivieren.

  • Metrikname: OriginLatency

  • Gültige Statistik: Percentile

  • Einheit: Milliseconds

Anmerkung

Um eine Percentile-Statistik aus der CloudWatch-API abzurufen, verwenden Sie statt ExtendedStatistics den Parameter Statistics. Weitere Informationen finden Sie unter GetMetricStatistics in der Amazon CloudWatch API-Referenz oder in der Referenzdokumentation zu den AWS-SDKs.

Anforderungen

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

  • Metrikname: Requests

  • Gültige Statistik: Sum

  • Einheit: None

Gesamte Fehlerrate

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

  • Metrikname: TotalErrorRate

  • Gültige Statistik: Average

  • Einheit: Percent

Werte für CloudFront-Funktionsmetriken

Verwenden Sie die Informationen aus der folgenden Liste, um Details zu bestimmten CloudFront-Funktionsmetriken aus der CloudWatch-API abzurufen.

Anmerkung

Für jede Metrik ist nur eine Statistik, Average oder Sum, anwendbar. Die folgende Liste gibt an, welche Statistik auf diese Metrik anwendbar ist.

Aufrufe

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

  • Metrikname: FunctionInvocations

  • Gültige Statistik: Sum

  • Einheit: None

Validierungsfehler

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.

  • Metrikname: FunctionValidationErrors

  • Gültige Statistik: Sum

  • Einheit: None

Ausführungsfehler

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

  • Metrikname: FunctionExecutionErrors

  • Gültige Statistik: Sum

  • Einheit: None

Computing-Auslastung

Die Zeit (0–100), die die Ausführung der Funktion in Anspruch genommen hat, 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.

  • Metrikname: FunctionComputeUtilization

  • Gültige Statistik: Average

  • Einheit: Percent

Drosselungen

Die Häufigkeit, mit der die Funktion in einem bestimmten Zeitraum gedrosselt wurde.

  • Metrikname: FunctionThrottles

  • Gültige Statistik: Sum

  • Einheit: None