ハンズオン(簡易版): CloudWatch Logs入門

3.4. CloudWatch Logsログイベントの取得 (ログフィルター: handson-cli-logs-novice-group)

手順の目的 [why]

CloudWatch Logsロググループ"handson-cli-logs-novice-group"からログフィルターを利用してログイベントを取得します。

設定値の指定

設定値の指定

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

0. リージョンの指定

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

環境変数の設定:

export AWS_DEFAULT_REGION='ap-northeast-1'

1. CloudWatch Logsロググループ名

CloudWatch Logsロググループ名を指定します。

変数の設定:

LOGS_GROUP_NAME='handson-cli-logs-novice-group'

2. ログイベント数

取得するログイベント数を指定します。

変数の設定:

LOGS_EVENT_MAX_ITEMS='2'

設定値の確認

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

変数の確認:

cat << END

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

  # 1. LOGS_GROUP_NAME:"handson-cli-logs-novice-group"
       LOGS_GROUP_NAME="${LOGS_GROUP_NAME}"
  # 2. LOGS_EVENT_MAX_ITEMS:"2"
       LOGS_EVENT_MAX_ITEMS="${LOGS_EVENT_MAX_ITEMS}"

END

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

処理の実行

ログフィルターを利用してCloudWatch Logsログイベントを取得します。

変数の確認:

cat << END

  # LOGS_GROUP_NAME:"handson-cli-logs-novice-group"
    LOGS_GROUP_NAME="${LOGS_GROUP_NAME}"
  # LOGS_EVENT_MAX_ITEMS:"2"
    LOGS_EVENT_MAX_ITEMS="${LOGS_EVENT_MAX_ITEMS}"

END

コマンド:

aws logs filter-log-events \
  --log-group-name ${LOGS_GROUP_NAME} \
  --max-items ${LOGS_EVENT_MAX_ITEMS}

結果(例):

{
    "events": [
        {
            "logStreamName": "handson-cli-logs-novice-stream",
            "timestamp": 1632992925000,
            "message": "event novice 1.",
            "ingestionTime": 1632993041132,
            "eventId": "36416959131428227987943269024703993400668596302076051456"
        },
        {
            "logStreamName": "handson-cli-logs-novice-stream",
            "timestamp": 1632993385000,
            "message": "event novice 2.",
            "ingestionTime": 1632993404312,
            "eventId": "36416969389771019312029914570191745346436261101488308224"
        }
    ],
    "searchedLogStreams": [],
    "NextToken": "eyJuZXh0VG9rZW4iOiAiQnhrcTZrVkdGdHEyeV9Nb2lnZXFzY1BPZGhYVmJoaVZ0TG9BbVhiNWpDcVhWbkpic1VMdFV1LVZBN2VkRWtqSFFOSmVRNWpDeGowVHFGV3p1MkVlaGhTZHpMNFJiSW83RFI4Qmp1eXRvQmwwUlRadWZUUE1iSlFPaXF0SWw3c0pLVzA5ZnlVaXpCYWZ0YzhoeEN5WjBzLWFCZFpsVzRKQkdpR2FualFwWGdzSWkwdjNadjlZUmtGMHFfLVJmR1ZpaUo5R0IxQjZxcWVGZnNqTXNFU05lLWN4Wnh6d3V3eVFVWmNETjBsREpGNmdQY2FSNVVURTZXZ3htOUd0YnlkaEZPNlVkalBTWnQyMjdpdkNjZGdaRncifQ=="
}

完了確認

「CloudWatch Logsロググループ"handson-cli-logs-novice-group"にログイベントが存在する。」ことを確認します。

注釈

主処理で取得できていればOKです。

手順の完了