CloudWatch-Beispiele unter Verwendung der 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.

So löschen Sie ein angegebenes 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 zu Alarmen finden Sie unter Löschen eines Anomalieerkennungsmodells im Benutzerhandbuch zu Amazon CloudWatch.

So löschen Sie bestimmte Dashboards

Im folgenden Beispiel für delete-dashboards Beispiel 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 zu Amazon CloudWatch.

So löschen Sie angegebene Contributor-Insights-Regeln

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

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

Ausgabe:

{
    "Failures": []
}

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

So löschen Sie einen angegebenen Metrik-Stream

Im folgenden delete-metric-stream-Beispiel 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 erhalten Sie unter Metrik-Streams verwenden im Benutzerhandbuch zu Amazon CloudWatch.

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"
        }
    ]
}

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"
        }
    ]
}

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"
        }
    ]
}

So rufen Sie eine Liste von Anomalieerkennungsmodellen ab

Im folgenden describe-anomaly-detectors-Beispiel 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"
            }
        }
    ]
}

Ausführlichere Informationen finden Sie unter Verwenden der CloudWatch-Anomalieerkennung im Benutzerhandbuch zu Amazon CloudWatch.

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

Im folgenden describe-insight-rules-Beispiel 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 zu Amazon CloudWatch.

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.

So deaktivieren Sie bestimmte Contributor-Insight-Regeln

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

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

Ausgabe:

{
    "Failures": []
}

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

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.

So aktivieren Sie bestimmte Contributor-Insight-Regeln

Im folgenden enable-insight-rules-Beispiel 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 zu Amazon CloudWatch.

So rufen Sie Informationen zu einem Dashboard ab

Im folgenden get-dashboard-Beispiel 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 zu Amazon CloudWatch.

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

Das folgende get-insight-rule-report-Beispiel gibt die Zeitreihendaten zurück, 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 zu Amazon CloudWatch.

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

Im folgenden get-metric-data-Beispiel 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 zur Verwendung finden Sie unter Verwenden mathematischer Ausdrücke mit CloudWatch-Metriken im Benutzerhandbuch zu Amazon CloudWatch.

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 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 „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

So rufen Sie Informationen zu einem Metrik-Stream ab

Im folgenden get-metric-stream-Beispiel 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 erhalten Sie unter Verwenden von Metrik-Streams verwenden im Benutzerhandbuch zu Amazon CloudWatch.

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

Im folgenden get-metric-widget-image-Beispiel 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.

So rufen Sie eine Liste von Dashboards ab

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 Amazon-CloudWatch-Dashboards im Benutzerhandbuch zu Amazon CloudWatch.

So rufen Sie eine Liste von Metrik-Streams ab

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 erhalten Sie unter Verwenden von Metrik-Streams im Benutzerhandbuch zu Amazon CloudWatch.

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"
        }
    ]
}

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

Das folgende list-tags-for-resource-Beispiel listet alle Tags auf, 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 zu Amazon CloudWatch.

So erstellen Sie ein Anomalieerkennungsmodell

Im folgenden put-anomaly-detector-Beispiel 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.

Ausführlichere Informationen finden Sie unter Verwenden der CloudWatch-Anomalieerkennung im Benutzerhandbuch zu Amazon CloudWatch.

So erstellen Sie einen zusammengesetzten CloudWatch-Alarm

Im folgenden put-composite-alarm-Beispiel 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 zu Amazon CloudWatch.

So erstellen Sie ein -Dashboard

Im folgenden put-dashboard-Beispiel 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-Alarms im Benutzerhandbuch zu Amazon CloudWatch.

So erstellen Sie eine Contributor-Insights-Regel

Im folgenden put-insight-rule-Beispiel 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 von Contributor Insights in CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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

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

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

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

So geben Sie mehrere Dimensionen an

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

aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2

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

So erstellen Sie einen Metrik-Stream

Im folgenden put-metric-stream-Beispiel 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 erhalten Sie unter Einrichten eines Metrik-Streams im Benutzerhandbuch zu Amazon CloudWatch.

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

So starten Sie einen angegebenen Metrik-Stream

Im folgenden start-metric-streams-Beispiel 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 erhalten Sie unter Verwenden von Metrik-Streams im Benutzerhandbuch zu Amazon CloudWatch.

So beenden Sie einen angegebenen Metrik-Stream

Im folgenden stop-metric-streams-Beispiel 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 erhalten Sie unter Verwenden von Metrik-Streams verwenden im Benutzerhandbuch zu Amazon CloudWatch.

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

Im folgenden tag-resource-Beispiel 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 von Ressourcen von Amazon CloudWatch Events im Benutzerhandbuch zu Amazon CloudWatch.

So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource

Im folgenden untag-resource-Beispiel 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 von Ressourcen von Amazon CloudWatch Events im Benutzerhandbuch zu Amazon CloudWatch.