2.4. S3バケット ログ設定 (handson-cli-s3-website-logging-website-XXXXXXXXXXXX)

目的

S3バケット"handson-cli-s3-website-logging-website-XXXXXXXXXXXX"のログをログ用S3バケット"handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log"に転送する設定を行います。

パラメータの指定

作業に必要なパラメータを変数に格納をします。

1. S3バケット名の指定

S3バケット名を指定します。

変数の設定:

S3_BUCKET_PREFIX='handson-cli-s3-website-logging-website'

コマンド:

AWS_ID=$( \
  aws sts get-caller-identity \
    --query 'Account' \
    --output text \
) \
  && echo ${AWS_ID}

結果(例):

XXXXXXXXXXXX

変数の設定:

S3_BUCKET_NAME="${S3_BUCKET_PREFIX}-${AWS_ID}" \
  && echo ${S3_BUCKET_NAME}

結果(例):

handson-cli-s3-website-logging-website-XXXXXXXXXXXX

2. ログ用バケット名の指定

ログ用バケット名を指定します。

変数の設定:

S3_BUCKET_LOG="${S3_BUCKET_NAME}-log" \
  && echo ${S3_BUCKET_LOG}

結果(例):

handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log

3. ログファイルのプレフィックス指定

ログファイルのプレフィックスを指定します。

変数の設定:

S3_PREFIX_LOG='Logs'

4. ログ設定ファイル用ディレクトリの指定

ログ設定ファイル用ディレクトリを指定します。

変数の設定:

DIR_S3_BUCKET_LOGGING_DOC="${HOME}/environment/conf-handson-cli-s3-website-logging"

• 今回は"${HOME}/environment/conf-handson-cli-s3-website-logging"をログ設定ファイル用ディレクトリとします。

ディレクトリが存在することを確認します。

コマンド:

ls -d ${HOME}/environment/conf-handson-cli-s3-website-logging

結果(例:存在する場合):

${HOME}/environment/conf-handson-cli-s3-website-logging

存在しない場合は作成します。

コマンド:

mkdir -p ${HOME}/environment/conf-handson-cli-s3-website-logging

5. ログ設定ファイル名の指定

ログ設定ファイル名を指定します。

変数の設定:

FILE_S3_BUCKET_LOGGING_DOC="${DIR_S3_BUCKET_LOGGING_DOC}/${S3_BUCKET_NAME}-s3-bucket-logging-create.json" \
  && echo ${FILE_S3_BUCKET_LOGGING_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-s3-website-logging/handson-cli-s3-website-logging-website-XXXXXXXXXXXX-s3-bucket-logging-create.json

各変数に正しいパラメータ値が格納されていることを確認します。

変数の確認:

cat << END

  # 1. S3_BUCKET_NAME:"handson-cli-s3-website-logging-website-XXXXXXXXXXXX"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 2. S3_BUCKET_LOG:"handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log"
       S3_BUCKET_LOG="${S3_BUCKET_LOG}"
  # 3. S3_PREFIX_LOG:"Logs"
       S3_PREFIX_LOG="${S3_PREFIX_LOG}"
  # 4. DIR_S3_BUCKET_LOGGING_DOC:"${HOME}/environment/conf-handson-cli-s3-website-logging"
       DIR_S3_BUCKET_LOGGING_DOC="${DIR_S3_BUCKET_LOGGING_DOC}"
  # 5. FILE_S3_BUCKET_LOGGING_DOC:"${HOME}/environment/conf-handson-cli-s3-website-logging/handson-cli-s3-website-logging-website-XXXXXXXXXXXX-s3-bucket-logging-create.json"
       FILE_S3_BUCKET_LOGGING_DOC="${FILE_S3_BUCKET_LOGGING_DOC}"

END

手順

設定ファイルを作成します。

変数の確認:

cat << ETX

  # FILE_S3_BUCKET_LOGGING_DOC:"${HOME}/environment/conf-handson-cli-s3-website-logging/handson-cli-s3-website-logging-website-XXXXXXXXXXXX-s3-bucket-logging-create.json"
    FILE_S3_BUCKET_LOGGING_DOC="${FILE_S3_BUCKET_LOGGING_DOC}"
  # S3_BUCKET_LOG:"handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log"
    S3_BUCKET_LOG="${S3_BUCKET_LOG}"
  # S3_PREFIX_LOG:"Logs"
    S3_PREFIX_LOG="${S3_PREFIX_LOG}"

ETX

コマンド:

cat << EOF > ${FILE_S3_BUCKET_LOGGING_DOC}
{
  "LoggingEnabled": {
    "TargetBucket": "${S3_BUCKET_LOG}",
    "TargetPrefix": "${S3_PREFIX_LOG}/"
  }
}
EOF

cat ${FILE_S3_BUCKET_LOGGING_DOC}

結果(例):

{
  "LoggingEnabled": {
    "TargetBucket": "handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log",
    "TargetPrefix": "Logs"
  }
}

コマンド:

cat ${FILE_S3_BUCKET_LOGGING_DOC} \
  |  python3 -m json.tool \
  > /dev/null

結果(例):

(出力なし)

ログの設定をします。

変数の確認

cat << ETX

  # S3_BUCKET_NAME:"handson-cli-s3-website-logging-website-XXXXXXXXXXXX"
    S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # FILE_S3_BUCKET_LOGGING_DOC:"${HOME}/environment/conf-handson-cli-s3-website-logging/handson-cli-s3-website-logging-website-XXXXXXXXXXXX-s3-bucket-logging-create.json"
    FILE_S3_BUCKET_LOGGING_DOC="${FILE_S3_BUCKET_LOGGING_DOC}"

ETX

コマンド:

aws s3api put-bucket-logging \
  --bucket ${S3_BUCKET_NAME} \
  --bucket-logging-status file://${FILE_S3_BUCKET_LOGGING_DOC}

結果(例):

(出力なし)

完了確認

「S3バケット" handson-cli-s3-website-logging-website-XXXXXXXXXXXX"のバケットログ設定が有効になっている。」ことを確認します。

コマンド:

aws s3api get-bucket-logging \
  --bucket ${S3_BUCKET_NAME}

結果(例):

{
  "LoggingEnabled": {
    "TargetPrefix": "Logs/",
    "TargetBucket": "handson-cli-s3-website-logging-website-XXXXXXXXXXXX-log"
  }
}