AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS IoT 指标与维度

当您与 AWS IoT 交互时,此服务每一分钟都会向 CloudWatch 发送以下指标和维度。您可以按照以下步骤查看 AWS IoT 的各项指标。

查看指标(CloudWatch 控制台)

指标的分组首先依据服务命名空间,然后依据每个命名空间内的各种维度组合。

  1. 通过以下网址打开 CloudWatch 控制台:https://console.amazonaws.cn/cloudwatch/

  2. 在导航窗格中,选择 Metrics

  3. 按类别显示的 CloudWatch 指标窗格中,在 AWS IoT 的指标类别下,选择一个指标类别,然后在上方窗格中,向下滚动以查看完整的指标列表。

查看指标 (CLI)

  • 在命令提示符处,输入以下命令:

    aws cloudwatch list-metrics --namespace "AWS/IoT"

CloudWatch 显示 AWS IoT 的以下指标:

AWS IoT 指标

AWS/IoT 命名空间包含以下指标。对于收到的每个请求,AWS IoT 向 CloudWatch 发送以下指标一次。

AWS IoT 指标

指标 描述

RulesExecuted

已执行的 AWS IoT 规则的数量。

NumLogEventsFailedToPublishThrottled

批处理中的因限制错误而无法发布的日志事件的数量。

NumLogBatchesFailedToPublishThrottled

因限制错误而无法发布的日志事件的单个批次。

规则指标

指标 描述

TopicMatch

已在规则所侦听的主题上发布的传入消息的数量。RuleName 维度包含规则的名称。

ParseError

在规则所侦听的主题上发布的消息中出现的 JSON 分析错误的数量。RuleName 维度包含规则的名称。

RuleNotFound

找不到要触发的规则。RuleName 维度包含规则的名称。

RuleMessageThrottled

由于恶意行为或由于消息数超过了规则引擎的限制,规则引擎限制的消息数。RuleName 维度包含要触发的规则的名称。

规则操作指标

指标 描述

Success

成功的规则操作调用的数量。RuleName 维度包含指定操作的规则的名称。ActionType 维度包含已调用的操作的类型。

Failure

失败的规则操作调用的数量。RuleName 维度包含指定操作的规则的名称。RuleName 维度包含指定操作的规则的名称。ActionType 维度包含已调用的操作的类型。

消息代理指标

指标 描述

Connect.AuthError

无法由消息代理授权的连接请求的数量。Protocol 维度包含用于发送 CONNECT 消息的协议。

Connect.ClientError

因 MQTT 消息未能满足 AWS IoT 限制中定义的要求而被拒绝的连接请求的数量。Protocol 维度包含用于发送 CONNECT 消息的协议。

Connect.ServerError

因出现内部错误而导致失败的连接请求的数量。Protocol 维度包含用于发送 CONNECT 消息的协议。

Connect.Success

与消息代理的成功连接的数量。Protocol 维度包含用于发送 CONNECT 消息的协议。

Connect.Throttle

因客户端超出允许的连接请求速率而受限的连接请求的数量。此值可以是账户级别连接速率或来自同一客户端 ID 的连接数。Protocol 维度包含用于发送 CONNECT 消息的协议。

Ping.Success

消息代理收到的 ping 消息的数量。Protocol 维度包含用于发送 ping 消息的协议。

PublishIn.AuthError

消息代理无法授权的发布请求的数量。Protocol 维度包含用于发布消息的协议。

PublishIn.ClientError

因消息未能满足 AWS IoT 限制中定义的要求而被消息代理拒绝的发布请求的数量。Protocol 维度包含用于发布消息的协议。

PublishIn.ServerError

因出现内部错误而导致消息代理无法处理的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

PublishIn.Success

消息代理已成功处理的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

PublishIn.Throttle

因客户端超出允许的入站消息速率而受限制的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

PublishOut.AuthError

AWS IoT 无法授权的由消息代理发出的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

PublishOut.ClientError

因消息未能满足 AWS IoT 限制中定义的要求而被拒绝的由消息代理发出的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

PublishOut.Success

消息代理已成功发出的发布请求的数量。Protocol 维度包含用于发送 PUBLISH 消息的协议。

Subscribe.AuthError

无法授权的由客户端发出的订阅请求的数量。Protocol 维度包含用于发送 SUBSCRIBE 消息的协议。

Subscribe.ClientError

SUBSCRIBE 消息未能满足 AWS IoT 限制中定义的要求而被拒绝的订阅请求的数量。Protocol 维度包含用于发送 SUBSCRIBE 消息的协议。

Subscribe.ServerError

因出现内部错误而被拒绝的订阅请求的数量。Protocol 维度包含用于发送 SUBSCRIBE 消息的协议。

Subscribe.Success

消息代理已成功处理的订阅请求的数量。Protocol 维度包含用于发送 SUBSCRIBE 消息的协议。

Subscribe.Throttle

因客户端超出允许的订阅请求速率而受限的订阅请求的数量。Protocol 维度包含用于发送 SUBSCRIBE 消息的协议。

