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

# Amazon CloudWatch Logs によるモニタリング
<a name="monitor-cloudwatch-logs"></a>

CloudWatch Logs に情報を AWS IoT SiteWise ログ記録して、サービスをモニタリングおよびトラブルシューティングするように を設定します。

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

が CloudWatch ストリームにログイベント AWS IoT SiteWise を配置できるようにするリソースポリシーが必要です。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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) と [aws:SourceAccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-ke-sourceaccount) の条件コンテキストキーもサポートしています。これらの条件コンテクストキーはオプションです。

が指定されたリソースに関連付けられたログ AWS IoT SiteWise のみを CloudWatch ストリームに配置することを許可する AWS IoT SiteWise リソースポリシーを作成または更新するには、 コマンドを実行し、以下を実行します。
+ {{logging-policy-name}} は、作成するポリシーの名前に置き換えてください。
+ {{source-ARN}} をアセットモデルやアセットなどの AWS IoT SiteWise リソースの ARN に置き換えます。各 AWS IoT SiteWise リソースタイプの ARN を確認するには、*「サービス認可リファレンス*」の「 [で定義されるリソースタイプ AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies)」を参照してください。
+ {{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 Logs に情報をログに記録しません。ログ記録を有効にするには、**Disabled** () 以外のログ記録レベルを選択します`OFF`。 は、次のログ記録レベル AWS IoT SiteWise をサポートします。
+ `OFF` – ログ記録はオフになります。
+ `ERROR` - エラーがログ記録されます。
+ `INFO` - エラーおよび情報メッセージがログ記録されます。

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

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

**Contents**
+ [ログインの管理 AWS IoT SiteWise](#manage-cloudwatch-logs)
  + [ログ記録レベルを検索する](#find-logging-level)
  + [ログ記録レベルを変更する](#change-logging-level)
+ [例: AWS IoT SiteWise ログファイルエントリ](#sitewise-log-format)

## ログインの管理 AWS IoT SiteWise
<a name="manage-cloudwatch-logs"></a>

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

### ログ記録レベルを検索する
<a name="find-logging-level"></a>

------
#### [ Console ]

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

**現在の AWS IoT SiteWise ログ記録レベルを確認するには**

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

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

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

------
#### [ AWS CLI ]

次のコマンドを実行して、 で現在の AWS IoT SiteWise ログ記録レベルを見つけます AWS CLI。

```
aws iotsitewise describe-logging-options
```

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

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

------

### ログ記録レベルを変更する
<a name="change-logging-level"></a>

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

------
#### [ Console ]

**AWS IoT SiteWise ログ記録レベルを変更するには**

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

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

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

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

1. [**Save**] を選択します。

------
#### [ AWS CLI ]

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

```
aws iotsitewise put-logging-options --logging-options level={{logging-level}}
```

------

## 例: AWS IoT SiteWise ログファイルエントリ
<a name="sitewise-log-format"></a>

各 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"
  }
}
```