Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

CloudWatch Beispiele mit AWS CLI - AWS SDK-Codebeispiele

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

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.

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

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.

CloudWatch Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudWatch.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarios anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungdelete-alarms.

AWS CLI

So löschen Sie einen Alarm

Im folgenden Beispiel wird der delete-alarms Befehl verwendet, um den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ zu löschen:

aws cloudwatch delete-alarms --alarm-names myalarm

Ausgabe:

This command returns to the prompt if successful.
  • Einzelheiten zur API finden Sie DeleteAlarmsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-alarms.

AWS CLI

So löschen Sie einen Alarm

Im folgenden Beispiel wird der delete-alarms Befehl verwendet, um den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ zu löschen:

aws cloudwatch delete-alarms --alarm-names myalarm

Ausgabe:

This command returns to the prompt if successful.
  • Einzelheiten zur API finden Sie DeleteAlarmsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-anomaly-detector.

AWS CLI

Um ein bestimmtes Modell zur Erkennung von Anomalien zu löschen

Im folgenden delete-anomaly-detector Beispiel wird ein Modell zur Erkennung von Anomalien im angegebenen Konto gelöscht.

aws cloudwatch delete-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Modells zur Erkennung von Anomalien im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-anomaly-detector.

AWS CLI

Um ein bestimmtes Modell zur Erkennung von Anomalien zu löschen

Im folgenden delete-anomaly-detector Beispiel wird ein Modell zur Erkennung von Anomalien im angegebenen Konto gelöscht.

aws cloudwatch delete-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Modells zur Erkennung von Anomalien im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-dashboards.

AWS CLI

Um bestimmte Dashboards zu löschen

Im folgenden delete-dashboards Beispiel werden zwei Dashboards mit dem Namen Dashboard-A und Dashboard-B im angegebenen Konto gelöscht.

aws cloudwatch delete-dashboards \ --dashboard-names Dashboard-A Dashboard-B

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteDashboardsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-dashboards.

AWS CLI

Um bestimmte Dashboards zu löschen

Im folgenden delete-dashboards Beispiel werden zwei Dashboards mit dem Namen Dashboard-A und Dashboard-B im angegebenen Konto gelöscht.

aws cloudwatch delete-dashboards \ --dashboard-names Dashboard-A Dashboard-B

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteDashboardsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-insight-rules.

AWS CLI

Um bestimmte Contributor Insights-Regeln zu löschen

Im folgenden delete-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B im angegebenen Konto gelöscht.

aws cloudwatch delete-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungdelete-insight-rules.

AWS CLI

Um bestimmte Contributor Insights-Regeln zu löschen

Im folgenden delete-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B im angegebenen Konto gelöscht.

aws cloudwatch delete-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungdelete-metric-stream.

AWS CLI

Um einen angegebenen Metrik-Stream zu löschen

Im folgenden delete-metric-stream Beispiel wird der QuickPartial-gSCKvO im angegebenen Konto angegebene Metrik-Stream gelöscht.

aws cloudwatch delete-metric-stream \ --name QuickPartial-gSCKvO

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-metric-stream.

AWS CLI

Um einen angegebenen Metrik-Stream zu löschen

Im folgenden delete-metric-stream Beispiel wird der QuickPartial-gSCKvO im angegebenen Konto angegebene Metrik-Stream gelöscht.

aws cloudwatch delete-metric-stream \ --name QuickPartial-gSCKvO

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarm-history.

AWS CLI

So rufen Sie den Verlauf eines Alarms ab

Im folgenden Beispiel wird der describe-alarm-history Befehl verwendet, um den Verlauf für den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ abzurufen:

aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate

Ausgabe:

{ "AlarmHistoryItems": [ { "Timestamp": "2014-04-09T18:59:06.442Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}", "HistorySummary": "Alarm updated from ALARM to OK" }, { "Timestamp": "2014-04-09T18:59:05.805Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}", "HistorySummary": "Alarm updated from OK to ALARM" } ] }

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarm-history.

AWS CLI

So rufen Sie den Verlauf eines Alarms ab

Im folgenden Beispiel wird der describe-alarm-history Befehl verwendet, um den Verlauf für den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ abzurufen:

aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate

Ausgabe:

{ "AlarmHistoryItems": [ { "Timestamp": "2014-04-09T18:59:06.442Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}", "HistorySummary": "Alarm updated from ALARM to OK" }, { "Timestamp": "2014-04-09T18:59:05.805Z", "HistoryItemType": "StateUpdate", "AlarmName": "myalarm", "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}", "HistorySummary": "Alarm updated from OK to ALARM" } ] }

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarms-for-metric.

AWS CLI

So zeigen Sie Informationen über Alarme an, die einer Metrik zugeordnet sind

Im folgenden Beispiel wird der describe-alarms-for-metric Befehl verwendet, um Informationen zu allen Alarmen anzuzeigen, die mit der EC2 CPUUtilization Amazon-Metrik und der Instance mit der ID i-0c986c72 verknüpft sind. :

aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72

Ausgabe:

{ "MetricAlarms": [ { "EvaluationPeriods": 10, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2", "StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z", "AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z", "ComparisonOperator": "GreaterThanOrEqualToThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:NotifyMe" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm2", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" }, { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:HighCPUAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": false, "MetricName": "CPUUtilization" } ] }

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarms-for-metric.

AWS CLI

So zeigen Sie Informationen über Alarme an, die einer Metrik zugeordnet sind

