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-put-data
Beschreibung
Fügt Metrik-Datenpunkte zu der angegebenen Metrik hinzu. Dieser Aufruf gibt Zeitreihendaten aus, entweder für den Rohwert oder für gültige statistische Werte eines bestimmten Metriknamens. Es unterstützt die Eingabe jeweils eines einzelnen Datenpunktes.
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-put-data --metric-name
value
[--namespace value
[--dimensions
"key1=value1
,key2=value2
..."]
[--statisticValues
"key1=value1
,key2=value2
..."]
[--timestamp value
] [--unit value
]
[--value value
] [Common Options]
Optionen
Name | Beschreibung |
---|---|
-d, --dimensions "key1=value1,key2=value2..." |
Die Dimensionen, die die Metrikdaten eindeutig identifizieren. 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 |
|
Name der Metrik. Typ: Zeichenfolge Gültige Werte: Jeder gültige Metrikname zwischen 1 und 250 Zeichen. Standard: n/a Erforderlich: Ja |
|
Der Namespace der Metrik. Weitere Informationen zu Namespaces finden Sie unter AWS -Namespaces. Typ: Zeichenfolge Gültige Werte: Eine ANSI-Zeichenkette mit einer Länge von 1 bis 250 Zeichen. Standard: n/a Erforderlich: Ja |
|
Die Statistiken, die für den angegebenen Zeitstempel und die angegebene Metrik gespeichert werden sollen. Diese Option gilt ausschließlich für Typ: Zuordnung Gültige Werte: Eine Zeichenfolge, die alle Doppelwerte für alle Statistiknamen enthält: SampleCount, Summe, Maximum und Minimum. Alle diese Werte müssen ein Wert zwischen 1E-130 und 1E130 sein. Standard: n/a Erforderlich: Ja |
|
Der Zeitstempel des Datenpunktes oder der Beobachtung für die aufzuzeichnende Metrik. Zeitstempel werden im kombinierten Format ISO86 01 angegeben. Beispielsweise wird das Datum und die Uhrzeit des 30. Juli 2013 um 12:30:00 Uhr PST als 2013-07-30T12:30:00-07:00 oder in UTC: 2013-07-30T19:30:00Z dargestellt. Typ: Einfach Gültige Werte: Ein gültiger Zeitstempel, der im Format ISO86 01 mit Zeitzonen-Offset oder UTC-Indikator dargestellt wird. Standard: Die aktuelle UTC-Zeit. Erforderlich: Nein |
|
Die Einheit für die Metrik. Typ: Aufzählung Gültige Werte: Einer der folgenden:
Standard: n/a Erforderlich: Nein |
|
Ein Einzelwert, der aufgezeichnet werden soll. Der Wert wird in einen Statistiksatz der folgenden Form übersetzt: SampleCount =1, SUM=Wert, Minimum=Wert, Maximal=Wert. Diese Option gilt ausschließlich für Typ: Einfach Gültige Werte: Alle Werte müssen eine Zahl zwischen 1E-130 und 1E130 sein. Standard: n/a Erforderlich: Ja |
Allgemeine Optionen
Name | Beschreibung |
---|---|
|
Der AWS Speicherort der Datei mit Ihren 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 Ihrer EC2 Zertifikatsdatei zum Signieren von Anfragen. Sie können die Umgebungsvariable Typ: Zeichenfolge Gültige Werte: Ein gültiger Dateipfad zu der von Amazon bereitgestellten PEM-Datei EC2 oder 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 sein, 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 öffentlicher/privater Schlüssel 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 privaten ASN.1 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 den Kontakt 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 |
Output
Mit diesem Befehl werden Metrik-Datenpunkte zu einer Metrik hinzugefügt.
Die Amazon CloudWatch CLI zeigt Fehler auf stderr an.
Beispiele
Beispielanforderung
In diesem Beispiel werden Statistikdaten für RequestCount
im MyService
-Namespace erstellt. Die Metrik enthält keine Dimensionen und stellt somit den Gesamtwert des RequestCount gesamten Services dar. Die Messung ist ein voraggregierter statistischer Wert, der fünf frühere Messungen darstellt, deren Maximum 70 war, deren Minimum 30 war und deren Summe 250 war.
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
Beispielanforderung
In diesem Beispiel werden benutzerspezifische RequestCount
-Testdaten im MyService
-Namespace erstellt. Der Benutzer- und Stapelname werden als Dimensionen gespeichert, um diese Metrik von der serviceweiten Metrik im obigen Beispiel zu unterscheiden.
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50