使用 Amazon CloudWatch 日誌監控 - AWS IoT SiteWise
管理登入 AWS IoT SiteWise範例： AWS IoT SiteWise 記錄檔項目

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

使用 Amazon CloudWatch 日誌監控

設定 AWS IoT SiteWise 為將資訊 CloudWatch 記錄至記錄檔，以監控服務並進行疑難排解。

使用 AWS IoT SiteWise 主控台時， AWS IoT SiteWise 會建立服務連結角色，讓服務代表您記錄資訊。如果不使用 AWS IoT SiteWise 主控台，則必須手動建立服務連結角色以接收記錄檔。如需詳細資訊，請參閱 為 AWS IoT SiteWise建立服務連結角色。

您必須具有允許將記錄事件放 AWS IoT SiteWise 入 CloudWatch 串流的資源策略。若要建立和更新記 CloudWatch 錄檔的資源策略，請執行下列命令。以要建立的策略名稱取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代。

  • 將來源-ARN 取代為資源的 ARN，例如 AWS IoT SiteWise 資產模型或資產。若要尋找每個 AWS IoT SiteWise 資源類型的 ARN，請參閱服務授權參考 AWS IoT SiteWise中所定義的資源類型。

  • 將帳號 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 邊緣閘道記錄檔。

如果您 AWS IoT Core 要疑難排解 AWS IoT SiteWise 規則動作，也可以設定將資訊 CloudWatch 記錄到記錄檔。如需詳細資訊，請參閱 疑難排解 AWS IoT SiteWise 規則動作。

管理登入 AWS IoT SiteWise

使用主 AWS IoT SiteWise 控台或執 AWS CLI 行下列記錄組態工作。

尋找您的記錄等級

Console

使用下列程序在 AWS IoT SiteWise 主控台中尋找目前的記錄層級。

若要尋找您目前的 AWS IoT SiteWise 記錄等級

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在左側導覽窗格中，選擇 Logging options (記錄選項)。

    目前的記錄狀態會顯示在 Logging status (記錄狀態) 下方。如果已啟動記錄，目前的記錄層級會出現在詳細等級下。

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