mon-put-data - Amazon CloudWatch

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:

  • Eine Option pro Dimension: --dimensions "key1=value1" --dimensions "key2=value2".

  • Alles in einer Option: --dimensions "key1=value1,key2=value2".

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

-m, --metric-name VALUE1,VALUE2,VALUE3...

Name der Metrik.

Typ: Zeichenfolge

Gültige Werte: Jeder gültige Metrikname zwischen 1 und 250 Zeichen.

Standard: n/a

Erforderlich: Ja

n, --namespace VALUE

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

-s, --statistic Values "key1=value1,key2=value2..."

Die Statistiken, die für den angegebenen Zeitstempel und die angegebene Metrik gespeichert werden sollen. Diese Option gilt ausschließlich für --value. Mindestens --statisticValue oder --value muss angegeben werden.

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

-t, --timestamp VALUE

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

-u, --unit VALUE

Die Einheit für die Metrik.

Typ: Aufzählung

Gültige Werte: Einer der folgenden:

  • Sekunden

  • Mikrosekunden

  • Millisekunden

  • Bytes

  • Kilobytes

  • Megabyte

  • Gigabytes

  • Terabytes

  • Bits

  • Kilobits

  • Megabits

  • Gigabits

  • Terabits

  • Prozent

  • Anzahl

  • Bytes/Sekunde

  • Kilobytes/Sekunde

  • Megabytes/Sekunde

  • Gigabytes/Sekunde

  • Terabytes/Sekunde

  • Bits/Sekunden

  • Kilobits/Sekunde

  • Megabits/Sekunde

  • Gigabits/Sekunde

  • Terabits/Sekunde

  • Anzahl/Sekunde

  • Keine

Standard: n/a

Erforderlich: Nein

-v, --value VALUE

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 --statisticValues.

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

--aws-credential-file VALUE

Der AWS Speicherort der Datei mit Ihren Anmeldeinformationen. Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable AWS_CREDENTIAL_FILE verwenden. Wenn Sie die Umgebungsvariable definieren oder den Pfad zur Anmeldeinformationsdatei angeben, muss die Datei vorhanden sein, sonst schlägt die Anforderung fehl. Alle CloudWatch Anfragen müssen mit Ihrer Zugangsschlüssel-ID und Ihrem geheimen Zugriffsschlüssel signiert werden.

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 AWS_CREDENTIAL_FILE, falls festgelegt.

-C, --ec2-cert-file-path VALUE

Der Speicherort Ihrer EC2 Zertifikatsdatei zum Signieren von Anfragen. Sie können die Umgebungsvariable EC2_CERT verwenden, um diesen Wert anzugeben.

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 EC2_CERT, falls festgelegt.

--connection-timeout VALUE

Der Verbindungs-Timeoutwert in Sekunden.

Typ: Ganzzahl

Zulässige Werte: Jede beliebige positive Zahl.

Standard: 30

--delimiter VALUE

Das Trennzeichen, das beim Anzeigen getrennter (langer) Ergebnisse verwendet wird.

Typ: Zeichenfolge

Gültige Werte: Beliebige Zeichenfolge.

Standard: Komma (,)

--headers

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 --headers-Option ist standardmäßig deaktiviert.

-I, --access-key-id VALUE

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

-K, --ec2-private-key-file-path VALUE

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 EC2_CERT verwendet werden, andernfalls wird der Wert ignoriert. Der Wert der Umgebungsvariable EC2_PRIVATE_KEY wird verwendet, wenn sie festgelegt ist und diese Option nicht angegeben ist. Diese Option wird ignoriert, wenn die Umgebungsvariable AWS_CREDENTIAL_FILE festgelegt ist, oder --aws-credentials-file verwendet wird. Alle Anfragen an CloudWatch müssen unterschrieben sein, andernfalls wird die Anfrage abgelehnt.

Typ: Zeichenfolge

Gültige Werte: Der Pfad zu einem gültigen privaten ASN.1 Schlüssel.

Standard: keiner

--region VALUE

Die Anforderungen an die Region werden weitergeleitet. Sie können die Umgebungsvariable EC2_REGION verwenden, um den Wert anzugeben. Die Region wird verwendet, um die URL für den Anruf zu erstellen CloudWatch, und muss eine gültige Amazon Web Services (AWS) -Region sein.

Typ: Zeichenfolge

Gültige Werte: Jede AWS Region, z. B. us-east-1.

Standard: us-east-1, es sei denn, die EC2_REGION-Umgebungsvariable ist festgelegt.

S, --secret-key VALUE

Der geheime Zugriffsschlüssel, der zum Signieren der Anforderung in Verbindung mit einer Zugriffsschlüssel-ID verwendet wird. Dieser Parameter muss in Verbindung mit --access-key-id verwendet werden, andernfalls wird diese Option ignoriert.

Typ: Zeichenfolge

Zulässige Werte: Ihre Zugriffsschlüssel-ID.

Standard: keiner

--show-empty-fields

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.

--show-request

Zeigt die URL an, die die CLI zum Aufrufen von AWS verwendet.

Typ: Flag

Zulässige Werte: Keine

Standard: false

--show-table, --show-long, --show-xml, --quiet

Gibt an, wie die Ergebnisse angezeigt werden: in einer Tabelle, getrennt (lang), XML oder keine Ausgabe (still). Die --show-table-Anzeige zeigt eine Teilmenge der Daten in fester Spaltenbreite; --show-long zeigt alle zurückgegebenen Werte, die durch ein Zeichen getrennt sind; --show-xml ist der Rohertrag des Services; und --quiet unterdrückt alle Standardausgaben. Alle Optionen schließen sich gegenseitig aus, wobei die Priorität --show-table, --show-long, --show-xml und --quiet ist.

Typ: Flag

Zulässige Werte: Keine

Standard: --show-table

-U, --url VALUE

Die URL, die für den Kontakt verwendet wurde. CloudWatch Sie können diesen Wert festlegen, indem Sie die Umgebungsvariable AWS_CLOUDWATCH_URL verwenden. Dieser Wert wird in Verbindung mit --region verwendet, um die erwartete URL zu erstellen. Diese Option überschreibt die URL für den Serviceaufruf.

Typ: Zeichenfolge

Gültige Werte: Eine gültige HTTP- oder HTTPS-URL.

Standard: Verwendet den Wert, der in AWS_CLOUDWATCH_URL angegeben ist, falls festgelgt.

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

Verwandte Themen

Herunterladen

Zugehörige Aktion

Zugehöriger Befehl