使用 Amazon CloudWatch 日誌監控 - 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 錄檔的資源策略,請執行下列命令。Replace (取代) 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: SourceArnaws: SourceAccount 條件內容金鑰。這些條件上下文鍵是可選的。

若要建立或更新僅允許 AWS IoT SiteWise 將與指定資源關聯的記錄檔放入 CloudWatch 串流的 AWS IoT SiteWise 資源策略,請執行命令並執行下列動作:

  • Replace (取代) logging-policy-name 使用要建立的策略名稱。

  • Replace (取代) source-ARN 與您ARN的 AWS IoT SiteWise 資源,例如資產模型或資產。若要尋找每個 AWS IoT SiteWise 資源類型的,請參閱服務授權參考 AWS IoT SiteWise中所定義的資源類型。ARN

  • Replace (取代) 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 邊緣閘道記錄

如果您 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. 選擇 Save (儲存)。

AWS CLI

執行下列 AWS CLI 命令以變更記 AWS IoT SiteWise 錄層級。Replace (取代) 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" } }