本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudWatch Logs 監控
<a name="monitor-cloudwatch-logs"></a>

設定 AWS IoT SiteWise 將資訊記錄到 CloudWatch Logs 以監控和疑難排解服務。

當您使用 AWS IoT SiteWise 主控台時， 會 AWS IoT SiteWise 建立服務連結角色，允許服務代表您記錄資訊。如果您不使用 AWS IoT SiteWise 主控台，則必須手動建立服務連結角色才能接收日誌。如需詳細資訊，請參閱[建立 的服務連結角色 AWS IoT SiteWise](create-service-linked-role.md)。

您必須擁有允許 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](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 僅將與指定 AWS IoT SiteWise 資源相關聯的日誌放入 CloudWatch 串流，請執行 命令並執行下列動作：
+ 將 *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。若要啟用記錄，請選擇**已停用** () 以外的記錄層級`OFF`。 AWS IoT SiteWise 支援下列記錄層級：
+ `OFF` – 記錄已關閉。
+ `ERROR` – 記錄錯誤。
+ `INFO` – 記錄錯誤和資訊訊息。

您可以設定 SiteWise Edge 閘道，透過 將資訊記錄到 CloudWatch Logs AWS IoT Greengrass。如需詳細資訊，請參閱[監控 SiteWise Edge 閘道日誌](monitor-gateway-logs.md)。

如果您正在對 AWS IoT SiteWise 規則動作進行故障診斷，也可以設定 AWS IoT Core 將資訊記錄到 CloudWatch Logs。如需詳細資訊，請參閱[對 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. 在左側導覽窗格中，選擇 **Logging options (記錄選項)**。

   目前的記錄狀態會顯示在 **Logging status (記錄狀態)** 下方。如果啟用記錄，目前的記錄層級會顯示在**詳細程度**下。

------
#### [ 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 日誌項目都包含該事件的事件資訊和相關資源，因此您可以了解和分析日誌資料。

下列範例顯示 CloudWatch Logs 項目，在您成功建立資產模型時 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"
  }
}
```