监控Amazon IoT SiteWise和亚马逊在一起CloudWatch日志 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

监控Amazon IoT SiteWise和亚马逊在一起CloudWatch日志

你可以配置Amazon IoT SiteWise将信息记录到CloudWatch用于监控和排除服务故障的日志。

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

您必须有一个允许的资源策略Amazon 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:SourceArnaws:SourceAccount条件上下文密钥。这些条件上下文键是可选的。

创建或更新允许的资源策略Amazon IoT SiteWise仅放置与指定关联的日志Amazon IoT SiteWise资源输入CloudWatchstreams,运行命令并执行以下操作:

  • 替换logging-policy-name使用要创建的策略的名称。

  • 替换来源 arn使用你的 ARNAmazon IoT SiteWise资源,例如资产模型或资产。查找每个人的 ARNAmazon IoT SiteWise资源类型,请参见定义的资源类型Amazon IoT SiteWise服务授权参考

  • 替换账户 ID和Amazon与指定关联的账户 IDAmazon 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. 选择编辑

  4. 选择冗长程度激活。

  5. 选择保存

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