mon-list-metrics

Beschreibung

Listet die Namen, Namespaces und Dimensionen der Metriken auf, die Ihrem AWS -Konto zugeordnet sind. Sie können Metriken nach einer beliebigen Kombination aus Metriknamen, Namespace oder Dimensionen filtern. Wenn Sie keinen Filter angeben, werden alle möglichen Übereinstimmungen für das Attribut zurückgegeben.

Anmerkung

Es kann bis zu fünfzehn Minuten dauern, bis der mon-list-metrics Befehl neue Metriknamen, Namespaces und Dimensionen meldet, die durch Aufrufe von hinzugefügt wurden. mon-put-data Die Datenpunkte von mon-put-data oder andere Methoden sind mit mon-get-statistics in weniger als 5 Minuten verfügbar.

Syntax

mon-list-metrics [--dimensions "key1=value1,key2=value2..."] [--metric-name value] [--namespace value] [Common Options]

Optionen

Name	Beschreibung
-d, --dimensions "key1=value1,key2=value2..."	Die Dimensionen der abzurufenden Metrik. 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". Wenn keine Dimensionen angegeben sind, wird keine Filterung der Dimensionen vorgenommen. Alle anderen angeforderten Filter werden weiterhin angewendet. Um in das Ergebnis aufgenommen zu werden, muss eine Metrik alle spezifizierten Dimensionen enthalten, wobei die Metrik jedoch zusätzliche Dimensionen über die angeforderten Metriken hinaus enthalten kann. 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 VALUE	Name der Metrik. Um in die Ergebnisse aufgenommen zu werden, muss der Metrikname genau mit dem gewünschten Metriknamen übereinstimmen. Wenn kein Metrikname angegeben ist, wird keine Filterung durchgeführt. Alle anderen gewünschten Filter werden angewendet. Typ: Einfach Gültige Werte: Jeder gültige Metrikname mit einer Länge zwischen 1 und 250 Zeichen. Standard: n/a Erforderlich: Nein
-n, --namespace VALUE	Der Namespace, der zum Filtern von Metriken verwendet werden soll. 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: Nein

Allgemeine Optionen

Name	Beschreibung
--aws-credential-file VALUE	Der Speicherort der Datei mit Ihren Anmeldeinformationen. AWS 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 der EC2-Zertifikatdatei zum Signieren von Anforderungen. 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 EC2 bereitgestellten PEM-Datei 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

Dieser Befehl gibt eine Tabelle zurück, die Folgendes enthält:

• Metrikname – Der Name der Metrik, der dieser Metrik zugeordnet ist.

• Namespace – Der Namespace, der dieser Metrik zugeordnet ist.

• Dimensionen – Die Dimensionsnamen und ‑werte, die dieser Metrik zugeordnet sind.

Die Amazon CloudWatch CLI zeigt Fehler auf stderr an.

Beispiele

Beispielanforderung

Dieses Beispiel gibt eine Liste aller Ihrer Metriken zurück.

mon-list-metrics 

Dies ist ein Beispiel für die Ausgabe eines Aufrufs von ''. mon-list-metrics

Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...

Beispielanforderung

In diesem Beispiel werden Ihre Metriken mit dem angegebenen Namen aufgelistet.

mon-list-metrics --metric-name RequestCount

Beispielanforderung

In diesem Beispiel werden Ihre Metriken aufgelistet, die zum angegebenen Namespace gehören.

mon-list-metrics --namespace MyService

Beispielanforderung

In diesem Beispiel werden Ihre Metriken mit den angegebenen Dimensionsnamen und ‑werten aufgelistet.

mon-list-metrics --dimensions "User=SomeUser,Stack=Test"

Verwandte Themen

Herunterladen

• Einrichtung der Befehlszeilenschnittstelle

Zugehörige Aktion

• ListMetrics

Zugehöriger Befehl

• mon-describe-alarms