Amazon CloudWatch ログによるモニタリング

AWS IoT SiteWise 情報をログに記録して、 CloudWatch サービスの監視とトラブルシューティングを行うように設定します。

AWS IoT SiteWise コンソールを使用すると、 AWS IoT SiteWise サービスがユーザーに代わって情報を記録できるようにするサービスにリンクされたロールが作成されます。 AWS IoT SiteWise コンソールを使用しない場合は、ログを受信するためにサービスにリンクされたロールを手動で作成する必要があります。詳細については、「AWS IoT SiteWiseのサービスリンクロールの作成」を参照してください。

AWS IoT SiteWise ログイベントをストリームに入れることを許可するリソースポリシーが必要です。 CloudWatch CloudWatch Logs のリソースポリシーを作成および更新するには、以下のコマンドを実行します。logging-policy-name作成するポリシーの名前に置き換えます。

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch Logs は aws: SourceArn と aws: SourceAccount 条件コンテキストキーもサポートします。これらの条件コンテクストキーはオプションです。

AWS IoT SiteWise AWS IoT SiteWise CloudWatch 指定したリソースに関連するログのみをストリームに入れることを許可するリソースポリシーを作成または更新するには、コマンドを実行して次の操作を行います。

• logging-policy-name作成するポリシーの名前に置き換えます。

• source-ARN は、 AWS IoT SiteWise アセットモデルやアセットなどのリソースの ARN に置き換えます。 AWS IoT SiteWise 各リソースタイプの ARN を確認するには、『サービス認証リファレンス』の「AWS IoT SiteWiseで定義されるリソースタイプ」を参照してください。

• account-ID は、 AWS 指定したリソースに関連付けられたアカウント ID に置き換えます。 AWS IoT SiteWise

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

デフォルトでは、 AWS IoT SiteWise Logs CloudWatch に情報を記録しません。ロギングを有効にするには、Disabled (OFF) 以外のロギングレベルを選択します。 AWS IoT SiteWise は次のロギングレベルをサポートします。

• OFF – ログ記録はオフになります。

• ERROR - エラーがログ記録されます。

• INFO - エラーおよび情報メッセージがログ記録されます。

SiteWise Edge ゲートウェイは、 CloudWatch Logs through AWS IoT Greengrassに情報を記録するように設定できます。詳細については、「 SiteWise Edge ゲートウェイログの監視」を参照してください。

AWS IoT SiteWise ルールアクションのトラブルシューティングを行う場合は、 AWS IoT Core CloudWatch 情報をログに記録するように設定することもできます。詳細については、「AWS IoT SiteWise ルールアクションのトラブルシューティング」を参照してください。

目次

• ログインの管理 AWS IoT SiteWise
  • ロギングレベルを調べる
  • ロギングレベルの変更
• 例: AWS IoT SiteWise ログファイルエントリ

ログインの管理 AWS IoT SiteWise

AWS IoT SiteWise コンソールを使用するか AWS CLI 、以下のロギング設定タスクを行います。

ロギングレベルを調べる

Console

AWS IoT SiteWise コンソールで現在のログ記録レベルを確認するには、次の手順に従います。

AWS IoT SiteWise 現在のロギングレベルを確認するには

1. AWS IoT SiteWise コンソールに移動します。

2. 左側のナビゲーションペインで、[ログ記録オプション] を選択します。

   [ロギングステータス ] に、現在のログ記録ステータスが表示されます。ログ記録が有効な場合は、現在のログ記録レベルが [詳細レベル] の下に表示されます。

AWS CLI

次のコマンドを実行して、 AWS IoT SiteWise の現在のロギングレベルを調べます AWS CLI。

aws iotsitewise describe-logging-options

このオペレーションは、ログ記録レベルを次の形式で返します。

{
  "loggingOptions": {
    "level": "String"
  }
}

ロギングレベルの変更

次の手順に従って、 AWS IoT SiteWise コンソールまたはを使用してロギングレベルを変更します AWS CLI。

Console

AWS IoT SiteWise ロギングレベルを変更するには

1. AWS IoT SiteWise コンソールに移動します。

2. 左側のナビゲーションペインで、[Logging options (ログ記録オプション) ] を選択します。

3. [編集] を選択します。

4. 有効にする [詳細レベル] を選択します。

5. [保存] を選択します。

AWS CLI

AWS CLI AWS IoT SiteWise 以下のコマンドを実行してロギングレベルを変更します。logging-level は、必要なログ記録レベルに置き換えます。

aws iotsitewise put-logging-options --logging-options level=logging-level

例: AWS IoT SiteWise ログファイルエントリ

AWS IoT SiteWise 各ログエントリにはイベント情報とそのイベントに関連するリソースが含まれているため、ログデータを理解して分析できます。

次の例は、 CloudWatch AWS IoT SiteWise アセットモデルの作成に成功したときに記録するログエントリを示しています。

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}