监控Amazon IoT SiteWise使用 Amazon CloudWatch 日志 - 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 流。为创建和更新资源策略 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条件上下文键。这些条件上下文键是可选的。

创建或更新以创建以创建以创建以创建以创建以创建以创建以创建Amazon IoT SiteWise只放置与指定相关的日志Amazon IoT SiteWise资源转入 CloudWatch 流,运行命令并执行以下操作:

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

  • Replace(替换)来源-arn使用您的 ARNAmazon IoT SiteWise资源,例如资产模型或资产。查找每个的 ARNAmazon IoT SiteWise资源类型,请参阅定义的资源类型Amazon IoT SiteWise在里面服务授权参考.

  • Replace(替换)账户 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. 选择 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" } }