mon-describe-alarms - Amazon CloudWatch
BeschreibungSyntaxOptionenAllgemeine OptionenOutputBeispieleVerwandte Themen

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-describe-alarms

Beschreibung

Ruft Informationen über die angegebenen Alarme ab. Wenn Sie keinen Alarmnamen angeben, gibt dieser Befehl Informationen über alle Ihre Alarme zurück. Sie können Alarme abrufen, indem Sie nur das Präfix für den Alarmnamen, den Alarmzustand oder ein Aktionspräfix verwenden.

Syntax

mon-describe-alarms [AlarmNames [AlarmNames ...]] [--action-prefix value] [--alarm-name-prefix value] [--state-value value] [Common Options]

Optionen

Name Beschreibung

AlarmNames AlarmNames

Die Namen der Alarme. Sie können diesen Wert auch über --alarm-name festlegen. Sie können diese Option mehrfach angeben.

Typ: Argument

Gültige Werte: Ein vorhandener Alarmname, ansonsten wird keine Antwort zurückgegeben.

Standard: n/a, zeigt standardmäßig alle Alarme an.

Erforderlich: Nein

--action-prefix VALUE

Präfix der Aktionsnamen.

Typ: Argument

Gültige Werte: Das Präfix eines vorhandenen Aktionsnamens im ARN-Format.

Standard: n/a, zeigt standardmäßig die erste Aktion an.

Erforderlich: Nein

--alarm-name-prefix VALUE

Präfix der Alarmnamen.

Typ: Argument

Gültige Werte: Das Präfix eines vorhandenen Alarmnamens.

Standard: n/a

Erforderlich: Nein

--state-value VALUE

Der Zustand des Alarms.

Typ: Aufzählung

Gültige Werte: OK, ALARM oder INSUFFICIENT_DATA

Standard: Alle Alarmzustände.

Erforderlich: Nein

Allgemeine Optionen

Name Beschreibung

--aws-credential-file VALUE

Der Speicherort der Datei mit Ihren AWS 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 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:

  • ALARM – Der Name des Alarms.

  • DESCRIPTION - Die Alarmbeschreibung. Diese Spalte erscheint nur in der Ansicht --show-long.

  • STATE - Der Alarmzustand.

  • STATE_REASON - Ein für Menschen lesbarer Grund für den Zustand. Diese Spalte erscheint nur in der Ansicht --show-long.

  • STATE_REASON_DATA - Ein maschinenlesbarer Grund für den Zustand (JSON-Format). Diese Spalte erscheint nur in der Ansicht --show-long.

  • AKTIVIERT - Aktiviert oder deaktiviert Aktionen. Diese Spalte erscheint nur in der Ansicht --show-long.

  • OK_ACTIONS - Die Aktion, die im Status OK ausgeführt werden soll. Diese Spalte erscheint nur in der Ansicht --show-long.

  • ALARM_ACTIONS - Die Aktion, die im Status ALARM ausgeführt werden soll.

  • INSUFFIZIENT_DATA_ACTIONS - Die Aktion, die im Status INSUFIZIENT_DATA ausgeführt werden soll. Diese Spalte erscheint nur in der Ansicht --show-long.

  • NAMESPACY - Ein Namespace für die Metrik.

  • METRIC_NAME - Der Name der Metrik.

  • MESSUNGEN - Die Metrikdimensionen. Diese Spalte erscheint nur in der Ansicht --show-long.

  • Periode - Der Zeitraum.

  • STATISTIK — Die Statistik (Durchschnitt, Minimum, Maximum, Summe, SampleCount).

  • EXTENDEDSTATIC - Die Perzentil-Statistik.

  • UNIT - Die Einheit. Diese Spalte erscheint nur in der Ansicht --show-long.

  • EVAL_PERIOUS - Die Anzahl der Perioden für die Auswertung der Metrik.

  • COMPARISON - Der Vergleichsoperator.

  • THRESHOLD - Der Schwellenwert

Die Amazon CloudWatch CLI zeigt Fehler auf stderr an.

Beispiele

Beispielanforderung

Dieses Beispiel beschreibt alle Ihre Alarme, deren Name mit my-alarm beginnt.

mon-describe-alarms --alarm-name-prefix my-alarm --headers

Dies ist eine exemplarische Ausgabe dieses Befehls.

ALARM      STATE ALARM_ACTIONS  NAMESPACE  METRIC_NAME    PERIOD  STATISTIC  EVAL_PERIODS  COMPARISON            THRESHOLD
my-alarm1  OK    arn:aws:sns:.. AWS/EC2    CPUUtilization 60      Average    3             GreaterThanThreshold  100.0
my-alarm2  OK    arn:aws:sns:.. AWS/EC2    CPUUtilization 60      Average    5            
GreaterThanThreshold  80o.0

Verwandte Themen

Herunterladen

Zugehörige Aktion

Zugehörige Befehle