CloudWatch †

• cloudwatch — AWS CLI Command Reference

CLIでグラフ画像を取得 †

get-metric-statistics — AWS CLI Command Reference では1回で1,440データポイントの制限がある。(1分のメトリクスを1日分取得可能)
グラフなら14日間や、複数メトリクスの同時表示できて、直感的に分かり安い。

• get-metric-widget-image — AWS CLI Command Reference
  • グラフ画像をpng形式のbase64で取得できる。

• GetMetricWidgetImage: Metric Widget Structure and Syntax - Amazon CloudWatch
  • APIの仕様。
  • 複数メトリクスを1つのグラフに表示する場合、JSONが大きくなるためShellScriptだけでは難しいことも。
  • 「expression」で計算ができる。生のCloudWatchのデータはSampleCountだけで、AWS Console上の各リソースのメトリクスと異なる場合がある。
  • 「yAxis」を省略した場合、グラフの目盛りを自動調整してくれる
  • 「color」を省略した場合、自動で異なる色にしてくれる。

• aws-cli/1.14.44 で確認した。
• 例：AWS Console上のDynamoDBのConsumedReadCapacityUnitsグラフは1分間のSum/60を表示している。自分でグラフを作る場合は、「RATE(m1)」を使う。
  • dynamodb_capacity.20181116.zip
  • 

• An error occurred (InternalFailure) when calling the GetMetricWidgetImage operation (reached max retries: 4): Unknown
  • startが過去すぎると出る。"-P5D" 等に短くする

DynamoDBの値の取得 †

• Amazon DynamoDB Metrics and Dimensions - Amazon DynamoDB

• 期間を長く、periodを短くすると、data pointの上限(1,440)を超えエラーになる。
• "Sum" の値/60が、秒間のReadCapacityUnits。これがAWS console上のキャパシティ。下の例では5 ReadCapacityUnits/sec

  AWS_PROFILE=example
  AWS_REGION=ap-northeast-1
  DYNAMODB_TABLE=TestTable
  START_TIME="5 min ago"
  END_TIME="5 min ago"
  STATISTICS="Sum"
  PERIOD=60
  aws cloudwatch get-metric-statistics \
  --dimensions Name=TableName,Value=$DYNAMODB_TABLE \
  --namespace AWS/DynamoDB \
  --metric-name ConsumedReadCapacityUnits \
  --statistics "${STATISTICS}" \
  --start-time $(date --iso-8601=seconds -d "${START_TIME}") \
  --end-time $(date --iso-8601=seconds -d "${END_TIME}") \
  --period $PERIOD \
  --profile $AWS_PROFILE \
  --region $AWS_REGION
  
  {
      "Datapoints": [
          {
              "Timestamp": "2018-11-01T08:32:00Z", 
              "Sum": 0.0, 
              "Unit": "Count"
          }, 
          {
              "Timestamp": "2018-11-01T08:31:00Z", 
              "Sum": 0.0, 
              "Unit": "Count"
          }, 
          {
              "Timestamp": "2018-11-01T08:34:00Z", 
              "Sum": 300.0, 
              "Unit": "Count"
          }, 
          {
              "Timestamp": "2018-11-01T08:30:00Z", 
              "Sum": 261.0, 
              "Unit": "Count"
          }, 
          {
              "Timestamp": "2018-11-01T08:33:00Z", 
              "Sum": 0.0, 
              "Unit": "Count"
          }
      ], 
      "Label": "ConsumedReadCapacityUnits"
  }

• jqを使って計算できる

  # 秒間の最大値
  jq '[.Datapoints[].Sum] | max/60' ./dynamo.read.json
  5
  
  # 合計(add), 件数(length)
  jq '[.Datapoints[].Sum] | add,length' ./dynamo.read.json
  561
  5
  
  # 平均
  jq '[.Datapoints[].Sum] | add/length' ./dynamo.read.json
  112.2

RDSのCloudWatchメトリクスを設定し、閾値を超えたらメールを送る †

• Amazon Simple Notification Service の設定
• put-metric-alarm

1. AWS SNSトピックを作成

   AWS_PROFILE=default
   AWS_REGION=ap-northeast-1
   RDS_ID=db01
   EMAIL=alerts@example.com
   
   aws --profile $AWS_PROFILE --region $AWS_REGION \
     sns create-topic --name "AlertToMyemail"
   {
       "TopicArn": "arn:aws:sns:ap-northeast-1:1234567890:AlertToMyemail"
   }
   
   TopicArn="arn:aws:sns:ap-northeast-1:1234567890:AlertToMyemail"
   
   aws --profile $AWS_PROFILE --region $AWS_REGION \
     sns subscribe --topic-arn $TopicArn \
     --protocol email \
     --notification-endpoint $EMAIL

2. 確認メールが届くので "Confirm subscription" をクリック
3. AWS SNS 設定確認

   aws --profile $AWS_PROFILE --region $AWS_REGION \
     sns list-subscriptions-by-topic --topic-arn $TopicArn

4. RDS:CPUUtilization >= 80% のメトリクスを作成

   aws --profile $AWS_PROFILE --region $AWS_REGION \
    cloudwatch put-metric-alarm \
    --alarm-name awsrds-${RDS_ID}-High-CPU-Utilization \
    --alarm-description "Alarm when CPU exceeds 80%" \
    --metric-name CPUUtilization \
    --namespace AWS/RDS \
    --statistic Average \
    --period 300 \
    --threshold 80 \
    --unit Percent \
    --comparison-operator GreaterThanOrEqualToThreshold \
    --dimensions  Name=DBInstanceIdentifier,Value=$RDS_ID  \
    --evaluation-periods 1 \
    --alarm-actions $TopicArn

5. RDS:FreeStorageSpace <= 5GB のメトリクスを作成(--threshold 5 --unit Gigabyte の設定は無効。Management Console上では0と表示される)

   aws --profile $AWS_PROFILE --region $AWS_REGION \
    cloudwatch put-metric-alarm \
    --alarm-name awsrds-${RDS_ID}-High-Free-Storage-Space \
    --alarm-description "Alarm when Free-Storage-Space less than 5GB" \
    --metric-name FreeStorageSpace \
    --namespace AWS/RDS \
    --statistic Average \
    --period 300 \
    --threshold 5242880000.0 \
    --comparison-operator LessThanOrEqualToThreshold \
    --dimensions  Name=DBInstanceIdentifier,Value=$RDS_ID  \
    --evaluation-periods 1 \
    --alarm-actions $TopicArn

6. 作成したメトリクスを確認

   aws --profile $AWS_PROFILE --region $AWS_REGION \
     cloudwatch describe-alarms --alarm-names awsrds-${RDS_ID}-High-CPU-Utilization awsrds-${RDS_ID}-High-Free-Storage-Space