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 |
Sì |
No |
queries |
Sì |
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.