網頁

2024/3/5

AWS CLI 取得CloudWatch metrics統計資料

使用AWS CLI取得CloudWatch metrics統計資料。


範例環境:

  • AWS CLI version 2 (aws-cli/2.9.19)



事前要求

參考「AWS EC2 建立instance」建立一個instance。


取得metric統計資料

在命令列輸入AWS CLI命令aws cloudwatch get-metric-statistics即可取得metrics資料,。

例如輸入aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2024-03-05T14:00:00Z --end-time 2024-03-05T15:00:00Z --period 600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-015766eb6a31d3413

  • metric-name - 指標名稱,例如CPUUtilization
  • start-time - 統計起始時間,ISO 8601 UTC格式。
  • end-time - 統計結束時間,ISO 8601 UTC格式。
  • period - 統計時間刻度,單位為秒,例如600即為600秒,也就是每10分鐘統計一次。
  • namespace - Metrics分類名稱,項下有多種指標。參考namcespace列表
  • statistics - 統計指標,例如AverageMinimum
  • dimensions - 用來識別指標對象的名值對參數,Name為維度名稱,Value為值。參考EC2的metric dimensions,例如這邊要查循的維度為InstanceId,值為instance的id。
% aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2024-03-05T14:00:00Z --end-time 2024-03-05T15:00:00Z --period 600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-015766eb6a31d3413
{
    "Label": "CPUUtilization",
    "Datapoints": [
        {
            "Timestamp": "2024-03-05T14:30:00+00:00",
            "Maximum": 0.344827586206901,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2024-03-05T14:20:00+00:00",
            "Maximum": 0.338983050847462,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2024-03-05T14:50:00+00:00",
            "Maximum": 0.338983050847462,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2024-03-05T14:10:00+00:00",
            "Maximum": 0.333333333333338,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2024-03-05T14:00:00+00:00",
            "Maximum": 0.333333333333338,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2024-03-05T14:40:00+00:00",
            "Maximum": 0.333333333333338,
            "Unit": "Percent"
        }
    ]
}

注意,能取得Datapoints資料筆數的上限是1,440個。

沒有留言:

張貼留言