监控Amazon IoT SiteWise使用 Amazon CloudWatch 日志 - Amazon IoT SiteWise
管理 Amazon IoT SiteWise 中的日志记录（控制台）管理 Amazon IoT SiteWise 中的日志记录 (CLI)示例：Amazon IoT SiteWise 日志文件条目
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

监控Amazon IoT SiteWise使用 Amazon CloudWatch 日志

您可以配置Amazon IoT SiteWise将信息记录到 CloudWatch 用于监控服务并排查服务的问题。

在使用 Amazon IoT SiteWise 控制台时，Amazon IoT SiteWise 会创建一个服务相关角色来允许服务代表您记录信息。如果不使用 Amazon IoT SiteWise 控制台，则必须手动创建一个服务相关角色来接收日志。有关更多信息，请参阅 为 Amazon IoT SiteWise 创建服务相关角色。

你必须有允许的资源策略Amazon IoT SiteWise将日志事件放入 CloudWatch Streams。创建和更新资源策略 CloudWatch 日志，运行以下命令。Replacelogging-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条件上下文键。这些条件上下文键是可选的。

创建或更新资源策略，使Amazon IoT SiteWise仅放置与指定的Amazon IoT SiteWise资源进入 CloudWatch streams，运行命令并执行以下操作：

  • Replacelogging-policy-name以及要创建的策略的名称。

  • ReplaceSource-ARARNAmazon IoT SiteWise资源，例如资产模型或资产。查找每个的 ARNAmazon IoT SiteWise资源类型，请参阅定义的资源类型Amazon IoT SiteWise中的服务授权参考.

  • Replaceaccount-id用Amazon与指定的Amazon IoT SiteWise资源。

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

默认情况下，Amazon IoT SiteWise不会将信息记录到 CloudWatch 日志。要启用日志记录，请选择已禁用 (OFF) 之外的日志记录级别。Amazon IoT SiteWise 支持以下日志记录级别：

  • OFF— 禁用日志记录。

  • ERROR— 记录错误。

  • INFO— 记录错误和信息性消息。

您可以将网关配置为将信息记录到 CloudWatch 通过登录Amazon IoT Greengrass. 有关更多信息，请参阅 监控网关日志。

您也可以配置Amazon IoT Core将信息记录到 CloudWatch 如果您正在进行故障排除，则记录日志Amazon IoT SiteWise规则操作。有关更多信息，请参阅 Amazon IoT SiteWise 规则操作故障排除。

管理 Amazon IoT SiteWise 中的日志记录（控制台）

可以将 Amazon IoT SiteWise 控制台用于以下日志记录配置任务。

查找日志记录级别（控制台）

使用以下过程可在 Amazon IoT SiteWise 控制台中查找当前的日志记录级别。

查找当前的 Amazon IoT SiteWise 日志记录级别

  1. 导航到 Amazon IoT SiteWise 控制台。

  2. 在左侧导航窗格中，选择日志记录选项。

    当前日志记录状态显示在日志记录状态下。如果已启用日志记录，则当前日志记录级别将显示在详细程度级别下。

更改日志记录级别（控制台）

使用以下过程可在 Amazon IoT SiteWise 控制台中更改日志记录级别。

更改 Amazon IoT SiteWise 日志记录级别

  1. 导航到 Amazon IoT SiteWise 控制台。

  2. 在左侧导航窗格中，选择日志记录选项。

  3. 选择 Edit（编辑）。

  4. 选择要启用的详细程度级别。

  5. 选择 Save（保存）。

管理 Amazon IoT SiteWise 中的日志记录 (CLI)

可以将 Amazon Command Line Interface (Amazon CLI) 用于以下日志记录配置任务。

查找日志记录级别 (CLI)

运行以下命令可使用 Amazon CLI 查找当前 Amazon IoT SiteWise 日志记录级别。

aws iotsitewise describe-logging-options

此操作将采用以下格式返回包含日志记录级别的响应。

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

更改日志记录级别 (CLI)

运行以下 Amazon CLI 命令可更改 Amazon IoT SiteWise 日志记录级别。将 logging-level 替换为所需的日志记录级别。

aws iotsitewise put-logging-options --logging-options level=logging-level

示例：Amazon IoT SiteWise 日志文件条目

每个 Amazon IoT SiteWise 日志条目都包含该事件的事件信息和相关资源，以便您能够轻松理解和分析日志数据。

以下示例显示了一个 CloudWatch 记录条目Amazon 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"
  }
}