AWS CLIを利用して、IoTのログ設定をしてみます。

前提条件

IoTへの権限

AWS IoTに対してフル権限があること。

AWS CLIのバージョン

以下のバージョンで動作確認済

AWS CLI 1.11.14

コマンド

aws --version

結果(例)

      aws-cli/1.11.14 Python/2.7.10 Darwin/15.6.0 botocore/1.4.71

バージョンが古い場合は最新版に更新しましょう。

コマンド

sudo -H pip install -U awscli

準備
=======

0.1. リージョンの決定

構築するリージョンを決めます。 (カレントユーザが利用するカレントリージ
ョンも切り変わります。)

コマンド(東京リージョンの場合)

export AWS_DEFAULT_REGION='ap-northeast-1'

0.2. 変数の確認

プロファイルが想定のものになっていることを確認します。

コマンド

aws configure list

結果(例)

            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile         administrator-prjz-mbp13        env    AWS_DEFAULT_PROFILE
      access_key     ****************XXXX shared-credentials-file
      secret_key     ****************XXXX shared-credentials-file
          region                         ap-northeast-1  env    AWS_DEFAULT_REGION

AssumeRoleを利用している場合はprofileが ''と表示されます。そ
れ以外のときにprofileが '' と表示される場合は、以下を実行して
ください。

変数の設定:

     export AWS_DEFAULT_PROFILE=<IAMユーザ名>

0.3. IAMロール名の指定

変数の設定

IAM_ROLE_NAME='AWSIoTLoggingPutRole'

事前作業
===========

1.1. ロールARNの取得

変数の設定

IAM_ROLE_ARN=$( \
        aws iam get-role \
          --role-name ${IAM_ROLE_NAME} \
          --query 'Role.Arn' \
          --output text \
) \
        && echo ${IAM_ROLE_ARN}

結果(例)

      arn:aws:iam::XXXXXXXXXXXX:role/AWSIoTLoggingPutRole

1.1. ロギング設定の確認

コマンド

aws iot get-logging-options

結果(例)

      A client error (InvalidRequestException) occurred when calling the GetLoggingOptions operation: Customer Logging Role does not exist for account 'XXXXXXXXXXXX'

1.2. ログレベルの指定

変数の設定

IOT_LOGGING_LEVEL='INFO'

1.3. 設定文字列の作成

変数の設定

IOT_LOGOPT_PAYLOAD="roleArn=${IAM_ROLE_ARN},logLevel=${IOT_LOGGING_LEVEL}" \
        && echo ${IOT_LOGOPT_PAYLOAD}

set-logging-options
======================

変数の確認

cat << ETX

        IOT_LOGOPT_PAYLOAD: ${IOT_LOGOPT_PAYLOAD}

ETX

コマンド

aws iot set-logging-options \
        --logging-options-payload ${IOT_LOGOPT_PAYLOAD}

結果(例)

      (戻り値なし)

事後作業
===========

コマンド

aws iot get-logging-options

結果(例)

      {
        "logLevel": "INFO",
        "roleArn": "arn:aws:iam::XXXXXXXXXXXX:role/AWSIoTLoggingPutRole"
      }

完了