Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples
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 DeleteAlarms
in 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-nameIncomingBytes
\ --statSampleCount
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.
-
Einzelheiten zur API finden Sie unter DeleteAnomalyDetector 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 NamenDashboard-A
undDashboard-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 DeleteDashboards
in 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 NamenRule-A
undRule-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
-
Einzelheiten zur API finden Sie in der Befehlsreferenz DeleteInsightRules
.AWS CLI
-
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 derQuickPartial-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.
-
Einzelheiten zur API finden Sie DeleteMetricStream
in der AWS CLI Befehlsreferenz.
-
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-typeStateUpdate
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" } ] }
-
Einzelheiten zur API finden Sie DescribeAlarmHistory
in der AWS CLI Befehlsreferenz.
-
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
--namespaceAWS/EC2
--dimensionsName=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" } ] }
-
Einzelheiten zur API finden Sie DescribeAlarmsForMetric
in 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 DescribeAlarms
in 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 demAWS/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.
-
Einzelheiten zur API finden Sie DescribeAnomalyDetectors
in der AWS CLI Befehlsreferenz.
-
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
-
Einzelheiten zur API finden Sie in der Befehlsreferenz DescribeInsightRules
.AWS CLI
-
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.
-
Einzelheiten zur API finden Sie DisableAlarmActions
in der AWS CLI Befehlsreferenz.
-
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 NamenRule-A
undRule-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
-
Einzelheiten zur API finden Sie in der Befehlsreferenz DisableInsightRules
.AWS CLI
-
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.
-
Einzelheiten zur API finden Sie EnableAlarmActions
in der AWS CLI Befehlsreferenz.
-
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 NamenRule-A
undRule-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
-
Einzelheiten zur API finden Sie in der Befehlsreferenz EnableInsightRules
.AWS CLI
-
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, dasDashboard-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 GetDashboard
in 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-time2024-10-13T20:15:00Z
\ --end-time2024-10-13T20:30:00Z
\ --period300
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
-
Einzelheiten zur API finden Sie in der Befehlsreferenz GetInsightRuleReport
.AWS CLI
-
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 InstanceIDi-abcdef
mithilfe eines metrischen mathematischen Ausdrucks abgerufen, der Metriken kombiniert.EBSReadOps
EBSWriteOps
aws cloudwatch get-metric-data \ --metric-data-queries
file://file.json
\ --start-time2024-09-29T22:10:00Z
\ --end-time2024-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 dieEstimatedCharges
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-time2024-09-26T12:00:00Z
\ --end-time2024-09-26T18:00:00Z
\ --regionus-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 GetMetricData
in 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-time2014-04-08T23:18:00Z
--end-time2014-04-09T23:18:00Z
--period3600
--namespaceAWS/EC2
--statisticsMaximum
--dimensionsName=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
--namespaceMyNameSpace
--dimensionsName=InstanceID,Value=i-abcdef
Name=InstanceType,Value=m1.small
--start-time2016-10-15T04:00:00Z
--end-time2016-10-19T07:00:00Z
--statisticsAverage
--period60
-
Einzelheiten zur API finden Sie GetMetricStatistics
unter 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, derQuickFull-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 GetMetricStream
in 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 MetrikCPUUtilization
der EC2 Instanz mit der ID abgerufeni-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-formatpng
\ --outputtext
|
base64
--decode>
image.png
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
-
Einzelheiten zur API finden Sie unter GetMetricWidgetImage 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 ListDashboards
in 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.
-
Einzelheiten zur API finden Sie ListMetricStreams
in 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 ListMetrics
in 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, derdemo
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.
-
Einzelheiten zur API finden Sie ListTagsForResource
in der AWS CLI Befehlsreferenz.
-
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-nameIncomingBytes
\ --statSampleCount
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie PutAnomalyDetector
in der AWS CLI Befehlsreferenz.
-
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 NamenProdAlarm
des angegebenen Kontos erstellt.aws cloudwatch put-composite-alarm \ --alarm-name
ProdAlarm
\ --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 CloudWatch Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie PutCompositeAlarm
in 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 mitDashboard-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 PutDashboard
in 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 NamenVPCFlowLogsContributorInsights
des angegebenen Kontos erstellt.aws cloudwatch put-insight-rule \ --rule-name
VPCFlowLogsContributorInsights
\ --rule-definitionfile://insight-rule.json
\ --rule-stateENABLED
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.
-
Einzelheiten zur API finden Sie unter PutInsightRule 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-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
--unitPercent
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-nameDefault_Test
--statisticAverage
--period60
--evaluation-periods3
--threshold50
--comparison-operatorGreaterThanOrEqualToThreshold
--dimensionsName=key1,Value=value1
Name=key2,Value=value2
-
Einzelheiten zur API finden Sie PutMetricAlarm
in 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-datafile://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
--namespaceMyNameSpace
--unitBytes
--value231434333
--dimensionsInstanceID=1-23456789,InstanceType=m1.small
-
Einzelheiten zur API finden Sie PutMetricData
in 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 mitQuickFull-GuaFb
dem Namen des angegebenen Kontos erstellt.aws cloudwatch put-metric-stream \ --name
QuickFull-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 Metrik-Stream einrichten im CloudWatch Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie PutMetricStream
in 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-valueALARM
--state-reason"testing purposes"
Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück.
-
Einzelheiten zur API finden Sie SetAlarmState
in 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, derQuickFull-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.
-
Einzelheiten zur API finden Sie StartMetricStreams
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungstop-metric-streams
.
- AWS CLI
-
Um einen bestimmten Metrik-Stream zu stoppen
Im folgenden
stop-metric-streams
Beispiel wird derQuickFull-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.
-
Einzelheiten zur API finden Sie StopMetricStreams
in 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, derdemo
im angegebenen Konto benannt ist, zwei Tags hinzu.aws cloudwatch tag-resource \ --resource-arn
arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo
\ --tagsKey=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 TagResource
in 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, derdemo
im angegebenen Konto benannt ist.aws cloudwatch untag-resource \ --resource-arn
arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo
\ --tag-keysstack
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 UntagResource
in der AWS CLI Befehlsreferenz.
-