Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# CloudWatch Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren CloudWatch.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen 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.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `delete-alarms`
Das folgende Codebeispiel zeigt, wie Sie`delete-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-alarms.html)in der *AWS CLI Befehlsreferenz.*
### `delete-anomaly-detector`
Das folgende Codebeispiel zeigt die Verwendung`delete-anomaly-detector`.
**AWS CLI**
**So löschen Sie ein bestimmtes Anomalieerkennungsmodell**
Im folgenden Beispiel für `delete-anomaly-detector` wird ein Anomalieerkennungsmodell im angegebenen Konto gelöscht.
```
aws cloudwatch delete-anomaly-detector \
--namespace AWS/Logs \
--metric-name IncomingBytes \
--stat SampleCount
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Löschen eines Modells zur Erkennung von Anomalien](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-anomaly-detector.html)in der *AWS CLI Befehlsreferenz.*
### `delete-dashboards`
Das folgende Codebeispiel zeigt die Verwendung`delete-dashboards`.
**AWS CLI**
**So löschen Sie bestimmte Dashboards**
Im folgenden Beispiel für `delete-dashboards` werden zwei Dashboards mit den Namen `Dashboard-A` und `Dashboard-B` im angegebenen Konto gelöscht.
```
aws cloudwatch delete-dashboards \
--dashboard-names Dashboard-A Dashboard-B
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-dashboards.html)in der *AWS CLI Befehlsreferenz.*
### `delete-insight-rules`
Das folgende Codebeispiel zeigt die Verwendung`delete-insight-rules`.
**AWS CLI**
**So löschen Sie angegebene Contributor-Insights-Regeln**
Im folgenden Beispiel für `delete-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto gelöscht.
```
aws cloudwatch delete-insight-rules \
--rule-names Rule-A Rule-B
```
Ausgabe:
```
{
"Failures": []
}
```
*Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [DeleteInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-insight-rules.html).AWS CLI *
### `delete-metric-stream`
Das folgende Codebeispiel zeigt die Verwendung`delete-metric-stream`.
**AWS CLI**
**So löschen Sie einen angegebenen Metrik-Stream**
Im folgenden Beispiel für `delete-metric-stream` wird der Metrik-Stream mit dem Namen `QuickPartial-gSCKvO` im angegebenen Konto gelöscht.
```
aws cloudwatch delete-metric-stream \
--name QuickPartial-gSCKvO
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DeleteMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-metric-stream.html)in der *AWS CLI Befehlsreferenz*.
### `describe-alarm-history`
Das folgende Codebeispiel zeigt die Verwendung`describe-alarm-history`.
**AWS CLI**
**So rufen Sie den Verlauf eines Alarms ab**
Im folgenden Beispiel wird der `describe-alarm-history` Befehl verwendet, um den Verlauf für den CloudWatch Amazon-Alarm mit dem Namen „myalarm“ abzurufen:
```
aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate
```
Ausgabe:
```
{
"AlarmHistoryItems": [
{
"Timestamp": "2014-04-09T18:59:06.442Z",
"HistoryItemType": "StateUpdate",
"AlarmName": "myalarm",
"HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}",
"HistorySummary": "Alarm updated from ALARM to OK"
},
{
"Timestamp": "2014-04-09T18:59:05.805Z",
"HistoryItemType": "StateUpdate",
"AlarmName": "myalarm",
"HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}",
"HistorySummary": "Alarm updated from OK to ALARM"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeAlarmHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarm-history.html)in der *AWS CLI Befehlsreferenz.*
### `describe-alarms-for-metric`
Das folgende Codebeispiel zeigt die Verwendung`describe-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 Amazon CPUUtilization EC2-Metrik und der Instance mit der ID i-0c986c72 verknüpft sind. :
```
aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72
```
Ausgabe:
```
{
"MetricAlarms": [
{
"EvaluationPeriods": 10,
"AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2",
"StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z",
"AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z",
"ComparisonOperator": "GreaterThanOrEqualToThreshold",
"AlarmActions": [
"arn:aws:sns:us-east-1:111122223333:NotifyMe"
],
"Namespace": "AWS/EC2",
"AlarmDescription": "CPU usage exceeds 70 percent",
"StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}",
"Period": 300,
"StateValue": "OK",
"Threshold": 70.0,
"AlarmName": "myHighCpuAlarm2",
"Dimensions": [
{
"Name": "InstanceId",
"Value": "i-0c986c72"
}
],
"Statistic": "Average",
"StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].",
"InsufficientDataActions": [],
"OKActions": [],
"ActionsEnabled": true,
"MetricName": "CPUUtilization"
},
{
"EvaluationPeriods": 2,
"AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm",
"StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z",
"AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z",
"ComparisonOperator": "GreaterThanThreshold",
"AlarmActions": [
"arn:aws:sns:us-east-1:111122223333:HighCPUAlarm"
],
"Namespace": "AWS/EC2",
"AlarmDescription": "CPU usage exceeds 70 percent",
"StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}",
"Period": 300,
"StateValue": "OK",
"Threshold": 70.0,
"AlarmName": "myHighCpuAlarm",
"Dimensions": [
{
"Name": "InstanceId",
"Value": "i-0c986c72"
}
],
"Statistic": "Average",
"StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].",
"InsufficientDataActions": [],
"OKActions": [],
"ActionsEnabled": false,
"MetricName": "CPUUtilization"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeAlarmsForMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms-for-metric.html)in der *AWS CLI Befehlsreferenz*.
### `describe-alarms`
Das folgende Codebeispiel zeigt die Verwendung`describe-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms.html)in der *AWS CLI Befehlsreferenz*.
### `describe-anomaly-detectors`
Das folgende Codebeispiel zeigt die Verwendung`describe-anomaly-detectors`.
**AWS CLI**
**So rufen Sie eine Liste von Modellen zur Erkennung von Anomalien ab**
Im folgenden Beispiel für `describe-anomaly-detectors` werden Informationen zu Anomalieerkennungsmodellen angezeigt, die dem `AWS/Logs`-Namespace im angegebenen Konto zugeordnet sind.
```
aws cloudwatch describe-anomaly-detectors \
--namespace AWS/Logs
```
Ausgabe:
```
{
"AnomalyDetectors": [
{
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [],
"Stat": "SampleCount",
"Configuration": {
"ExcludedTimeRanges": []
},
"StateValue": "TRAINED",
"SingleMetricAnomalyDetector": {
"AccountId": "123456789012",
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [],
"Stat": "SampleCount"
}
},
{
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [
{
"Name": "LogGroupName",
"Value": "demo"
}
],
"Stat": "Average",
"Configuration": {
"ExcludedTimeRanges": []
},
"StateValue": "PENDING_TRAINING",
"SingleMetricAnomalyDetector": {
"AccountId": "123456789012",
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [
{
"Name": "LogGroupName",
"Value": "demo"
}
],
"Stat": "Average"
}
}
]
}
```
Weitere Informationen finden Sie unter [Verwenden der CloudWatch Anomalieerkennung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html)in der *AWS CLI Befehlsreferenz.*
### `describe-insight-rules`
Das folgende Codebeispiel zeigt die Verwendung`describe-insight-rules`.
**AWS CLI**
**So rufen Sie eine Liste von Contributor-Insights-Regeln ab**
Im folgenden Beispiel für `describe-insight-rules` werden alle Contributor-Insights-Regeln im angegebenen Konto angezeigt.
```
aws cloudwatch describe-insight-rules
```
Ausgabe:
```
{
"InsightRules": [
{
"Name": "Rule-A",
"State": "ENABLED",
"Schema": "CloudWatchLogRule/1",
"Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}",
"ManagedRule": false
},
{
"Name": "Rule-B",
"State": "ENABLED",
"Schema": "CloudWatchLogRule/1",
"Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}",
"ManagedRule": false
}
]
}
```
*Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [DescribeInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-insight-rules.html).AWS CLI *
### `disable-alarm-actions`
Das folgende Codebeispiel zeigt die Verwendung`disable-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 zum Prompt zurück.
+ Einzelheiten zur API finden Sie [DisableAlarmActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-alarm-actions.html)in der *AWS CLI Befehlsreferenz*.
### `disable-insight-rules`
Das folgende Codebeispiel zeigt die Verwendung`disable-insight-rules`.
**AWS CLI**
**So deaktivieren Sie bestimmte Contributor-Insight-Regeln**
Im folgenden Beispiel für `disable-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto deaktiviert.
```
aws cloudwatch disable-insight-rules \
--rule-names Rule-A Rule-B
```
Ausgabe:
```
{
"Failures": []
}
```
*Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [DisableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-insight-rules.html).AWS CLI *
### `enable-alarm-actions`
Das folgende Codebeispiel zeigt die Verwendung`enable-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-alarm-actions.html)in der *AWS CLI Befehlsreferenz*.
### `enable-insight-rules`
Das folgende Codebeispiel zeigt die Verwendung`enable-insight-rules`.
**AWS CLI**
**So aktivieren Sie bestimmte Contributor-Insight-Regeln**
Im folgenden Beispiel für `enable-insight-rules` werden zwei Contributor-Insights-Regeln mit dem Namen `Rule-A` und `Rule-B` im angegebenen Konto aktiviert.
```
aws cloudwatch enable-insight-rules \
--rule-names Rule-A Rule-B
```
Ausgabe:
```
{
"Failures": []
}
```
*Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [EnableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-insight-rules.html).AWS CLI *
### `get-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`get-dashboard`.
**AWS CLI**
**So rufen Sie Informationen zu einem Dashboard ab**
Im folgenden Beispiel für `get-dashboard` werden Informationen zum Dashboard `Dashboard-A` im angegebenen Konto angezeigt.
```
aws cloudwatch get-dashboard \
--dashboard-name Dashboard-A
```
Ausgabe:
```
{
"DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
"DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}",
"DashboardName": "Dashboard-A"
}
```
Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [GetDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-dashboard.html)in der *AWS CLI Befehlsreferenz.*
### `get-insight-rule-report`
Das folgende Codebeispiel zeigt die Verwendung`get-insight-rule-report`.
**AWS CLI**
**So rufen Sie die Zeitreihendaten ab, die durch eine Contributor-Insights-Regel erfasst wurden**
Im folgenden Beispiel für `get-insight-rule-report` werden die Zeitreihendaten zurückgegeben, die durch eine Contributor-Insights-Regel erfasst wurden.
```
aws cloudwatch get-insight-rule-report \
--rule-name Rule-A \
--start-time 2024-10-13T20:15:00Z \
--end-time 2024-10-13T20:30:00Z \
--period 300
```
Ausgabe:
```
{
"KeyLabels": [
"PartitionKey"
],
"AggregationStatistic": "Sum",
"AggregateValue": 0.5,
"ApproximateUniqueCount": 1,
"Contributors": [
{
"Keys": [
"RequestID"
],
"ApproximateAggregateValue": 0.5,
"Datapoints": [
{
"Timestamp": "2024-10-13T21:00:00+00:00",
"ApproximateValue": 0.5
}
]
}
],
"RuleAttributes": []
}
```
*Weitere Informationen finden Sie im Amazon-Benutzerhandbuch unter [Verwenden von Contributor Insights zur Analyse von Daten mit hoher Kardinalität](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html). CloudWatch *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [GetInsightRuleReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-insight-rule-report.html).AWS CLI *
### `get-metric-data`
Das folgende Codebeispiel zeigt die Verwendung`get-metric-data`.
**AWS CLI**
**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 InstanceID abgerufen, wobei ein metrischer mathematischer Ausdruck `i-abcdef` verwendet wird, der Metriken kombiniert. `EBSReadOps` `EBSWriteOps`
```
aws cloudwatch get-metric-data \
--metric-data-queries file://file.json \
--start-time 2024-09-29T22:10:00Z \
--end-time 2024-09-29T22:15:00Z
```
Inhalt von `file.json`:
```
[
{
"Id": "m3",
"Expression": "(m1+m2)/300",
"Label": "Avg Total IOPS"
},
{
"Id": "m1",
"MetricStat": {
"Metric": {
"Namespace": "AWS/EC2",
"MetricName": "EBSReadOps",
"Dimensions": [
{
"Name": "InstanceId",
"Value": "i-abcdef"
}
]
},
"Period": 300,
"Stat": "Sum",
"Unit": "Count"
},
"ReturnData": false
},
{
"Id": "m2",
"MetricStat": {
"Metric": {
"Namespace": "AWS/EC2",
"MetricName": "EBSWriteOps",
"Dimensions": [
{
"Name": "InstanceId",
"Value": "i-abcdef"
}
]
},
"Period": 300,
"Stat": "Sum",
"Unit": "Count"
},
"ReturnData": false
}
]
```
Ausgabe:
```
{
"MetricDataResults": [
{
"Id": "m3",
"Label": "Avg Total IOPS",
"Timestamps": [
"2024-09-29T22:10:00+00:00"
],
"Values": [
96.85
],
"StatusCode": "Complete"
}
],
"Messages": []
}
```
**Beispiel 2: Um die geschätzten Gebühren anhand von Abrechnungskennzahlen zu überwachen AWS CloudWatch **
Im folgenden `get-metric-data` Beispiel wird die `EstimatedCharges` CloudWatch Metrik aus dem Namespace AWS/Billing abgerufen.
```
aws cloudwatch get-metric-data \
--metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \
--start-time 2024-09-26T12:00:00Z \
--end-time 2024-09-26T18:00:00Z \
--region us-east-1
```
Ausgabe:
```
{
"MetricDataResults": [
{
"Id": "m1",
"Label": "EstimatedCharges",
"Timestamps": [
"2024-09-26T12:00:00+00:00"
],
"Values": [
542.38
],
"StatusCode": "Complete"
}
],
"Messages": []
}
```
Weitere Informationen finden Sie unter [Verwenden von mathematischen Ausdrücken mit CloudWatch Metriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [GetMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-data.html)in der *AWS CLI Befehlsreferenz*.
### `get-metric-statistics`
Das folgende Codebeispiel zeigt die Verwendung`get-metric-statistics`.
**AWS CLI**
**So rufen Sie die CPU-Auslastung pro EC2-Instance ab**
Im folgenden Beispiel wird der `get-metric-statistics`-Befehl verwendet, um die CPU-Auslastung für eine EC2-Instance mit der ID i-abcdef abzurufen.
```
aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef
```
Ausgabe:
```
{
"Datapoints": [
{
"Timestamp": "2014-04-09T11:18:00Z",
"Maximum": 44.79,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T20:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T19:18:00Z",
"Maximum": 50.85,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T09:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T03:18:00Z",
"Maximum": 76.84,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T21:18:00Z",
"Maximum": 48.96,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T14:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T08:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T16:18:00Z",
"Maximum": 45.55,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T06:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T13:18:00Z",
"Maximum": 45.08,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T05:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T18:18:00Z",
"Maximum": 46.88,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T17:18:00Z",
"Maximum": 52.08,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T07:18:00Z",
"Maximum": 47.92,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T02:18:00Z",
"Maximum": 51.23,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T12:18:00Z",
"Maximum": 47.67,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-08T23:18:00Z",
"Maximum": 46.88,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T10:18:00Z",
"Maximum": 51.91,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T04:18:00Z",
"Maximum": 47.13,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T15:18:00Z",
"Maximum": 48.96,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T00:18:00Z",
"Maximum": 48.16,
"Unit": "Percent"
},
{
"Timestamp": "2014-04-09T01:18:00Z",
"Maximum": 49.18,
"Unit": "Percent"
}
],
"Label": "CPUUtilization"
}
```
**Angeben mehrerer Dimensionen**
Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Value Paar angegeben, wobei zwischen dem Namen und dem Wert ein Komma steht. 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 Get Statistics for a Metric im *Amazon CloudWatch Developer Guide*.
```
aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60
```
+ Einzelheiten zur API finden Sie [GetMetricStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-statistics.html)unter *AWS CLI Befehlsreferenz*.
### `get-metric-stream`
Das folgende Codebeispiel zeigt die Verwendung`get-metric-stream`.
**AWS CLI**
**So rufen Sie Informationen zu einem Metrik-Stream ab**
Im folgenden Beispiel für `get-metric-stream` werden Informationen zum Metrik-Stream `QuickFull-GuaFbs` im angegebenen Konto angezeigt.
```
aws cloudwatch get-metric-stream \
--name QuickFull-GuaFbs
```
Ausgabe:
```
{
"Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
"Name": "QuickFull-GuaFbs",
"FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
"RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3",
"State": "running",
"CreationDate": "2024-10-11T18:48:59.187000+00:00",
"LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
"OutputFormat": "json",
"IncludeLinkedAccountsMetrics": false
}
```
Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [GetMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-stream.html)in der *AWS CLI Befehlsreferenz*.
### `get-metric-widget-image`
Das folgende Codebeispiel zeigt die Verwendung`get-metric-widget-image`.
**AWS CLI**
**Um ein Snapshot-Diagramm von abzurufen CPUUtilization**
Im folgenden Beispiel für `get-metric-widget-image` wird das Snapshot-Diagramm für die Metrik `CPUUtilization` der EC2-Instance mit der ID `i-abcde` abgerufen und das abgerufene Bild als Datei mit dem Namen „image.png“ auf Ihrem lokalen Computer gespeichert.
```
aws cloudwatch get-metric-widget-image \
--metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \
--output-format png \
--output text | base64 --decode > image.png
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [GetMetricWidgetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html)in der *AWS CLI Befehlsreferenz*.
### `list-dashboards`
Das folgende Codebeispiel zeigt die Verwendung`list-dashboards`.
**AWS CLI**
**So rufen Sie eine Liste von Dashboards ab**
Im folgenden Beispiel für `list-dashboards` werden alle Dashboards im angegebenen Konto aufgelistet.
```
aws cloudwatch list-dashboards
```
Ausgabe:
```
{
"DashboardEntries": [
{
"DashboardName": "Dashboard-A",
"DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
"LastModified": "2024-10-11T18:40:11+00:00",
"Size": 271
},
{
"DashboardName": "Dashboard-B",
"DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B",
"LastModified": "2024-10-11T18:44:41+00:00",
"Size": 522
}
]
}
```
Weitere Informationen finden Sie unter [ CloudWatch Amazon-Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-dashboards.html)in der *AWS CLI Befehlsreferenz.*
### `list-metric-streams`
Das folgende Codebeispiel zeigt die Verwendung`list-metric-streams`.
**AWS CLI**
**So rufen Sie eine Liste von Metrik-Streams ab**
Im folgenden Beispiel für `list-metric-streams` werden alle Metrik-Streams im angegebenen Konto aufgelistet.
```
aws cloudwatch list-metric-streams
```
Ausgabe:
```
{
"Entries": [
{
"Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
"CreationDate": "2024-10-11T18:48:59.187000+00:00",
"LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
"Name": "QuickFull-GuaFbs",
"FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
"State": "running",
"OutputFormat": "json"
}
]
}
```
Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metric-streams.html)in der *AWS CLI Befehlsreferenz*.
### `list-metrics`
Das folgende Codebeispiel zeigt die Verwendung`list-metrics`.
**AWS CLI**
**So listen Sie die Metriken für Amazon SNS auf**
Im folgenden Beispiel für `list-metrics` 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metrics.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie die Tags auf, die einem vorhandenen Alarm zugeordnet sind\$1**
Im folgenden Beispiel für `list-tags-for-resource` werden alle Tags aufgelistet, die dem Alarm `demo` im angegebenen Konto zugeordnet sind.
```
aws cloudwatch list-tags-for-resource \
--resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo
```
Ausgabe:
```
{
"Tags": [
{
"Key": "stack",
"Value": "Production"
},
{
"Key": "team",
"Value": "Devops"
}
]
}
```
Weitere Informationen finden Sie unter [Alarme und Tagging](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.*
### `put-anomaly-detector`
Das folgende Codebeispiel zeigt die Verwendung`put-anomaly-detector`.
**AWS CLI**
**So erstellen Sie ein Anomalieerkennungsmodell**
Im folgenden `put-anomaly-detector` Beispiel wird ein Modell zur Erkennung von Anomalien für eine CloudWatch Metrik erstellt.
```
aws cloudwatch put-anomaly-detector \
--namespace AWS/Logs \
--metric-name IncomingBytes \
--stat SampleCount
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verwenden der CloudWatch Anomalieerkennung](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-anomaly-detector.html)in der *AWS CLI Befehlsreferenz.*
### `put-composite-alarm`
Das folgende Codebeispiel zeigt die Verwendung`put-composite-alarm`.
**AWS CLI**
**So erstellen Sie einen zusammengesetzten CloudWatch-Alarm**
Im folgenden Beispiel für `put-composite-alarm` wird ein zusammengesetzter Alarm mit dem Namen `ProdAlarm` im angegebenen Konto erstellt.
```
aws cloudwatch put-composite-alarm \
--alarm-name ProdAlarm \
--alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \
--alarm-actions arn:aws:sns:us-east-1:123456789012:demo \
--actions-enabled
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Erstellen eines zusammengesetzten Alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutCompositeAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-composite-alarm.html)in der *AWS CLI Befehlsreferenz*.
### `put-dashboard`
Das folgende Codebeispiel zeigt die Verwendung`put-dashboard`.
**AWS CLI**
**So erstellen Sie ein Dashboard**
Im folgenden Beispiel für `put-dashboard` wird ein Dashboard mit dem Namen `Dashboard-A` im angegebenen Konto erstellt.
```
aws cloudwatch put-dashboard \
--dashboard-name Dashboard-A \
--dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'
```
Ausgabe:
```
{
"DashboardValidationMessages": []
}
```
Weitere Informationen finden Sie unter [Erstellen eines CloudWatch Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html)in der *AWS CLI Befehlsreferenz*.
### `put-insight-rule`
Das folgende Codebeispiel zeigt die Verwendung`put-insight-rule`.
**AWS CLI**
**So erstellen Sie eine Contributor-Insights-Regel**
Im folgenden Beispiel für `put-insight-rule` wird eine Contributor-Insights-Regel mit dem Namen `VPCFlowLogsContributorInsights` im angegebenen Konto erstellt.
```
aws cloudwatch put-insight-rule \
--rule-name VPCFlowLogsContributorInsights \
--rule-definition file://insight-rule.json \
--rule-state ENABLED
```
Inhalt von `insight-rule.json`:
```
{
"Schema": {
"Name": "CloudWatchLogRule",
"Version": 1
},
"AggregateOn": "Count",
"Contribution": {
"Filters": [],
"Keys": [
"tcp-flag"
]
},
"LogFormat": "CLF",
"LogGroupNames": [
"/vpc/flowlogs/*"
],
"Fields": {
"23": "tcp-flag"
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Erstellen einer Contributor Insights-Regel CloudWatch im CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html) *Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutInsightRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-insight-rule.html)in der *AWS CLI Befehlsreferenz.*
### `put-metric-alarm`
Das folgende Codebeispiel zeigt die Verwendung`put-metric-alarm`.
**AWS CLI**
**So senden Sie eine E-Mail-Nachricht von Amazon Simple Notification Service, wenn die CPU-Auslastung 70 % übersteigt**
Im folgenden Beispiel wird der `put-metric-alarm`-Befehl verwendet, um eine E-Mail-Nachricht von Amazon Simple Notification Service zu senden, wenn die CPU-Auslastung 70 % übersteigt:
```
aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent
```
Wenn dieser Befehl erfolgreich war, kehrt er zur Eingabeaufforderung zurück. Wenn ein Alarm mit demselben Namen bereits vorhanden ist, wird er durch den neuen Alarm überschrieben.
**So geben Sie mehrere Dimensionen an**
Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Value Paar angegeben, wobei zwischen dem Namen und dem Wert ein Komma steht. Mehrere Dimensionen werden durch ein Leerzeichen getrennt:
```
aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2
```
+ Einzelheiten zur API finden Sie unter [PutMetricAlarm AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html)*Befehlsreferenz.*
### `put-metric-data`
Das folgende Codebeispiel zeigt die Verwendung`put-metric-data`.
**AWS CLI**
**Um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch**
Im folgenden Beispiel wird der `put-metric-data` Befehl verwendet, um eine benutzerdefinierte Metrik auf Amazon zu veröffentlichen CloudWatch:
```
aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json
```
Die Werte für die Metrik selbst werden in der JSON-Datei `metric.json` gespeichert.
Hier ist der Inhalt dieser Datei:
```
[
{
"MetricName": "New Posts",
"Timestamp": "Wednesday, June 12, 2013 8:28:20 PM",
"Value": 0.50,
"Unit": "Count"
}
]
```
Weitere Informationen finden Sie unter Veröffentlichen benutzerdefinierter Metriken im *Amazon CloudWatch Developer Guide*.
**So geben Sie mehrere Dimensionen an**
Das folgende Beispiel zeigt, wie mehrere Dimensionen angegeben werden können. Jede Dimension wird als Name/Wert-Paar angegeben. Mehrere Dimensionen sind durch ein Komma getrennt:
```
aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceID=1-23456789,InstanceType=m1.small
```
+ Einzelheiten zur API finden Sie [PutMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html)in der *AWS CLI Befehlsreferenz*.
### `put-metric-stream`
Das folgende Codebeispiel zeigt die Verwendung`put-metric-stream`.
**AWS CLI**
**So erstellen Sie einen Metrik-Stream**
Im folgenden Beispiel für `put-metric-stream` wird ein Metrik-Stream mit dem Namen `QuickFull-GuaFb` im angegebenen Konto erstellt.
```
aws cloudwatch put-metric-stream \
--name QuickFull-GuaFbs \
--firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \
--role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \
--output-format json \
--no-include-linked-accounts-metrics
```
Ausgabe:
```
{
"Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
}
```
Weitere Informationen finden Sie unter [Metrik-Stream einrichten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [PutMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-stream.html)in der *AWS CLI Befehlsreferenz*.
### `set-alarm-state`
Das folgende Codebeispiel zeigt die Verwendung`set-alarm-state`.
**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 CloudWatch Amazon-Alarms mit dem Namen „myalarm“ vorübergehend zu ändern und ihn zu Testzwecken auf den ALARM-Status zu setzen:
```
aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes"
```
Wenn dieser Befehl erfolgreich war, kehrt er zum Prompt zurück.
+ Einzelheiten zur API finden Sie [SetAlarmState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/set-alarm-state.html)in der *AWS CLI Befehlsreferenz.*
### `start-metric-streams`
Das folgende Codebeispiel zeigt die Verwendung`start-metric-streams`.
**AWS CLI**
**So starten Sie einen angegebenen Metrik-Stream**
Im folgenden Beispiel für `start-metric-streams` wird der Metrik-Stream mit dem Namen `QuickFull-GuaFbs` im angegebenen Konto gestartet.
```
aws cloudwatch start-metric-streams \
--names QuickFull-GuaFbs
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StartMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/start-metric-streams.html)in der *AWS CLI Befehlsreferenz*.
### `stop-metric-streams`
Das folgende Codebeispiel zeigt die Verwendung`stop-metric-streams`.
**AWS CLI**
**So beenden Sie einen angegebenen Metrik-Stream**
Im folgenden Beispiel für `stop-metric-streams` wird der Metrik-Stream mit dem Namen `QuickFull-GuaFbs` im angegebenen Konto beendet.
```
aws cloudwatch stop-metric-streams \
--names QuickFull-GuaFbs
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verwenden von Metrik-Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StopMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/stop-metric-streams.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie der angegebenen Ressource einzelne oder mehrere Tags hinzu**
Im folgenden Beispiel für `tag-resource` werden dem Cloudwatch-Alarm `demo` im angegebenen Konto zwei Tags hinzugefügt.
```
aws cloudwatch tag-resource \
--resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
--tags Key=stack,Value=Production Key=team,Value=Devops
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/tag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource**
Im folgenden Beispiel für `untag-resource` werden zwei Tags aus dem Cloudwatch-Alarm `demo` im angegebenen Konto entfernt.
```
aws cloudwatch untag-resource \
--resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
--tag-keys stack team
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Taggen Ihrer CloudWatch Amazon-Ressourcen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/untag-resource.html)in der *AWS CLI Befehlsreferenz.*