本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
监控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:SourceArn和aws: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 日志记录级别
-
在左侧导航窗格中,选择日志记录选项。
当前日志记录状态显示在日志记录状态下。如果激活了日志记录,则当前的日志级别显示在冗长程度。
更改日志记录级别(控制台)
使用以下过程可在 Amazon IoT SiteWise 控制台中更改日志记录级别。
更改 Amazon IoT SiteWise 日志记录级别
-
在左侧导航窗格中,选择日志记录选项。
-
选择编辑。
-
选择冗长程度激活。
-
选择保存。
管理 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" } }