CloudWatch-Beispiele unter Verwendung von AWS CLI - AWS-SDK-Codebeispiele

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

CloudWatch-Beispiele unter Verwendung von AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS Command Line Interface mit CloudWatch nutzen.

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

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

Themen

Aktionen

Die folgenden Codebeispiele zeigen, wie delete-alarms verwendet wird.

AWS CLI

So löschen Sie einen Alarm

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

aws cloudwatch delete-alarms --alarm-names myalarm

Ausgabe:

This command returns to the prompt if successful.
  • Weitere API-Informationen finden Sie unter DeleteAlarms in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-anomaly-detector verwendet wird.

AWS CLI

So löschen Sie ein bestimmtes Anomalieerkennungsmodell

Im folgenden Beispiel für delete-anomaly-detector wird ein Anomalieerkennungsmodell 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 Anomalieerkennungsmodells im Benutzerhandbuch für Amazon CloudWatch.

Die folgenden Codebeispiele zeigen, wie delete-dashboards verwendet wird.

AWS CLI

So löschen Sie bestimmte Dashboards

Im folgenden Beispiel für delete-dashboards werden zwei Dashboards mit den 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 Amazon-CloudWatch-Dashboards im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter DeleteDashboards in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-insight-rules verwendet wird.

AWS CLI

So löschen Sie angegebene Contributor-Insights-Regeln

Im folgenden Beispiel für delete-insight-rules 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 unter Verwenden von Contributor Insights zum Analysieren von Daten mit hoher Kardinalität im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter DeleteInsightRules in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie delete-metric-stream verwendet wird.

AWS CLI

So löschen Sie einen angegebenen Metrik-Stream

Im folgenden Beispiel für delete-metric-stream wird der Metrik-Stream mit dem Namen QuickPartial-gSCKvO im angegebenen Konto 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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter DeleteMetricStream in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-alarm-history verwendet wird.

AWS CLI

So rufen Sie den Verlauf eines Alarms ab

Im folgenden Beispiel wird der describe-alarm-history-Befehl verwendet, um den Verlauf des Amazon-CloudWatch-Alarms 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" } ] }

Die folgenden Codebeispiele zeigen, wie describe-alarms-for-metric verwendet wird.

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 über alle Alarme anzuzeigen, die der Amazon-EC2-Metrik CPUUtilization und der Instance mit der ID i-0c986c72 zugeordnet 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" } ] }

Die folgenden Codebeispiele zeigen, wie describe-alarms verwendet wird.

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" } ] }
  • Weitere API-Informationen finden Sie unter DescribeAlarms in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie describe-anomaly-detectors verwendet wird.

AWS CLI

So rufen Sie eine Liste von Modellen zur Erkennung von Anomalien ab

Im folgenden Beispiel für describe-anomaly-detectors werden Informationen zu Anomalieerkennungsmodellen 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 zu Alarmen finden Sie unter Verwenden von Amazon-CloudWatch-Alarmen im Benutzerhandbuch für Amazon CloudWatch.

Die folgenden Codebeispiele zeigen, wie describe-insight-rules verwendet wird.

AWS CLI

So rufen Sie eine Liste von Contributor-Insights-Regeln ab

Im folgenden Beispiel für describe-insight-rules werden alle Contributor-Insights-Regeln im angegebenen Konto angezeigt.

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 unter Verwenden von Contributor Insights zum Analysieren von Daten mit hoher Kardinalität im Benutzerhandbuch für Amazon CloudWatch.

Die folgenden Codebeispiele zeigen, wie disable-alarm-actions verwendet wird.

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 zum Prompt zurück.

  • Weitere API-Informationen finden Sie unter DisableAlarmActions in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie disable-insight-rules verwendet wird.

AWS CLI

So deaktivieren Sie bestimmte Contributor-Insight-Regeln

Im folgenden Beispiel für disable-insight-rules 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 unter Verwenden von Contributor Insights zum Analysieren von Daten mit hoher Kardinalität im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter DisableInsightRules in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie enable-alarm-actions verwendet wird.

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 zum Prompt zurück.

  • Weitere API-Informationen finden Sie unter EnableAlarmActions in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie enable-insight-rules verwendet wird.

AWS CLI

So aktivieren Sie bestimmte Contributor-Insight-Regeln

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

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

Ausgabe:

{ "Failures": [] }

Weitere Informationen finden Sie unter Verwenden von Contributor Insights zum Analysieren von Daten mit hoher Kardinalität im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter EnableInsightRules in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-dashboard verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Dashboard ab

Im folgenden Beispiel für get-dashboard werden Informationen zum Dashboard Dashboard-A im angegebenen Konto angezeigt.

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 Amazon-CloudWatch-Dashboards im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter GetDashboard in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-insight-rule-report verwendet wird.

AWS CLI

So rufen Sie die Zeitreihendaten ab, die durch eine Contributor-Insights-Regel erfasst wurden

Im folgenden Beispiel für get-insight-rule-report werden die Zeitreihendaten zurückgegeben, die durch eine Contributor-Insights-Regel erfasst 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 unter Verwenden von Contributor Insights zum Analysieren von Daten mit hoher Kardinalität im Benutzerhandbuch für Amazon CloudWatch.

Die folgenden Codebeispiele zeigen, wie get-metric-data verwendet wird.

AWS CLI

Beispiel 1: So rufen Sie die durchschnittlichen Gesamt-IOPS für die angegebene EC2-Instance mithilfe eines mathematischen Ausdrucks ab

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

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: So überwachen Sie die geschätzten AWS-Gebühren mithilfe von CloudWatch-Abrechnungsmetriken

Im folgenden Beispiel für get-metric-data wird die CloudWatch-Metrik EstimatedCharges 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 mathematischer Ausdrücke mit CloudWatch-Metriken im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter GetMetricData in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-metric-statistics verwendet wird.

