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.
mon-get-stats
Description
Ruft Zeitreihendaten für die angegebene Statistik ab.
Anmerkung
Wenn Sie eine neue Metrik mit Hilfe des mon-put-data-Befehls erstellen, kann es bis zu zwei Minuten dauern, bis Sie Statistiken über die neue Metrik mit dem Befehl mon-get-stats abrufen können. Es kann jedoch bis zu 15 Minuten dauern, bis die neue Metrik in der Liste der Metriken erscheint, die mit dem Befehl mon-list-metrics abgerufen wurde.
Syntax
mon-get-stats MetricName
--namespace
value --statistics value[,value...] [--dimensions "key1=value1,key2=value2..."
] [--end-time value] [--period value] [--start-time value] [--unit value] [Common Options]
Optionen
| Name | Description |
|---|---|
|
|
Name der Metrik. Sie können diesen Wert auch über Typ: Argument Gültige Werte: Jeder gültige Metrikname zwischen 1 und 255 Zeichen. Standard: n/a Erforderlich: Ja |
|
|
Die Maße der Metrik. Sie können die Dimensionen auf zwei Arten festlegen und die Formate können kombiniert oder austauschbar verwendet werden:
Typ: Zuordnung Gültige Werte: Eine Zeichenkette des Formats name=value, wobei der Schlüssel der Name der Dimension und der Wert der Wert der Dimension ist. Die Dimensionsnamen und ‑werte müssen eine ANSI-Zeichenkette mit einer Länge von 1 bis 250 Zeichen sein. Es sind maximal 10 Dimensionen zulässig. Standard: n/a Erforderlich: Nein |
|
|
Der zuletzt erlaubte Zeitstempel für zurückgegebene Datenpunkte. Die Endzeit wird ausgeschlossen. Zeitstempel werden im kombinierten Format ISO8601 angegeben. Das Datum und die Uhrzeit des 30. Juli 2013 um 12:30 Uhr PST würden beispielsweise als 30.07.2013 oder in UTC: 2013-07-30 T12:30:00-07:00 dargestellt. T19:30:00Z Die höchste Auflösung, die zurückgegeben werden kann, CloudWatch ist 1 Minute, daher werden alle Zeitstempel auf die nächste Minute abgerundet. Typ: Argument Gültige Werte: Ein gültiger Zeitstempel im Format ISO8601 mit Zeitzonenabweichung oder UTC-Indikator. Standard: Die aktuelle date/time. Erforderlich: Nein |
|
|
Der Namespace der Metrik. Weitere Informationen zu Namespaces finden Sie unter AWS -Namespaces. Typ: Zeichenfolge Gültige Werte: Ein gültiger Namespace zwischen 1 und 250 Zeichen Länge. Standard: n/a Erforderlich: Ja |
|
|
Die Granularität, in Sekunden, um Statistiken abzurufen für. Der Zeitraum muss mindestens 60 Sekunden und ein Vielfaches von 60 betragen. Typ: Argument Gültige Werte: Eine Zahl, in Sekunden, die ein Vielfaches von 60 Sekunden ist. Standard: 60 Sekunden. Erforderlich: Nein |
|
|
Die Statistik, die für die angegebene Metrik zurückgegeben werden soll. Typ: Aufzählung Gültige Werte: Average, Sum, Maximum oder Minimum Standard: n/a Erforderlich: Ja |
|
|
Der erste erlaubte Zeitstempel für zurückgegebene Datenpunkte. Die Startzeit wird eingeschlossen. Zeitstempel werden im kombinierten Format ISO8601 angegeben. Das Datum und die Uhrzeit des 30. Juli 2013 um 12:30 Uhr PST würden beispielsweise als 30.07.2013 oder in UTC: 2013-07-30 T12:30:00-07:00 dargestellt. T19:30:00Z Die höchste Auflösung, die zurückgegeben werden kann, CloudWatch ist 1 Minute, daher werden alle Zeitstempel auf die nächste Minute abgerundet. Typ: Argument Gültige Werte: Ein gültiger Zeitstempel im Format ISO8601 mit Zeitzonenabweichung oder UTC-Indikator. Standard: Eine Stunde vor der aktuellen Zeit. Erforderlich: Nein |
|
|
Die Einheit, für die die Metriken abgerufen werden sollen. Metriken können in mehreren Einheiten gemeldet werden, wodurch eine bestimmte Einheit für eine bestimmte Metrik ermittelt wird. Wenn Sie keine Einheit anfordern, werden alle Einheiten zurückgegeben. Wenn die Metrik jemals nur mit einer Einheit gemeldet wird, hat dies keine Auswirkung. Typ: Aufzählung Gültige Werte: Einer der folgenden:
Standard: n/a Erforderlich: Nein |
Allgemeine Optionen
| Name | Description |
|---|---|
|
|
Der Speicherort der Datei mit Ihren AWS Anmeldeinformationen. Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable Typ: Zeichenfolge Gültige Werte: Ein gültiger Pfad zu einer Datei, in der die Zugriffsschlüssel-ID und der geheime Zugriffsschlüssel enthalten sind. Standard: Verwendet die Umgebungsvariable |
|
|
Der Speicherort der EC2-Zertifikatdatei zum Signieren von Anforderungen. Sie können die Umgebungsvariable Typ: Zeichenfolge Gültige Werte: Ein gültiger Dateipfad zur PEM-Datei, die von Amazon EC2 oder bereitgestellt wird. AWS Identity and Access Management Standard: Verwendet die Umgebungsvariable |
|
|
Der Verbindungs-Timeoutwert in Sekunden. Typ: Ganzzahl Zulässige Werte: Jede beliebige positive Zahl. Standard: 30 |
|
|
Das Trennzeichen, das beim Anzeigen getrennter (langer) Ergebnisse verwendet wird. Typ: Zeichenfolge Gültige Werte: Beliebige Zeichenfolge. Standard: Komma (,) |
|
|
Wenn Sie tabellarische oder durch Trennzeichen getrennte Ergebnisse anzeigen, schließen Sie die Spaltenüberschriften ein. Wenn Sie XML-Ergebnisse anzeigen, geben Sie ggf. die HTTP-Header aus der Serviceanforderung zurück. Typ: Flag Gültige Werte: Wenn vorhanden, zeigt Kopfzeilen an. Standard: Die |
|
|
Die Zugriffsschlüssel-ID, die zum Signieren der Abfrage in Verbindung mit dem geheimen Schlüssel verwendet wird. Dieser Parameter muss in Verbindung mit --secret-key verwendet werden, andernfalls wird die Option ignoriert. Alle Anfragen an CloudWatch müssen signiert werden, andernfalls wird die Anfrage abgelehnt. Typ: Zeichenfolge Zulässige Werte: Eine gültige Zugriffsschlüssel-ID. Standard: keiner |
|
|
Der private Schlüssel, der zum Signieren der Abfrage verwendet wird. Die Verwendung von public/private Schlüsseln bewirkt, dass die CLI SOAP verwendet. Die Abfrage wird mit einem öffentlichen Zertifikat und einem privaten Schlüssel signiert. Dieser Parameter muss in Verbindung mit Typ: Zeichenfolge Gültige Werte: Der Pfad zu einem gültigen ASN.1 privaten Schlüssel. Standard: keiner |
|
|
Die Anforderungen an die Region werden weitergeleitet. Sie können die Umgebungsvariable Typ: Zeichenfolge Gültige Werte: Jede AWS Region, z. B. us-east-1. Standard: us-east-1, es sei denn, die |
|
|
Der geheime Zugriffsschlüssel, der zum Signieren der Anforderung in Verbindung mit einer Zugriffsschlüssel-ID verwendet wird. Dieser Parameter muss in Verbindung mit Typ: Zeichenfolge Zulässige Werte: Ihre Zugriffsschlüssel-ID. Standard: keiner |
|
|
Zeigt leere Felder an, die (nil) als Platzhalter verwenden, um anzuzeigen, dass diese Daten nicht angefordert wurden. Typ: Flag Zulässige Werte: Keine Standard: Leere Felder werden standardmäßig nicht angezeigt. |
|
|
Zeigt die URL an, die die CLI zum Aufrufen von AWS verwendet. Typ: Flag Zulässige Werte: Keine Standard: false |
|
|
Gibt an, wie die Ergebnisse angezeigt werden: in einer Tabelle, getrennt (lang), XML oder keine Ausgabe (still). Die Typ: Flag Zulässige Werte: Keine Standard: |
|
|
Die URL, die für die Kontaktaufnahme verwendet wurde. CloudWatch Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable Typ: Zeichenfolge Gültige Werte: Eine gültige HTTP- oder HTTPS-URL. Standard: Verwendet den Wert, der in |
Ausgabe
Dieser Befehl gibt eine Tabelle zurück, die Folgendes enthält:
-
Time – Die Zeit, zu der die Metriken aufgenommen wurden.
-
SampleCount - Für diese Spalte ist keine Beschreibung verfügbar.
-
Average – Der Durchschnittswert.
-
Sum – Die Summe der Werte.
-
Minimum – Der minimale Beobachtungswert.
-
Maximum – Der maximale Beobachtungswert.
-
Unit – Die Einheit der Metrik.
Die Amazon CloudWatch CLI zeigt Fehler auf stderr an.
Beispiele
Beispielanforderung
Dieses Beispiel gibt die durchschnittliche, minimale und maximale CPU-Auslastung für die EC2-Instance i-c07704a9 mit einer Auflösung von 1 Stunde zurück.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"
Dies ist ein Beispiel für die Ausgabe der Stichproben und Durchschnittsmetriken bei einer Auflösung von einer Minute.
Time Samples Average Unit 2013-05-19 00:03:00 2.0 0.19 Percent 2013-05-19 00:04:00 2.0 0 Percent 2013-05-19 00:05:00 2.0 0 Percent 2013-05-19 00:06:00 2.0 0 Percent 2013-05-19 00:07:00 2.0 0 Percent 2013-05-19 00:08:00 2.0 0 Percent 2013-05-19 00:09:00 2.0 0 Percent 2013-05-19 00:10:00 2.0 0 Percent 2013-05-19 00:11:00 2.0 0 Percent 2013-05-19 00:12:00 2.0 0.195 Percent 2013-05-19 00:13:00 2.0 0.215 Percent ...
Beispielanforderung
Dieses Beispiel gibt die CPU-Auslastung Ihrer EC2-Flotte zurück.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"
Beispielanforderung
Dieses Beispiel gibt die durchschnittliche, minimale und maximale Anzahl von Anfragen an den Test-Stack von MyService für einen bestimmten Benutzer mit einer Auflösung von 1 Stunde zurück.
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"
Beispielanforderung
Dieses Beispiel zeigt RequestCount Statistiken für den gesamten Wert von "MyService“.
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"