Unsubscribe.ClientError

UNSUBSCRIBE 消息未能满足 AWS IoT 限制中定义的要求而被拒绝的取消订阅请求的数量。Protocol 维度包含用于发送 UNSUBSCRIBE 消息的协议。

Unsubscribe.ServerError

因出现内部错误而被拒绝的取消订阅请求的数量。Protocol 维度包含用于发送 UNSUBSCRIBE 消息的协议。

Unsubscribe.Success

消息代理已成功处理的取消订阅请求的数量。Protocol 维度包含用于发送 UNSUBSCRIBE 消息的协议。

Unsubscribe.Throttle

因客户端超出允许的取消订阅请求速率而被拒绝的取消订阅请求的数量。Protocol 维度包含用于发送 UNSUBSCRIBE 消息的协议。

注意

消息代理指标显示在 AWS IoT 控制台中的 Protocol Metrics (协议指标) 的下方。

Device Shadow 指标

指标 描述

DeleteThingShadow.Accepted

已成功处理的 DeleteThingShadow 请求的数量。Protocol 维度包含用于发出请求的协议。

GetThingShadow.Accepted

已成功处理的 GetThingShadow 请求的数量。Protocol 维度包含用于发出请求的协议。

UpdateThingShadow.Accepted

已成功处理的 UpdateThingShadow 请求的数量。Protocol 维度包含用于发出请求的协议。

注意

设备影子指标显示在 AWS IoT 控制台中的 Protocol Metrics (协议指标) 的下方。

作业指标

指标 描述

ServerError

执行作业时生成的服务器错误数。JobId 维度包含作业的 ID。

ClientError

执行作业时生成的客户端错误数。JobId 维度包含作业的 ID。

QueuedJobExecutionTotalCount

给定作业的状态为 QUEUED 的作业执行总数。JobId 维度包含作业的 ID。

InProgressJobExecutionTotalCount

给定作业的状态为 IN_PROGRESS 的作业执行总数。JobId 维度包含作业的 ID。

FailedJobExecutionTotalCount

给定作业的状态为 FAILED 的作业执行总数。JobId 维度包含作业的 ID。

SuccededJobExecutionTotalCount

给定作业的状态为 SUCCESS 的作业执行总数。JobId 维度包含作业的 ID。

CanceledJobExecutionTotalCount

给定作业的状态为 CANCELED 的作业执行总数。JobId 维度包含作业的 ID。

RejectedJobExecutionTotalCount

给定作业的状态为 REJECTED 的作业执行总数。JobId 维度包含作业的 ID。

RemovedJobExecutionTotalCount

给定作业的状态为 REMOVED 的作业执行总数。JobId 维度包含作业的 ID。

QueuedJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 QUEUED 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

InProgressJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 IN_PROGRESS 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

FailedJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 FAILED 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

SuccededJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 SUCCESS 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

CanceledJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 CANCELED 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

RejectedJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 REJECTED 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

RemovedJobExecutionCount

在由 CloudWatch 确定的时间段内,其状态已更改为 REMOVED 的作业执行的数量。(有关 CloudWatch 指标的更多信息,请参阅 Amazon CloudWatch 指标。) JobId 维度包含作业的 ID。

Device Defender Audit 指标

指标 描述

NonCompliantResources

在检查中发现的不合规资源数。系统报告执行的每次审核中,对于每次检查发现的不合规资源数。

ResourcesEvaluated

执行合规性评估的资源数。系统报告执行的每次审核中,对于每次检查所评估的资源数。

Device Defender Detect 指标

指标 描述

违反

自上次执行评估以来,所发现的安全配置文件行为的新违规数。系统针对特定安全配置文件,以及针对某个特定安全配置文件的特定行为,报告账户的新违规数。

ViolationsCleared

自上次执行评估以来,已解决的安全配置文件行为的违规数。系统针对特定安全配置文件,以及针对某个特定安全配置文件的特定行为,报告账户的已解决违规数。

ViolationsInvalidated

自上次执行评估以来,其信息不再可用(由于报告设备已停止报告,或者由于某个原因不再监控)的安全配置文件行为的违规数。系统针对特定安全配置文件,以及针对某个特定安全配置文件的特定行为,报告整个账户的已失效违规数。

指标的维度

指标使用命名空间并提供以下维度的指标。

维度 描述
ActionType

触发请求的规则所指定的操作类型

Protocol

用于提出请求的协议。有效值为:MQTT 或 HTTP

RuleName

由请求触发的规则的名称。

JobId

正在监视其进度或消息连接成功/失败的作业的 ID。

CheckName

正在监控其结果的 Device Defender Audit 检查的名称。

ScheduledAuditName

正在监控其检查结果的 Device Defender 计划审核的名称。如果报告的结果适用于按需执行的审核,此项具有值“OnDemand”。

SecurityProfileName

正在监控其行为的 Device Defender Detect 安全配置文件的名称。

BehaviorName

正受监控的 Device Defender Detect 安全配置文件行为的名称。