AWS CLI

So rufen Sie die CPU-Auslastung pro EC2-Instance ab

Im folgenden Beispiel wird der get-metric-statistics-Befehl verwendet, um die CPU-Auslastung für eine EC2-Instance 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 werden 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 „Statistiken for eine Metrik abrufen“ im Amazon-CloudWatch-Entwicklerhandbuch.

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
  • Weitere API-Informationen finden Sie unter GetMetricStatistics in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-metric-stream verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Metrik-Stream ab

Im folgenden Beispiel für get-metric-stream werden Informationen zum Metrik-Stream QuickFull-GuaFbs im angegebenen Konto angezeigt.

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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter GetMetricStream in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie get-metric-widget-image verwendet wird.

AWS CLI

So rufen Sie ein Snapshot-Diagramm der CPU-Auslastung ab

Im folgenden Beispiel für get-metric-widget-image wird das Snapshot-Diagramm für die Metrik CPUUtilization der EC2-Instance mit der ID i-abcde abgerufen 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.

Die folgenden Codebeispiele zeigen, wie list-dashboards verwendet wird.

AWS CLI

So rufen Sie eine Liste von Dashboards ab

Im folgenden Beispiel für list-dashboards werden alle Dashboards im angegebenen Konto aufgelistet.

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 Amazon-CloudWatch-Dashboards im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter ListDashboards in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-metric-streams verwendet wird.

AWS CLI

So rufen Sie eine Liste von Metrik-Streams ab

Im folgenden Beispiel für list-metric-streams werden alle Metrik-Streams im angegebenen Konto aufgelistet.

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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter ListMetricStreams in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-metrics verwendet wird.

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" } ] }
  • Weitere API-Informationen finden Sie unter ListMetrics in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags auf, die einem vorhandenen Alarm zugeordnet sind*

Im folgenden Beispiel für list-tags-for-resource werden alle Tags aufgelistet, die dem Alarm demo im angegebenen Konto zugeordnet sind.

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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter ListTagsForResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-anomaly-detector verwendet wird.

AWS CLI

So erstellen Sie ein Anomalieerkennungsmodell

Im folgenden Beispiel für put-anomaly-detector wird ein Anomalieerkennungsmodell 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 zu Alarmen finden Sie unter Verwenden von Amazon-CloudWatch-Alarmen im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter PutAnomalyDetector in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-composite-alarm verwendet wird.

AWS CLI

So erstellen Sie einen zusammengesetzten CloudWatch-Alarm

Im folgenden Beispiel für put-composite-alarm wird ein zusammengesetzter Alarm mit dem Namen ProdAlarm im angegebenen Konto 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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter PutCompositeAlarm in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-dashboard verwendet wird.

AWS CLI

So erstellen Sie ein Dashboard

Im folgenden Beispiel für put-dashboard wird ein Dashboard mit dem Namen Dashboard-A im angegebenen Konto 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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter PutDashboard in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-insight-rule verwendet wird.

AWS CLI

So erstellen Sie eine Contributor-Insights-Regel

Im folgenden Beispiel für put-insight-rule wird eine Contributor-Insights-Regel mit dem Namen VPCFlowLogsContributorInsights im angegebenen Konto 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 in CloudWatch im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter PutInsightRule in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-metric-alarm verwendet wird.

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 zum Prompt 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
  • Weitere API-Informationen finden Sie unter PutMetricAlarm in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-metric-data verwendet wird.

AWS CLI

So veröffentlichen Sie eine benutzerdefinierte Metrik in Amazon CloudWatch

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

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 von benutzerdefinierten Metriken im Amazon-CloudWatch-Entwicklerhandbuch.

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
  • Weitere API-Informationen finden Sie unter PutMetricData in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie put-metric-stream verwendet wird.

AWS CLI

So erstellen Sie einen Metrik-Stream

Im folgenden Beispiel für put-metric-stream wird ein Metrik-Stream mit dem Namen QuickFull-GuaFb im angegebenen Konto 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 Einrichten eines Metrik-Streams im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter PutMetricStream in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie set-alarm-state verwendet wird.

AWS CLI

So ändern Sie den Status eines Alarms vorübergehend

Im folgenden Beispiel wird der set-alarm-state-Befehl verwendet, um den Status eines Amazon-CloudWatch-Alarms mit dem Namen „myalarm“ vorübergehend zu ändern und ihn für Testzwecke 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 zum Prompt zurück.

  • Weitere API-Informationen finden Sie unter SetAlarmState in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie start-metric-streams verwendet wird.

AWS CLI

So starten Sie einen angegebenen Metrik-Stream

Im folgenden Beispiel für start-metric-streams wird der Metrik-Stream mit dem Namen QuickFull-GuaFbs im angegebenen Konto gestartet.

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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter StartMetricStreams in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie stop-metric-streams verwendet wird.

AWS CLI

So beenden Sie einen angegebenen Metrik-Stream

Im folgenden Beispiel für stop-metric-streams wird der Metrik-Stream mit dem Namen QuickFull-GuaFbs im angegebenen Konto beendet.

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 Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter StopMetricStreams in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie der angegebenen Ressource einzelne oder mehrere Tags hinzu

Im folgenden Beispiel für tag-resource werden dem Cloudwatch-Alarm demo im angegebenen Konto zwei Tags hinzugefügt.

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 Markieren Ihrer Ressourcen von Amazon CloudWatch im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource

Im folgenden Beispiel für untag-resource werden zwei Tags aus dem Cloudwatch-Alarm demo im angegebenen Konto entfernt.

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 Markieren Ihrer Ressourcen von Amazon CloudWatch im Benutzerhandbuch für Amazon CloudWatch.

  • Weitere API-Informationen finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.