1.1. CloudWatchメトリクス一覧の取得 (SQS キュー)

手順の目的

SQSキュー"handson-cli-cloudwatch-1st-queue"のCloudWatchメトリクス一覧を取得します。

設定値の指定

設定値の指定

手順に必要な設定値を変数に格納をします。

0. リージョン

リージョンを指定します。

環境変数の設定:

export AWS_DEFAULT_REGION='ap-northeast-1'

1. CloudWatch名前空間

CloudWatch名前空間を指定します。

変数の設定:

CLOUDWATCH_NAMESPACE="AWS/SQS"

2. CloudWatchディメンション

CloudWatchディメンション名を指定します。

変数の設定:

CLOUDWATCH_DIMENSION_NAME="QueueName"

SQSキュー名を指定します。

変数の設定:

SQS_QUEUE_NAME="handson-cli-cloudwatch-1st-queue"

ディメンション文字列を生成します。

変数の設定:

STRING_CLOUDWATCH_DIMENSIONS="Name=${CLOUDWATCH_DIMENSION_NAME},Value=${SQS_QUEUE_NAME}" \
  && echo ${STRING_CLOUDWATCH_DIMENSIONS}

結果(例):

Name=QueueName,Value=handson-cli-cloudwatch-1st-queue

設定値の確認

各変数に正しい設定値が格納されていることを確認します。

変数の確認:

cat << END

  # 0.  AWS_DEFAULT_REGION:"ap-northeast-1"
        AWS_DEFAULT_REGION="${AWS_DEFAULT_REGION}"

  # 1.  CLOUDWATCH_NAMESPACE:"AWS/SQS"
        CLOUDWATCH_NAMESPACE="${CLOUDWATCH_NAMESPACE}"
  # 2.  STRING_CLOUDWATCH_DIMENSIONS:"Name=QueueName,Value=handson-cli-cloudwatch-1st-queue"
        STRING_CLOUDWATCH_DIMENSIONS="${STRING_CLOUDWATCH_DIMENSIONS}"

END

下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。

処理の実行

CloudWatchメトリクス一覧の取得

CloudWatchメトリクス一覧を取得します。

コマンド:

aws cloudwatch list-metrics \
  --namespace ${CLOUDWATCH_NAMESPACE} \
  --dimensions ${STRING_CLOUDWATCH_DIMENSIONS} \
  --query 'Metrics[].MetricName' \
  --output text \
| sed "s/\t/\n/g"

結果(例):

ApproximateNumberOfMessagesDelayed
NumberOfMessagesDeleted
NumberOfMessagesSent
NumberOfMessagesReceived
NumberOfEmptyReceives
ApproximateAgeOfOldestMessage
ApproximateNumberOfMessagesVisible
ApproximateNumberOfMessagesNotVisible

注釈

SQSキューを作成してからメトリクスが表示されるまで10分程度かかる場合があります。

完了確認

「SQSキューのCloudWatchメトリクス一覧を取得できている。」ことを確認します。

注釈

「処理の実行」が正常に完了していればOKです。

手順の完了