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.

# Metrische Daten abrufen (GetMetricData)
<a name="metrics-classic-getdata"></a>

`GetMetricData`ist die primäre API zum programmgesteuerten Abrufen von klassischen metrischen Datenpunkten. Sie unterstützt Batch-Abfragen, mathematische Ausdrücke und Abfragen in einem einzigen Aufruf.

## Grundlegende Verwendung
<a name="metrics-classic-getdata-basic"></a>

Rufen Sie eine einzelne Metrik ab:

```
aws cloudwatch get-metric-data \
  --metric-data-queries '[
    {
      "Id": "cpu",
      "MetricStat": {
        "Metric": {
          "Namespace": "AWS/EC2",
          "MetricName": "CPUUtilization",
          "Dimensions": [{"Name": "InstanceId", "Value": "{{i-1234567890abcdef0}}"}]
        },
        "Period": 300,
        "Stat": "Average"
      }
    }
  ]' \
  --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \
  --end-time $(date -u +%Y-%m-%dT%H:%M:%S) \
  --output json
```

## Batch-Abfragen
<a name="metrics-classic-getdata-batch"></a>

Rufen Sie mehrere Metriken in einem einzigen Anruf ab (bis zu 500 Abfragen):

```
aws cloudwatch get-metric-data \
  --metric-data-queries '[
    {"Id": "cpu", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Average"}},
    {"Id": "mem", "MetricStat": {"Metric": {"Namespace": "CWAgent", "MetricName": "mem_used_percent", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Average"}}
  ]' \
  --start-time 2024-01-01T00:00:00 \
  --end-time 2024-01-01T01:00:00
```

## Mathematische Ausdrücke
<a name="metrics-classic-getdata-math"></a>

Kombinieren Sie Metriken mithilfe von Arithmetik:

```
[
  {"Id": "rx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkIn", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Sum"}},
  {"Id": "tx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkOut", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Sum"}},
  {"Id": "total", "Expression": "rx + tx", "Label": "TotalNetwork"}
]
```

## GetMetricData vs GetMetricStatistics
<a name="metrics-classic-getdata-comparison"></a>


|  | **GetMetricData** | **GetMetricStatistics** | 
| --- | --- | --- | 
| Batch-Unterstützung | Bis zu 500 Anfragen pro Anruf | Eine einzige Metrik pro Anruf | 
| Mathematische Ausdrücke | Ja | Nein | 
|  queries | Ja | Nein | 
| Paginierung | Ja (NextToken) | Nein | 
| Empfohlen | Ja — primäre API | Legacy — GetMetricData stattdessen verwenden | 

## Preisgestaltung
<a name="metrics-classic-getdata-pricing"></a>

0,01$ pro 1.000 Metriken, die über angefordert wurden`GetMetricData`.

**Anmerkung**  
Verwenden Sie für OTel-Metriken die Prometheus-compatible Abfrage-API oder CloudWatch Query Studio mit PromQL. `GetMetricData`fragt keine Otel-Metriken ab.