getMetricStatistics() gibt Daten für ein oder mehrere
Statistiken einer gegebenen Metrik zurück.
Note:
Die maximale Anzahl an Datenpunkten die das Amazon CloudWatch Service
in einer einzelnen GetMetricStatistics Anfrage zurückgibt ist 1.440.
Wenn eine Anfrage durchgeführt wird, die mehr Datenpunkt als diese Anzahl
erstellen würde, gibt Amazon CloudWatch einen Fehler zurück. Man kann die
Anfrage anpassen indem der Zeitbereich (StartTime, EndTime) angenähert
wird, oder indem die Dauer in der einzelnen Anfrage erhöht wird. Man kann
also alle Daten mit der gleichen Granularität erhalten in der man diese
ursprünglich angefragt hat, indem mehrere Anfragen mit angepassten
Zeitbereichen durchgeführt werden.
getMetricStatistics() benötigt nur zwei Parameter, besitzt
aber vier zusätzliche Parameter die optional sind.
-
Benötigt:
-
MeasureName Der Name der Maßeinheit die mit der
Maßeinheit der geholten Metrik korrespondiert. Gültige
EC2 Werte sind CPUUtilization,
NetworkIn, NetworkOut, DiskWriteOps, DiskReadBytes, DiskReadOps,
DiskWriteBytes. Gültige Elastic Load Balancing Metriken sind Latency,
RequestCount, HealthyHostCount, UnHealthyHostCount. » Für
weitere Informationen hier klicken.
-
Statistics Die Statistik die für die angegebene Metrik
zurückgegeben werden soll. Gültige Werte sind Average, Maximum, Minimum,
Samples, Sum. Man kann diese als String oder Array von Strings definieren.
Wenn man keine spezifiziert dann wird als Standard Average genommen statt
nichts zu tun. Wenn man eine ungültige Option spezifiziert wird diese
einfach ignoriert. » Für
weitere Informationen hier klicken.
-
Optional:
-
Dimensions Amazon CloudWatch erlaubt es eine Dimension
zu spezifizieren um Metrikdaten weiter zu filtern. Wenn man keine Dimension
spezifiziert, gibt der Service die Zusammenfassung alle Maße mit dem
angegebenen Namen der Maßeinheit und dem Zeitbereich zurück.
-
Unit Die Standardeinheit der Maßeinheit für ein
angegebenes Maß. Gültige Werte sind: Seconds, Percent, Bytes, Bits, Count,
Bytes/Second, Bits/Second, Count/Second, und None. Verknüpfungen: Wenn
Count/Second als Einheit verwendet wurd, sollte man Sum als Statistik
verwenden und nicht Average. Andernfalls gibt das Beispiel die Anzahl der
Anfragen zurück und nicht die Anzahl der 60-Sekunden Intervalle. Das würde
dazu führen das Average immer 1 ist wenn die Einheit Count/Second ist.
-
StartTime Der Zeitpunkt des ersten Datenpunkts der
zurückgegeben werden soll, inklusive diesem. Zum Beispiel,
2008-02-26T19:00:00+00:00. Wir runden den Wert zur naheliegendsten Minute.
Man kann die Startzeit bis zu mehr als zwei Wochen in die Vergangenheit
setzen. Trotzdem wird man nur Werte für die letzten zwei Wochen erhalten.
(Im ISO 8601 Format). Abhängigkeiten: Muß vor EndTime
liegen.
-
EndTime Der Zeitpunkt der für die Ermittlung des
letzten Datenpunkts verwendet werden soll der zurückzugeben ist. Das ist
der letzte Datenpunkt der zu holen ist, exklusive. Zum Beispiel,
2008-02-26T20:00:00+00:00 (Im ISO 8601 Format).