Im folgenden Beispiel wird der describe-alarms-for-metric Befehl verwendet, um Informationen zu allen Alarmen anzuzeigen, die mit der EC2 CPUUtilization Amazon-Metrik und der Instance mit der ID i-0c986c72 verknüpft sind. :

aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72

Ausgabe:

{ "MetricAlarms": [ { "EvaluationPeriods": 10, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2", "StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z", "AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z", "ComparisonOperator": "GreaterThanOrEqualToThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:NotifyMe" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm2", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" }, { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:111122223333:HighCPUAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myHighCpuAlarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": false, "MetricName": "CPUUtilization" } ] }

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarms.

AWS CLI

So listen Sie Informationen über einen Alarm auf

Im folgenden Beispiel wird der describe-alarms-Befehl verwendet, um Informationen über den Alarm mit dem Namen „myalarm“ bereitzustellen:

aws cloudwatch describe-alarms --alarm-names "myalarm"

Ausgabe:

{ "MetricAlarms": [ { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm:myalarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2012-12-27T00:49:54.032Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:123456789012:myHighCpuAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myalarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" } ] }
  • Einzelheiten zur API finden Sie DescribeAlarmsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-alarms.

AWS CLI

So listen Sie Informationen über einen Alarm auf

Im folgenden Beispiel wird der describe-alarms-Befehl verwendet, um Informationen über den Alarm mit dem Namen „myalarm“ bereitzustellen:

aws cloudwatch describe-alarms --alarm-names "myalarm"

Ausgabe:

{ "MetricAlarms": [ { "EvaluationPeriods": 2, "AlarmArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm:myalarm", "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z", "AlarmConfigurationUpdatedTimestamp": "2012-12-27T00:49:54.032Z", "ComparisonOperator": "GreaterThanThreshold", "AlarmActions": [ "arn:aws:sns:us-east-1:123456789012:myHighCpuAlarm" ], "Namespace": "AWS/EC2", "AlarmDescription": "CPU usage exceeds 70 percent", "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}", "Period": 300, "StateValue": "OK", "Threshold": 70.0, "AlarmName": "myalarm", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0c986c72" } ], "Statistic": "Average", "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].", "InsufficientDataActions": [], "OKActions": [], "ActionsEnabled": true, "MetricName": "CPUUtilization" } ] }
  • Einzelheiten zur API finden Sie DescribeAlarmsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-anomaly-detectors.

AWS CLI

Um eine Liste von Modellen zur Erkennung von Anomalien abzurufen

Im folgenden describe-anomaly-detectors Beispiel werden Informationen über Anomaliedetektormodelle angezeigt, die dem AWS/Logs Namespace im angegebenen Konto zugeordnet sind.

aws cloudwatch describe-anomaly-detectors \ --namespace AWS/Logs

Ausgabe:

{ "AnomalyDetectors": [ { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "TRAINED", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount" } }, { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "PENDING_TRAINING", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average" } } ] }

Weitere Informationen finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-anomaly-detectors.

AWS CLI

Um eine Liste von Modellen zur Erkennung von Anomalien abzurufen

Im folgenden describe-anomaly-detectors Beispiel werden Informationen über Anomaliedetektormodelle angezeigt, die dem AWS/Logs Namespace im angegebenen Konto zugeordnet sind.

aws cloudwatch describe-anomaly-detectors \ --namespace AWS/Logs

Ausgabe:

{ "AnomalyDetectors": [ { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "TRAINED", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [], "Stat": "SampleCount" } }, { "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average", "Configuration": { "ExcludedTimeRanges": [] }, "StateValue": "PENDING_TRAINING", "SingleMetricAnomalyDetector": { "AccountId": "123456789012", "Namespace": "AWS/Logs", "MetricName": "IncomingBytes", "Dimensions": [ { "Name": "LogGroupName", "Value": "demo" } ], "Stat": "Average" } } ] }

Weitere Informationen finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-insight-rules.

AWS CLI

Um eine Liste von Contributor Insights-Regeln abzurufen

Das folgende describe-insight-rules Beispiel zeigt alle Contributor Insight-Regeln im angegebenen Konto.

aws cloudwatch describe-insight-rules

Ausgabe:

{ "InsightRules": [ { "Name": "Rule-A", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}", "ManagedRule": false }, { "Name": "Rule-B", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}", "ManagedRule": false } ] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungdescribe-insight-rules.

AWS CLI

Um eine Liste von Contributor Insights-Regeln abzurufen

Das folgende describe-insight-rules Beispiel zeigt alle Contributor Insight-Regeln im angegebenen Konto.

aws cloudwatch describe-insight-rules

Ausgabe:

{ "InsightRules": [ { "Name": "Rule-A", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}", "ManagedRule": false }, { "Name": "Rule-B", "State": "ENABLED", "Schema": "CloudWatchLogRule/1", "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}", "ManagedRule": false } ] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungdisable-alarm-actions.

AWS CLI

So deaktivieren Sie Aktionen für einen Alarm

Das folgende Beispiel verwendet den disable-alarm-actions-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu deaktivieren:

aws cloudwatch disable-alarm-actions --alarm-names myalarm

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

Das folgende Codebeispiel zeigt die Verwendungdisable-alarm-actions.

AWS CLI

So deaktivieren Sie Aktionen für einen Alarm

Das folgende Beispiel verwendet den disable-alarm-actions-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu deaktivieren:

aws cloudwatch disable-alarm-actions --alarm-names myalarm

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

Das folgende Codebeispiel zeigt die Verwendungdisable-insight-rules.

AWS CLI

Um bestimmte Contributor Insight-Regeln zu deaktivieren

Im folgenden disable-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B im angegebenen Konto deaktiviert.

aws cloudwatch disable-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungdisable-insight-rules.

AWS CLI

Um bestimmte Contributor Insight-Regeln zu deaktivieren

Im folgenden disable-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B im angegebenen Konto deaktiviert.

aws cloudwatch disable-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungenable-alarm-actions.

AWS CLI

So aktivieren Sie alle Aktionen für einen Alarm

Das folgende Beispiel verwendet den enable-alarm-actions-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu aktivieren:

aws cloudwatch enable-alarm-actions --alarm-names myalarm

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

Das folgende Codebeispiel zeigt die Verwendungenable-alarm-actions.

AWS CLI

So aktivieren Sie alle Aktionen für einen Alarm

Das folgende Beispiel verwendet den enable-alarm-actions-Befehl, um alle Aktionen für den Alarm mit dem Namen „myalarm“ zu aktivieren:

aws cloudwatch enable-alarm-actions --alarm-names myalarm

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

Das folgende Codebeispiel zeigt die Verwendungenable-insight-rules.

AWS CLI

Um bestimmte Contributor Insight-Regeln zu aktivieren

Im folgenden enable-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B für das angegebene Konto aktiviert.

aws cloudwatch enable-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungenable-insight-rules.

AWS CLI

Um bestimmte Contributor Insight-Regeln zu aktivieren

Im folgenden enable-insight-rules Beispiel werden zwei Contributor Insights-Regeln mit dem Namen Rule-A und Rule-B für das angegebene Konto aktiviert.

aws cloudwatch enable-insight-rules \ --rule-names Rule-A Rule-B

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungget-dashboard.

AWS CLI

Um Informationen über ein Dashboard abzurufen

Im folgenden get-dashboard Beispiel werden Informationen über das Dashboard angezeigt, das Dashboard-A im angegebenen Konto benannt ist.

aws cloudwatch get-dashboard \ --dashboard-name Dashboard-A

Ausgabe:

{ "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}", "DashboardName": "Dashboard-A" }

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetDashboardin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-dashboard.

AWS CLI

Um Informationen über ein Dashboard abzurufen

Im folgenden get-dashboard Beispiel werden Informationen über das Dashboard angezeigt, das Dashboard-A im angegebenen Konto benannt ist.

aws cloudwatch get-dashboard \ --dashboard-name Dashboard-A

Ausgabe:

{ "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}", "DashboardName": "Dashboard-A" }

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetDashboardin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-insight-rule-report.

AWS CLI

Um die mit einer Contributor Insights-Regel gesammelten Zeitreihendaten abzurufen

Im folgenden get-insight-rule-report Beispiel werden die Zeitreihendaten zurückgegeben, die mit einer Contributor Insights-Regel gesammelt wurden.

aws cloudwatch get-insight-rule-report \ --rule-name Rule-A \ --start-time 2024-10-13T20:15:00Z \ --end-time 2024-10-13T20:30:00Z \ --period 300

Ausgabe:

{ "KeyLabels": [ "PartitionKey" ], "AggregationStatistic": "Sum", "AggregateValue": 0.5, "ApproximateUniqueCount": 1, "Contributors": [ { "Keys": [ "RequestID" ], "ApproximateAggregateValue": 0.5, "Datapoints": [ { "Timestamp": "2024-10-13T21:00:00+00:00", "ApproximateValue": 0.5 } ] } ], "RuleAttributes": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungget-insight-rule-report.

AWS CLI

Um die mit einer Contributor Insights-Regel gesammelten Zeitreihendaten abzurufen

Im folgenden get-insight-rule-report Beispiel werden die Zeitreihendaten zurückgegeben, die mit einer Contributor Insights-Regel gesammelt wurden.

aws cloudwatch get-insight-rule-report \ --rule-name Rule-A \ --start-time 2024-10-13T20:15:00Z \ --end-time 2024-10-13T20:30:00Z \ --period 300

Ausgabe:

{ "KeyLabels": [ "PartitionKey" ], "AggregationStatistic": "Sum", "AggregateValue": 0.5, "ApproximateUniqueCount": 1, "Contributors": [ { "Keys": [ "RequestID" ], "ApproximateAggregateValue": 0.5, "Datapoints": [ { "Timestamp": "2024-10-13T21:00:00+00:00", "ApproximateValue": 0.5 } ] } ], "RuleAttributes": [] }

Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität. CloudWatch

Das folgende Codebeispiel zeigt die Verwendungget-metric-data.

AWS CLI

Beispiel 1: Um mithilfe eines mathematischen Ausdrucks den durchschnittlichen Gesamt-IOPS-Wert für den EC2 angegebenen Wert zu ermitteln

Im folgenden get-metric-data Beispiel werden CloudWatch Metrikwerte für die EC2 Instanz mit InstanceID i-abcdef mithilfe eines metrischen mathematischen Ausdrucks abgerufen, der Metriken kombiniert. EBSReadOps EBSWriteOps

aws cloudwatch get-metric-data \ --metric-data-queries file://file.json \ --start-time 2024-09-29T22:10:00Z \ --end-time 2024-09-29T22:15:00Z

Inhalt von file.json:

[ { "Id": "m3", "Expression": "(m1+m2)/300", "Label": "Avg Total IOPS" }, { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSReadOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false }, { "Id": "m2", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSWriteOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false } ]

Ausgabe:

{ "MetricDataResults": [ { "Id": "m3", "Label": "Avg Total IOPS", "Timestamps": [ "2024-09-29T22:10:00+00:00" ], "Values": [ 96.85 ], "StatusCode": "Complete" } ], "Messages": [] }

Beispiel 2: Um die geschätzten Gebühren anhand von Abrechnungskennzahlen zu überwachen AWS CloudWatch

Im folgenden get-metric-data Beispiel wird die EstimatedCharges CloudWatch Metrik aus dem Namespace AWS/Billing abgerufen.

aws cloudwatch get-metric-data \ --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \ --start-time 2024-09-26T12:00:00Z \ --end-time 2024-09-26T18:00:00Z \ --region us-east-1

Ausgabe:

{ "MetricDataResults": [ { "Id": "m1", "Label": "EstimatedCharges", "Timestamps": [ "2024-09-26T12:00:00+00:00" ], "Values": [ 542.38 ], "StatusCode": "Complete" } ], "Messages": [] }

Weitere Informationen finden Sie unter Verwenden von mathematischen Ausdrücken mit CloudWatch Metriken im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetMetricDatain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-metric-data.

AWS CLI

Beispiel 1: Um mithilfe eines mathematischen Ausdrucks den durchschnittlichen Gesamt-IOPS-Wert für den EC2 angegebenen Wert zu ermitteln

Im folgenden get-metric-data Beispiel werden CloudWatch Metrikwerte für die EC2 Instanz mit InstanceID i-abcdef mithilfe eines metrischen mathematischen Ausdrucks abgerufen, der Metriken kombiniert. EBSReadOps EBSWriteOps

aws cloudwatch get-metric-data \ --metric-data-queries file://file.json \ --start-time 2024-09-29T22:10:00Z \ --end-time 2024-09-29T22:15:00Z

Inhalt von file.json:

[ { "Id": "m3", "Expression": "(m1+m2)/300", "Label": "Avg Total IOPS" }, { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSReadOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false }, { "Id": "m2", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "EBSWriteOps", "Dimensions": [ { "Name": "InstanceId", "Value": "i-abcdef" } ] }, "Period": 300, "Stat": "Sum", "Unit": "Count" }, "ReturnData": false } ]

Ausgabe:

{ "MetricDataResults": [ { "Id": "m3", "Label": "Avg Total IOPS", "Timestamps": [ "2024-09-29T22:10:00+00:00" ], "Values": [ 96.85 ], "StatusCode": "Complete" } ], "Messages": [] }

Beispiel 2: Um die geschätzten Gebühren anhand von Abrechnungskennzahlen zu überwachen AWS CloudWatch

Im folgenden get-metric-data Beispiel wird die EstimatedCharges CloudWatch Metrik aus dem Namespace AWS/Billing abgerufen.

aws cloudwatch get-metric-data \ --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \ --start-time 2024-09-26T12:00:00Z \ --end-time 2024-09-26T18:00:00Z \ --region us-east-1

Ausgabe:

{ "MetricDataResults": [ { "Id": "m1", "Label": "EstimatedCharges", "Timestamps": [ "2024-09-26T12:00:00+00:00" ], "Values": [ 542.38 ], "StatusCode": "Complete" } ], "Messages": [] }

Weitere Informationen finden Sie unter Verwenden von mathematischen Ausdrücken mit CloudWatch Metriken im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetMetricDatain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-metric-statistics.

AWS CLI

Um die CPU-Auslastung pro EC2 Instanz zu ermitteln

Im folgenden Beispiel wird der get-metric-statistics Befehl verwendet, um die CPU-Auslastung für eine EC2 Instanz mit der ID i-abcdef abzurufen.

aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef

Ausgabe:

{ "Datapoints": [ { "Timestamp": "2014-04-09T11:18:00Z", "Maximum": 44.79, "Unit": "Percent" }, { "Timestamp": "2014-04-09T20:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T19:18:00Z", "Maximum": 50.85, "Unit": "Percent" }, { "Timestamp": "2014-04-09T09:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T03:18:00Z", "Maximum": 76.84, "Unit": "Percent" }, { "Timestamp": "2014-04-09T21:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T14:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T08:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T16:18:00Z", "Maximum": 45.55, "Unit": "Percent" }, { "Timestamp": "2014-04-09T06:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T13:18:00Z", "Maximum": 45.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T05:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T18:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T17:18:00Z", "Maximum": 52.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T07:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T02:18:00Z", "Maximum": 51.23, "Unit": "Percent" }, { "Timestamp": "2014-04-09T12:18:00Z", "Maximum": 47.67, "Unit": "Percent" }, { "Timestamp": "2014-04-08T23:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T10:18:00Z", "Maximum": 51.91, "Unit": "Percent" }, { "Timestamp": "2014-04-09T04:18:00Z", "Maximum": 47.13, "Unit": "Percent" }, { "Timestamp": "2014-04-09T15:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T00:18:00Z", "Maximum": 48.16, "Unit": "Percent" }, { "Timestamp": "2014-04-09T01:18:00Z", "Maximum": 49.18, "Unit": "Percent" } ], "Label": "CPUUtilization" }

Angeben mehrerer Dimensionen

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar mit einem Komma zwischen dem Namen und dem Wert angegeben. Mehrere Dimensionen sind durch ein Leerzeichen getrennt. Wenn eine einzelne Metrik mehrere Dimensionen enthält, müssen Sie für jede definierte Dimension einen Wert angeben.

Weitere Beispiele für die Verwendung des get-metric-statistics Befehls finden Sie unter Get Statistics for a Metric im Amazon CloudWatch Developer Guide.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

Das folgende Codebeispiel zeigt die Verwendungget-metric-statistics.

AWS CLI

Um die CPU-Auslastung pro EC2 Instanz zu ermitteln

Im folgenden Beispiel wird der get-metric-statistics Befehl verwendet, um die CPU-Auslastung für eine EC2 Instanz mit der ID i-abcdef abzurufen.

aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef

Ausgabe:

{ "Datapoints": [ { "Timestamp": "2014-04-09T11:18:00Z", "Maximum": 44.79, "Unit": "Percent" }, { "Timestamp": "2014-04-09T20:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T19:18:00Z", "Maximum": 50.85, "Unit": "Percent" }, { "Timestamp": "2014-04-09T09:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T03:18:00Z", "Maximum": 76.84, "Unit": "Percent" }, { "Timestamp": "2014-04-09T21:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T14:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T08:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T16:18:00Z", "Maximum": 45.55, "Unit": "Percent" }, { "Timestamp": "2014-04-09T06:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T13:18:00Z", "Maximum": 45.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T05:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T18:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T17:18:00Z", "Maximum": 52.08, "Unit": "Percent" }, { "Timestamp": "2014-04-09T07:18:00Z", "Maximum": 47.92, "Unit": "Percent" }, { "Timestamp": "2014-04-09T02:18:00Z", "Maximum": 51.23, "Unit": "Percent" }, { "Timestamp": "2014-04-09T12:18:00Z", "Maximum": 47.67, "Unit": "Percent" }, { "Timestamp": "2014-04-08T23:18:00Z", "Maximum": 46.88, "Unit": "Percent" }, { "Timestamp": "2014-04-09T10:18:00Z", "Maximum": 51.91, "Unit": "Percent" }, { "Timestamp": "2014-04-09T04:18:00Z", "Maximum": 47.13, "Unit": "Percent" }, { "Timestamp": "2014-04-09T15:18:00Z", "Maximum": 48.96, "Unit": "Percent" }, { "Timestamp": "2014-04-09T00:18:00Z", "Maximum": 48.16, "Unit": "Percent" }, { "Timestamp": "2014-04-09T01:18:00Z", "Maximum": 49.18, "Unit": "Percent" } ], "Label": "CPUUtilization" }

Angeben mehrerer Dimensionen

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar mit einem Komma zwischen dem Namen und dem Wert angegeben. Mehrere Dimensionen sind durch ein Leerzeichen getrennt. Wenn eine einzelne Metrik mehrere Dimensionen enthält, müssen Sie für jede definierte Dimension einen Wert angeben.

Weitere Beispiele für die Verwendung des get-metric-statistics Befehls finden Sie unter Get Statistics for a Metric im Amazon CloudWatch Developer Guide.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

Das folgende Codebeispiel zeigt die Verwendungget-metric-stream.

AWS CLI

Um Informationen über einen Metrik-Stream abzurufen

Im folgenden get-metric-stream Beispiel werden Informationen über den Metrik-Stream angezeigt, der QuickFull-GuaFbs im angegebenen Konto benannt ist.

aws cloudwatch get-metric-stream \ --name QuickFull-GuaFbs

Ausgabe:

{ "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3", "State": "running", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "OutputFormat": "json", "IncludeLinkedAccountsMetrics": false }

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetMetricStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-metric-stream.

AWS CLI

Um Informationen über einen Metrik-Stream abzurufen

Im folgenden get-metric-stream Beispiel werden Informationen über den Metrik-Stream angezeigt, der QuickFull-GuaFbs im angegebenen Konto benannt ist.

aws cloudwatch get-metric-stream \ --name QuickFull-GuaFbs

Ausgabe:

{ "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3", "State": "running", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "OutputFormat": "json", "IncludeLinkedAccountsMetrics": false }

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetMetricStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-metric-widget-image.

AWS CLI

Um ein Snapshot-Diagramm von abzurufen CPUUtilization

Im folgenden get-metric-widget-image Beispiel wird das Snapshot-Diagramm für die Metrik CPUUtilization der EC2 Instanz mit der ID abgerufen i-abcde und das abgerufene Bild als Datei mit dem Namen "image.png" auf Ihrem lokalen Computer gespeichert.

aws cloudwatch get-metric-widget-image \ --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \ --output-format png \ --output text | base64 --decode > image.png

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungget-metric-widget-image.

AWS CLI

Um ein Snapshot-Diagramm von abzurufen CPUUtilization

Im folgenden get-metric-widget-image Beispiel wird das Snapshot-Diagramm für die Metrik CPUUtilization der EC2 Instanz mit der ID abgerufen i-abcde und das abgerufene Bild als Datei mit dem Namen "image.png" auf Ihrem lokalen Computer gespeichert.

aws cloudwatch get-metric-widget-image \ --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \ --output-format png \ --output text | base64 --decode > image.png

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendunglist-dashboards.

AWS CLI

Um eine Liste von Dashboards abzurufen

Das folgende list-dashboards Beispiel listet alle Dashboards im angegebenen Konto auf.

aws cloudwatch list-dashboards

Ausgabe:

{ "DashboardEntries": [ { "DashboardName": "Dashboard-A", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "LastModified": "2024-10-11T18:40:11+00:00", "Size": 271 }, { "DashboardName": "Dashboard-B", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B", "LastModified": "2024-10-11T18:44:41+00:00", "Size": 522 } ] }

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ListDashboardsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-dashboards.

AWS CLI

Um eine Liste von Dashboards abzurufen

Das folgende list-dashboards Beispiel listet alle Dashboards im angegebenen Konto auf.

aws cloudwatch list-dashboards

Ausgabe:

{ "DashboardEntries": [ { "DashboardName": "Dashboard-A", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A", "LastModified": "2024-10-11T18:40:11+00:00", "Size": 271 }, { "DashboardName": "Dashboard-B", "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B", "LastModified": "2024-10-11T18:44:41+00:00", "Size": 522 } ] }

Weitere Informationen finden Sie unter CloudWatch Amazon-Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ListDashboardsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-metric-streams.

AWS CLI

Um eine Liste von Metrik-Streams abzurufen

Das folgende list-metric-streams Beispiel listet alle Metrik-Streams im angegebenen Konto auf.

aws cloudwatch list-metric-streams

Ausgabe:

{ "Entries": [ { "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "State": "running", "OutputFormat": "json" } ] }

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-metric-streams.

AWS CLI

Um eine Liste von Metrik-Streams abzurufen

Das folgende list-metric-streams Beispiel listet alle Metrik-Streams im angegebenen Konto auf.

aws cloudwatch list-metric-streams

Ausgabe:

{ "Entries": [ { "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs", "CreationDate": "2024-10-11T18:48:59.187000+00:00", "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00", "Name": "QuickFull-GuaFbs", "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG", "State": "running", "OutputFormat": "json" } ] }

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-metrics.

AWS CLI

So listen Sie die Metriken für Amazon SNS auf

Im folgenden list-metrics-Beispiel werden die Metriken für Amazon SNS angezeigt.

aws cloudwatch list-metrics \ --namespace "AWS/SNS"

Ausgabe:

{ "Metrics": [ { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsFailed" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsFailed" } ] }
  • Einzelheiten zur API finden Sie ListMetricsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-metrics.

AWS CLI

So listen Sie die Metriken für Amazon SNS auf

Im folgenden list-metrics-Beispiel werden die Metriken für Amazon SNS angezeigt.

aws cloudwatch list-metrics \ --namespace "AWS/SNS"

Ausgabe:

{ "Metrics": [ { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "PublishSize" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsFailed" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "NotifyMe" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfMessagesPublished" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsDelivered" }, { "Namespace": "AWS/SNS", "Dimensions": [ { "Name": "TopicName", "Value": "CFO" } ], "MetricName": "NumberOfNotificationsFailed" } ] }
  • Einzelheiten zur API finden Sie ListMetricsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

Um die Tags aufzulisten, die mit einem vorhandenen Alarm verknüpft sind*

Das folgende list-tags-for-resource Beispiel listet alle Tags auf, die einem Alarm zugeordnet sind, der demo im angegebenen Konto benannt ist.

aws cloudwatch list-tags-for-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo

Ausgabe:

{ "Tags": [ { "Key": "stack", "Value": "Production" }, { "Key": "team", "Value": "Devops" } ] }

Weitere Informationen finden Sie unter Alarme und Tagging im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

Um die Tags aufzulisten, die mit einem vorhandenen Alarm verknüpft sind*

Das folgende list-tags-for-resource Beispiel listet alle Tags auf, die einem Alarm zugeordnet sind, der demo im angegebenen Konto benannt ist.

aws cloudwatch list-tags-for-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo

Ausgabe:

{ "Tags": [ { "Key": "stack", "Value": "Production" }, { "Key": "team", "Value": "Devops" } ] }

Weitere Informationen finden Sie unter Alarme und Tagging im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-anomaly-detector.

AWS CLI

Um ein Modell zur Erkennung von Anomalien zu erstellen

Im folgenden put-anomaly-detector Beispiel wird ein Modell zur Erkennung von Anomalien für eine CloudWatch Metrik erstellt.

aws cloudwatch put-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-anomaly-detector.

AWS CLI

Um ein Modell zur Erkennung von Anomalien zu erstellen

Im folgenden put-anomaly-detector Beispiel wird ein Modell zur Erkennung von Anomalien für eine CloudWatch Metrik erstellt.

aws cloudwatch put-anomaly-detector \ --namespace AWS/Logs \ --metric-name IncomingBytes \ --stat SampleCount

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-composite-alarm.

AWS CLI

Um einen zusammengesetzten Cloudwatch-Alarm zu erstellen

Im folgenden put-composite-alarm Beispiel wird ein zusammengesetzter Alarm mit dem Namen ProdAlarm des angegebenen Kontos erstellt.

aws cloudwatch put-composite-alarm \ --alarm-name ProdAlarm \ --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \ --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \ --actions-enabled

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines zusammengesetzten Alarms im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-composite-alarm.

AWS CLI

Um einen zusammengesetzten Cloudwatch-Alarm zu erstellen

Im folgenden put-composite-alarm Beispiel wird ein zusammengesetzter Alarm mit dem Namen ProdAlarm des angegebenen Kontos erstellt.

aws cloudwatch put-composite-alarm \ --alarm-name ProdAlarm \ --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \ --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \ --actions-enabled

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines zusammengesetzten Alarms im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-dashboard.

AWS CLI

Um ein Dashboard zu erstellen

Im folgenden put-dashboard Beispiel wird ein Dashboard mit Dashboard-A dem Namen des angegebenen Kontos erstellt.

aws cloudwatch put-dashboard \ --dashboard-name Dashboard-A \ --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'

Ausgabe:

{ "DashboardValidationMessages": [] }

Weitere Informationen finden Sie unter Erstellen eines CloudWatch Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutDashboardin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-dashboard.

AWS CLI

Um ein Dashboard zu erstellen

Im folgenden put-dashboard Beispiel wird ein Dashboard mit Dashboard-A dem Namen des angegebenen Kontos erstellt.

aws cloudwatch put-dashboard \ --dashboard-name Dashboard-A \ --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'

Ausgabe:

{ "DashboardValidationMessages": [] }

Weitere Informationen finden Sie unter Erstellen eines CloudWatch Dashboards im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutDashboardin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-insight-rule.

AWS CLI

Um eine Contributor Insights-Regel zu erstellen

Im folgenden put-insight-rule Beispiel wird eine Contributor Insights-Regel mit dem Namen VPCFlowLogsContributorInsights des angegebenen Kontos erstellt.

aws cloudwatch put-insight-rule \ --rule-name VPCFlowLogsContributorInsights \ --rule-definition file://insight-rule.json \ --rule-state ENABLED

Inhalt von insight-rule.json:

{ "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Count", "Contribution": { "Filters": [], "Keys": [ "tcp-flag" ] }, "LogFormat": "CLF", "LogGroupNames": [ "/vpc/flowlogs/*" ], "Fields": { "23": "tcp-flag" } }

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer Contributor Insights-Regel CloudWatch im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-insight-rule.

AWS CLI

Um eine Contributor Insights-Regel zu erstellen

Im folgenden put-insight-rule Beispiel wird eine Contributor Insights-Regel mit dem Namen VPCFlowLogsContributorInsights des angegebenen Kontos erstellt.

aws cloudwatch put-insight-rule \ --rule-name VPCFlowLogsContributorInsights \ --rule-definition file://insight-rule.json \ --rule-state ENABLED

Inhalt von insight-rule.json:

{ "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Count", "Contribution": { "Filters": [], "Keys": [ "tcp-flag" ] }, "LogFormat": "CLF", "LogGroupNames": [ "/vpc/flowlogs/*" ], "Fields": { "23": "tcp-flag" } }

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen einer Contributor Insights-Regel CloudWatch im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-metric-alarm.

AWS CLI

So senden Sie eine E-Mail-Nachricht von Amazon Simple Notification Service, wenn die CPU-Auslastung 70 % übersteigt

Im folgenden Beispiel wird der put-metric-alarm-Befehl verwendet, um eine E-Mail-Nachricht von Amazon Simple Notification Service zu senden, wenn die CPU-Auslastung 70 % übersteigt:

aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück. Wenn ein Alarm mit demselben Namen bereits vorhanden ist, wird er durch den neuen Alarm überschrieben.

So geben Sie mehrere Dimensionen an

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar mit einem Komma zwischen dem Namen und dem Wert angegeben. Mehrere Dimensionen werden durch ein Leerzeichen getrennt:

aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2
  • Einzelheiten zur API finden Sie PutMetricAlarmin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-metric-alarm.

AWS CLI

So senden Sie eine E-Mail-Nachricht von Amazon Simple Notification Service, wenn die CPU-Auslastung 70 % übersteigt

Im folgenden Beispiel wird der put-metric-alarm-Befehl verwendet, um eine E-Mail-Nachricht von Amazon Simple Notification Service zu senden, wenn die CPU-Auslastung 70 % übersteigt:

aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück. Wenn ein Alarm mit demselben Namen bereits vorhanden ist, wird er durch den neuen Alarm überschrieben.

So geben Sie mehrere Dimensionen an

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar mit einem Komma zwischen dem Namen und dem Wert angegeben. Mehrere Dimensionen werden durch ein Leerzeichen getrennt:

aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2
  • Einzelheiten zur API finden Sie PutMetricAlarmin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-metric-data.

AWS CLI

Um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch

Im folgenden Beispiel wird der put-metric-data Befehl verwendet, um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch:

aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json

Die Werte für die Metrik selbst werden in der JSON-Datei metric.json gespeichert.

Hier ist der Inhalt dieser Datei:

[ { "MetricName": "New Posts", "Timestamp": "Wednesday, June 12, 2013 8:28:20 PM", "Value": 0.50, "Unit": "Count" } ]

Weitere Informationen finden Sie unter Veröffentlichen benutzerdefinierter Metriken im Amazon CloudWatch Developer Guide.

So geben Sie mehrere Dimensionen an

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar angegeben. Mehrere Dimensionen sind durch ein Komma getrennt:

aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceID=1-23456789,InstanceType=m1.small
  • Einzelheiten zur API finden Sie PutMetricDatain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-metric-data.

AWS CLI

Um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch

Im folgenden Beispiel wird der put-metric-data Befehl verwendet, um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch:

aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json

Die Werte für die Metrik selbst werden in der JSON-Datei metric.json gespeichert.

Hier ist der Inhalt dieser Datei:

[ { "MetricName": "New Posts", "Timestamp": "Wednesday, June 12, 2013 8:28:20 PM", "Value": 0.50, "Unit": "Count" } ]

Weitere Informationen finden Sie unter Veröffentlichen benutzerdefinierter Metriken im Amazon CloudWatch Developer Guide.

So geben Sie mehrere Dimensionen an

Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar angegeben. Mehrere Dimensionen sind durch ein Komma getrennt:

aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceID=1-23456789,InstanceType=m1.small
  • Einzelheiten zur API finden Sie PutMetricDatain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-metric-stream.

AWS CLI

Um einen Metrik-Stream zu erstellen

Im folgenden put-metric-stream Beispiel wird ein Metrik-Stream mit QuickFull-GuaFb dem Namen des angegebenen Kontos erstellt.

aws cloudwatch put-metric-stream \ --name QuickFull-GuaFbs \ --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \ --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \ --output-format json \ --no-include-linked-accounts-metrics

Ausgabe:

{ "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs" }

Weitere Informationen finden Sie unter Metrik-Stream einrichten im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutMetricStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungput-metric-stream.

AWS CLI

Um einen Metrik-Stream zu erstellen

Im folgenden put-metric-stream Beispiel wird ein Metrik-Stream mit QuickFull-GuaFb dem Namen des angegebenen Kontos erstellt.

aws cloudwatch put-metric-stream \ --name QuickFull-GuaFbs \ --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \ --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \ --output-format json \ --no-include-linked-accounts-metrics

Ausgabe:

{ "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs" }

Weitere Informationen finden Sie unter Metrik-Stream einrichten im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutMetricStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungset-alarm-state.

AWS CLI

Um den Status eines Alarms vorübergehend zu ändern

Im folgenden Beispiel wird der set-alarm-state Befehl verwendet, um den Status eines CloudWatch Amazon-Alarms mit dem Namen „myalarm“ vorübergehend zu ändern und ihn zu Testzwecken auf den ALARM-Status zu setzen:

aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes"

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

  • Einzelheiten zur API finden Sie SetAlarmStatein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungset-alarm-state.

AWS CLI

Um den Status eines Alarms vorübergehend zu ändern

Im folgenden Beispiel wird der set-alarm-state Befehl verwendet, um den Status eines CloudWatch Amazon-Alarms mit dem Namen „myalarm“ vorübergehend zu ändern und ihn zu Testzwecken auf den ALARM-Status zu setzen:

aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes"

Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.

  • Einzelheiten zur API finden Sie SetAlarmStatein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-metric-streams.

AWS CLI

Um einen bestimmten Metrik-Stream zu starten

Im folgenden start-metric-streams Beispiel wird der Metrik-Stream gestartet, der QuickFull-GuaFbs im angegebenen Konto benannt ist.

aws cloudwatch start-metric-streams \ --names QuickFull-GuaFbs

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungstart-metric-streams.

AWS CLI

Um einen bestimmten Metrik-Stream zu starten

Im folgenden start-metric-streams Beispiel wird der Metrik-Stream gestartet, der QuickFull-GuaFbs im angegebenen Konto benannt ist.

aws cloudwatch start-metric-streams \ --names QuickFull-GuaFbs

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungstop-metric-streams.

AWS CLI

Um einen bestimmten Metrik-Stream zu stoppen

Im folgenden stop-metric-streams Beispiel wird der QuickFull-GuaFbs im angegebenen Konto angegebene Metrik-Stream gestoppt.

aws cloudwatch stop-metric-streams \ --names QuickFull-GuaFbs

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungstop-metric-streams.

AWS CLI

Um einen bestimmten Metrik-Stream zu stoppen

Im folgenden stop-metric-streams Beispiel wird der QuickFull-GuaFbs im angegebenen Konto angegebene Metrik-Stream gestoppt.

aws cloudwatch stop-metric-streams \ --names QuickFull-GuaFbs

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden von Metrik-Streams im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

Um der angegebenen Ressource ein oder mehrere Tags hinzuzufügen

Das folgende tag-resource Beispiel fügt dem Cloudwatch-Alarm, der demo im angegebenen Konto benannt ist, zwei Tags hinzu.

aws cloudwatch tag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tags Key=stack,Value=Production Key=team,Value=Devops

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

Um der angegebenen Ressource ein oder mehrere Tags hinzuzufügen

Das folgende tag-resource Beispiel fügt dem Cloudwatch-Alarm, der demo im angegebenen Konto benannt ist, zwei Tags hinzu.

aws cloudwatch tag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tags Key=stack,Value=Production Key=team,Value=Devops

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

Um ein oder mehrere Tags aus der angegebenen Ressource zu entfernen

Im folgenden untag-resource Beispiel werden 2 Tags aus dem Cloudwatch-Alarm entfernt, der demo im angegebenen Konto benannt ist.

aws cloudwatch untag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tag-keys stack team

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

Um ein oder mehrere Tags aus der angegebenen Ressource zu entfernen

Im folgenden untag-resource Beispiel werden 2 Tags aus dem Cloudwatch-Alarm entfernt, der demo im angegebenen Konto benannt ist.

aws cloudwatch untag-resource \ --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \ --tag-keys stack team

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.