Metriken mithilfe der CloudWatch Amazon-API abrufen

Sie können die CloudWatch API oder 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 get-metric-datain der AWS CLI Befehlsreferenz oder unter GetMetricDataAPI-Operation in der Amazon CloudWatch API-Referenz.

Anmerkung

Um die CloudFront Metriken von der CloudWatch API abzurufen, müssen Sie die Region USA Ost (Nord-Virginia) (us-east-1) verwenden. 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 hat die folgenden zwei Dimensionen:

DistributionId

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

FunctionName

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

Diese Dimension gilt nur für Funktionen.

Region

Der Wert für Region ist immerGlobal, weil CloudFront es sich um einen globalen Dienst handelt.

Werte für CloudFront Vertriebsmetriken

Verwenden Sie 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-, HEAD- und OPTIONS-Anforderungen heruntergeladenen Bytes.

• Metrikname: BytesDownloaded

• Gültige Statistik: Sum

• Einheit: None

Hochgeladene Bytes

Die Gesamtzahl der Byte, die Zuschauer mitCloudFront, mithilfe POST und PUT Anfragen zu Ihrem Ursprungsserver hochgeladen haben.

• Metrikname: BytesUploaded

• Gültige Statistik: Sum

• Einheit: None

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. 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 vom CloudFront Empfang einer Anfrage bis zum Beginn der Antwort an das Netzwerk (nicht an den Betrachter) für Anfragen, die vom Ursprung und nicht vom Cache aus bedient werden. CloudFront Dies wird auch als Latenz des ersten Byte oder bezeichnet. time-to-first-byte 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 von der CloudWatch API abzurufen, verwenden Sie den ExtendedStatistics Parameter notStatistics. Weitere Informationen finden Sie GetMetricStatisticsin der Amazon CloudWatch API-Referenz oder in der Referenzdokumentation für die AWS SDKs.

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.

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