View a markdown version of this page

Recupera dati metrici () GetMetricData - Amazon CloudWatch

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Recupera dati metrici () GetMetricData

GetMetricDataè l'API principale per il recupero programmatico dei punti dati metrici Classic. Supporta query in batch, espressioni matematiche e query in un'unica chiamata.

Utilizzo di base

Recupera una singola metrica:

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

Interrogazioni in batch

Recupera più metriche in una singola chiamata (fino a 500 query):

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

Espressioni matematiche

Combina le metriche usando l'aritmetica:

[ {"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 contro GetMetricStatistics

GetMetricData

GetMetricStatistics

Supporto Batch

Fino a 500 domande per chiamata

Una sola metrica per chiamata

Espressioni matematiche

No

queries

No

Paginazione

Sì (NextToken)

No

Consigliato

Sì, API principale

Legacy: usa GetMetricData invece

Prezzi

0,01 USD per 1.000 metriche richieste tramite. GetMetricData

Nota

Per le metriche di Otel, usa l'API di Prometheus-compatible CloudWatch query o Query Studio con PromQL. GetMetricDatanon interroga le metriche di Otel.