Amazon CloudWatch Logs によるモニタリング - AWS IoT SiteWise
ログインの管理 AWS IoT SiteWise例: AWS IoT SiteWise ログファイルエントリ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

サービスをモニタリング 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 ログは aws:SourceArn および aws:SourceAccount 条件コンテキストキーもサポートしています。これらの条件コンテクストキーはオプションです。

が指定されたリソースに関連付けられたログ AWS IoT SiteWise のみを CloudWatch ストリームに配置することができる AWS IoT SiteWise リソースポリシーを作成または更新するには、 コマンドを実行し、以下を実行します。

  • 置換 logging-policy-name は、作成するポリシーの名前で指定します。

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

  • 置換 account-ID 指定された AWS IoT SiteWise リソースに関連付けられた AWS アカウント ID を持つ 。

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 は情報を CloudWatch ログに記録しません。ログ記録を有効にするには、無効 () 以外のログ記録レベルを選択しますOFF。 は次のログ記録レベル AWS IoT SiteWise をサポートします。

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

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

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

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

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

ログインの管理 AWS IoT SiteWise

次のログ記録設定タスク AWS CLI には、 AWS IoT SiteWise コンソールまたは を使用します。

ログ記録レベルの検索

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. [Save] を選択します。

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 ログエントリには、イベント情報とそのイベントの関連リソースが含まれているため、ログデータを理解して分析できます。

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

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