Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs
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-namesmyalarmAusgabe:
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-detectorwird ein Anomalieerkennungsmodell im angegebenen Konto gelöscht.aws cloudwatch delete-anomaly-detector \ --namespaceAWS/Logs\ --metric-nameIncomingBytes\ --statSampleCountMit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter Löschen eines Anomalieerkennungsmodells im Benutzerhandbuch für Amazon CloudWatch.
-
Weitere API-Informationen finden Sie unter DeleteAnomalyDetector
in der AWS CLI-Befehlsreferenz.
-
Die folgenden Codebeispiele zeigen, wie delete-dashboards verwendet wird.
- AWS CLI
-
So löschen Sie bestimmte Dashboards
Im folgenden Beispiel für
delete-dashboardswerden zwei Dashboards mit den NamenDashboard-AundDashboard-Bim angegebenen Konto gelöscht.aws cloudwatch delete-dashboards \ --dashboard-namesDashboard-ADashboard-BMit 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-ruleswerden zwei Contributor-Insights-Regeln mit dem NamenRule-AundRule-Bim angegebenen Konto gelöscht.aws cloudwatch delete-insight-rules \ --rule-namesRule-ARule-BAusgabe:
{ "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-streamwird der Metrik-Stream mit dem NamenQuickPartial-gSCKvOim angegebenen Konto gelöscht.aws cloudwatch delete-metric-stream \ --nameQuickPartial-gSCKvOMit 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-typeStateUpdateAusgabe:
{ "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" } ] }-
Weitere API-Informationen finden Sie unter DescribeAlarmHistory
in der AWS CLI-Befehlsreferenz.
-
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-nameCPUUtilization--namespaceAWS/EC2--dimensionsName=InstanceId,Value=i-0c986c72Ausgabe:
{ "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" } ] }-
Weitere API-Informationen finden Sie unter DescribeAlarmsForMetric
in der AWS CLI-Befehlsreferenz.
-
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-detectorswerden Informationen zu Anomalieerkennungsmodellen angezeigt, die demAWS/Logs-Namespace im angegebenen Konto zugeordnet sind.aws cloudwatch describe-anomaly-detectors \ --namespaceAWS/LogsAusgabe:
{ "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.
-
Weitere API-Informationen finden Sie unter DescribeAnomalyDetectors
in der AWS CLI-Befehlsreferenz.
-
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-ruleswerden alle Contributor-Insights-Regeln im angegebenen Konto angezeigt.aws cloudwatch describe-insight-rulesAusgabe:
{ "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.
-
Weitere API-Informationen finden Sie unter DescribeInsightRules
in der AWS CLI-Befehlsreferenz.
-
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-namesmyalarmWenn 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-ruleswerden zwei Contributor-Insights-Regeln mit dem NamenRule-AundRule-Bim angegebenen Konto deaktiviert.aws cloudwatch disable-insight-rules \ --rule-namesRule-ARule-BAusgabe:
{ "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-namesmyalarmWenn 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-ruleswerden zwei Contributor-Insights-Regeln mit dem NamenRule-AundRule-Bim angegebenen Konto aktiviert.aws cloudwatch enable-insight-rules \ --rule-namesRule-ARule-BAusgabe:
{ "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-dashboardwerden Informationen zum DashboardDashboard-Aim angegebenen Konto angezeigt.aws cloudwatch get-dashboard \ --dashboard-nameDashboard-AAusgabe:
{ "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-reportwerden die Zeitreihendaten zurückgegeben, die durch eine Contributor-Insights-Regel erfasst wurden.aws cloudwatch get-insight-rule-report \ --rule-nameRule-A\ --start-time2024-10-13T20:15:00Z\ --end-time2024-10-13T20:30:00Z\ --period300Ausgabe:
{ "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.
-
Weitere API-Informationen finden Sie unter GetInsightRuleReport
in der AWS CLI-Befehlsreferenz.
-
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-datawerden CloudWatch-Metrikwerte für die EC2-Instance mit der InstanceIDi-abcdefmithilfe eines metrischen mathematischen Ausdrucks abgerufen, der die MetrikenEBSReadOpsundEBSWriteOpskombiniert.aws cloudwatch get-metric-data \ --metric-data-queriesfile://file.json\ --start-time2024-09-29T22:10:00Z\ --end-time2024-09-29T22:15:00ZInhalt 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-datawird die CloudWatch-MetrikEstimatedChargesaus 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-time2024-09-26T12:00:00Z\ --end-time2024-09-26T18:00:00Z\ --regionus-east-1Ausgabe:
{ "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-nameCPUUtilization--start-time2014-04-08T23:18:00Z--end-time2014-04-09T23:18:00Z--period3600--namespaceAWS/EC2--statisticsMaximum--dimensionsName=InstanceId,Value=i-abcdefAusgabe:
{ "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-nameBuffers--namespaceMyNameSpace--dimensionsName=InstanceID,Value=i-abcdefName=InstanceType,Value=m1.small--start-time2016-10-15T04:00:00Z--end-time2016-10-19T07:00:00Z--statisticsAverage--period60-
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-streamwerden Informationen zum Metrik-StreamQuickFull-GuaFbsim angegebenen Konto angezeigt.aws cloudwatch get-metric-stream \ --nameQuickFull-GuaFbsAusgabe:
{ "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-imagewird das Snapshot-Diagramm für die MetrikCPUUtilizationder EC2-Instance mit der IDi-abcdeabgerufen 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-formatpng\ --outputtext|base64--decode>image.pngMit diesem Befehl wird keine Ausgabe zurückgegeben.
-
Weitere API-Informationen finden Sie unter GetMetricWidgetImage
in der AWS CLI-Befehlsreferenz.
-
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-dashboardswerden alle Dashboards im angegebenen Konto aufgelistet.aws cloudwatch list-dashboardsAusgabe:
{ "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-streamswerden alle Metrik-Streams im angegebenen Konto aufgelistet.aws cloudwatch list-metric-streamsAusgabe:
{ "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-resourcewerden alle Tags aufgelistet, die dem Alarmdemoim angegebenen Konto zugeordnet sind.aws cloudwatch list-tags-for-resource \ --resource-arnarn:aws:cloudwatch:us-east-1:123456789012:alarm:demoAusgabe:
{ "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-detectorwird ein Anomalieerkennungsmodell für eine CloudWatch-Metrik erstellt.aws cloudwatch put-anomaly-detector \ --namespaceAWS/Logs\ --metric-nameIncomingBytes\ --statSampleCountMit 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-alarmwird ein zusammengesetzter Alarm mit dem NamenProdAlarmim angegebenen Konto erstellt.aws cloudwatch put-composite-alarm \ --alarm-nameProdAlarm\ --alarm-rule"ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)"\ --alarm-actionsarn:aws:sns:us-east-1:123456789012:demo\ --actions-enabledMit 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-dashboardwird ein Dashboard mit dem NamenDashboard-Aim angegebenen Konto erstellt.aws cloudwatch put-dashboard \ --dashboard-nameDashboard-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-rulewird eine Contributor-Insights-Regel mit dem NamenVPCFlowLogsContributorInsightsim angegebenen Konto erstellt.aws cloudwatch put-insight-rule \ --rule-nameVPCFlowLogsContributorInsights\ --rule-definitionfile://insight-rule.json\ --rule-stateENABLEDInhalt 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-namecpu-mon--alarm-description"Alarm when CPU exceeds 70 percent"--metric-nameCPUUtilization--namespaceAWS/EC2--statisticAverage--period300--threshold70--comparison-operatorGreaterThanThreshold--dimensions"Name=InstanceId,Value=i-12345678"--evaluation-periods2--alarm-actionsarn:aws:sns:us-east-1:111122223333:MyTopic--unitPercentWenn 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-nameDefault_Test--statisticAverage--period60--evaluation-periods3--threshold50--comparison-operatorGreaterThanOrEqualToThreshold--dimensionsName=key1,Value=value1Name=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-datafile://metric.jsonDie Werte für die Metrik selbst werden in der JSON-Datei
metric.jsongespeichert.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-nameBuffers--namespaceMyNameSpace--unitBytes--value231434333--dimensionsInstanceID=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-streamwird ein Metrik-Stream mit dem NamenQuickFull-GuaFbim angegebenen Konto erstellt.aws cloudwatch put-metric-stream \ --nameQuickFull-GuaFbs\ --firehose-arnarn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG\ --role-arnarn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3\ --output-formatjson\ --no-include-linked-accounts-metricsAusgabe:
{ "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-valueALARM--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-streamswird der Metrik-Stream mit dem NamenQuickFull-GuaFbsim angegebenen Konto gestartet.aws cloudwatch start-metric-streams \ --namesQuickFull-GuaFbsMit 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-streamswird der Metrik-Stream mit dem NamenQuickFull-GuaFbsim angegebenen Konto beendet.aws cloudwatch stop-metric-streams \ --namesQuickFull-GuaFbsMit 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-resourcewerden dem Cloudwatch-Alarmdemoim angegebenen Konto zwei Tags hinzugefügt.aws cloudwatch tag-resource \ --resource-arnarn:aws:cloudwatch:us-east-1:123456789012:alarm:demo\ --tagsKey=stack,Value=ProductionKey=team,Value=DevopsMit 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-resourcewerden zwei Tags aus dem Cloudwatch-Alarmdemoim angegebenen Konto entfernt.aws cloudwatch untag-resource \ --resource-arnarn:aws:cloudwatch:us-east-1:123456789012:alarm:demo\ --tag-keysstackteamMit 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.
-