指标
通知中心遥测指标可报告不同操作的结果计数。 主要有两类操作:
API 调用,这包括创建、更新、查询和删除设备注册的调用,以及所有发送操作。
通知结果,这包括推送到各种平台通知服务 (PNS) 的所有结果。 可以将这些操作分开,以获取按平台统计的计数。
注册管理
可以从“常规”部分的“添加指标”菜单中添加注册管理操作遥测。
指标 | 说明 | REST 标识符 |
---|---|---|
注册操作 |
所有成功注册操作(创建、更新、查询和删除)的计数。 |
registration.all |
注册创建操作数目 |
所有成功的注册创建操作的计数。 |
registrations.create |
注册更新操作数目 |
所有成功的注册更新操作的计数。 |
registrations.update |
注册读取操作数目 |
所有成功的注册查询操作的计数。 |
registrations.get |
注册删除操作数目 |
所有成功的注册删除操作的计数。 |
registrations.delete |
传入消息数
传入消息是对通知中心的 API 调用,用于发送通知。 无论它们是否产生实际通知,都对它们进行计数(例如,标记可能未与任何注册相关联)。 请注意,只对成功的调用进行计数(即,不会产生异常或非 200 HTTP 状态代码)。
指标 | 说明 | REST 标识符 |
---|---|---|
传入消息数 |
所有成功的发送 API 调用的计数。 |
incoming |
传出通知
对于每次推送通知尝试,通知中心都会公开描述其结果的遥测。 这些结果在多平台和特定于平台的级别的各种指标中聚合。
你可以在“常规”选项卡的“添加指标”菜单中访问跨平台聚合的指标。
指标 | 说明 | REST 标识符 |
---|---|---|
成功的通知数 |
所有成功的通知的计数。 |
outgoing.allpns.success |
有效负载错误数 |
因为 PNS 返回了“有效负载不正确”错误而失败的推送的计数。 |
outgoing.allpns.invalidpayload |
外部通知系统错误数 |
因为与 PNS 通信时遇到问题(不包括身份验证问题)而失败的推送的计数。 |
outgoing.allpns.pnserror |
通道错误数 |
因通道无效、未与正确的应用程序关联、受到限流或已过期而失败的推送的计数。 |
outgoing.allpns.channelerror |
坏通道或已过期通道错误数 |
因为注册中的通道/令牌/registrationId 已过期或无效而失败的推送的计数。 |
outgoing.allpns.badorexpiredchannel |
Windows 通知服务 (WNS)
可以通过 WNS 选项卡上的“选择指标”菜单访问 WNS 指标。
下表指的是 WNS 和 Windows Live ( 服务可用于使用 WNS) 对应用进行身份验证的可能结果。
指标 | 说明 | REST 标识符 |
---|---|---|
WNS 成功的通知数 |
所有成功的通知的计数。 |
outgoing.wns.success |
WNS 授权错误数(凭据无效) |
因为 PNS 未接受所提供的凭据或者凭据被阻止而失败的推送的计数。 (Windows Live 不能识别凭据)。 |
outgoing.wns.invalidcredentials |
WNS 坏通道错误 |
因为注册中的 ChannelURI 不可识别(WNS 状态:404 找不到)而失败的推送的计数。 |
outgoing.wns.badchannel |
WNS 已过期通道错误 |
因为 ChannelURI 已过期(WNS 状态:410 不存在)而失败的推送的计数。 |
outgoing.wns.expiredchannel |
WNS 受限的通知数 |
因为 WNS 限制了此应用(WNS 状态:406 不可接受)而失败的推送的计数。 |
outgoing.wns.throttled |
WNS 授权错误数(无法访问) |
无法访问 Windows Live。 |
outgoing.wns.tokenproviderunreachable |
WNS 授权错误数(令牌无效) |
提供给 WNS 的令牌无效(WNS 状态:401 未经授权)。 |
outgoing.wns.invalidtoken |
WNS 授权错误数(令牌错误) |
提供给 WNS 的令牌有效,但对于另一个应用程序 (WNS 状态:403 禁止) 。 如果注册中的 ChannelURI 与另一应用相关联,则可能会发生此情况。 请检查客户端应用是否与其凭据位于通知中心内的同一应用相关联。 |
outgoing.wns.wrongtoken |
WNS 无效的通知格式 |
通知格式无效(WNS 状态:400)。 请注意,WNS 并不会拒绝所有无效的有效负载。 |
outgoing.wns.invalidnotificationformat |
WNS 无效通知大小错误 |
通知有效负载太大(WNS 状态:413)。 |
outgoing.wns.invalidnotificationsize |
WNS 通道受限 |
通知因为注册中的 ChannelURI 受限而被丢弃(WNS 响应标头:X-WNS-NotificationStatus:channelThrottled)。 |
outgoing.wns.channelthrottled |
WNS 通道断开连接 |
通知因为注册中的 ChannelURI 受限而被丢弃(WNS 响应标头:X-WNS-DeviceConnectionStatus: disconnected)。 |
outgoing.wns.channeldisconnected |
WNS 丢弃的通知数 |
通知因为注册中的 ChannelURI 受限而被丢弃(X-WNS-NotificationStatus 为 “dropped”,而不是 X-WNS-DeviceConnectionStatus “disconnected”)。 |
outgoing.wns.dropped |
WNS 错误数 |
与 WNS 通信时发生错误,因而未传递通知。 |
outgoing.wns.pnserror |
WNS 身份验证错误数 |
因与 Windows Live 通信时出错、凭据无效或令牌错误而未传递通知。 |
outgoing.wns.authenticationerror |
Apple 推送通知服务 (APNS)
可以通过 APNS 选项卡上的“选择指标”菜单访问 APNS 指标。
下表引用 APNS 的可能结果。
指标 | 说明 | REST 标识符 |
---|---|---|
APNS 成功的通知数 |
所有成功的通知的计数。 |
outgoing.apns.success |
APNS 授权错误数 |
因 PNS 不接受提供的凭据或凭据被阻止而失败的推送的计数。 |
outgoing.apns.invalidcredentials |
APNS 坏通道错误 |
因令牌无效而失败的推送的计数(APNS 状态代码:8)。 |
outgoing.apns.badchannel |
APNS 已过期通道错误 |
由 APNS 反馈通道致其无效的令牌的计数。 |
outgoing.apns.expiredchannel |
APNS 无效通知大小错误 |
因有效负载太大而失败的推送的计数(APNS 状态代码:7)。 |
outgoing.apns.invalidnotificationsize |
APNS 错误数 |
因为与 APNS 通信时发生错误而失败的推送的计数。 |
outgoing.apns.pnserror |
Google Cloud Messaging (GCM)
可以通过 GCM 选项卡上的“选择指标”菜单访问 GCM 指标。
下表引用了GCM可能的结果。
指标 | 说明 | REST 标识符 |
---|---|---|
GCM 成功的通知数 |
所有成功的通知的计数。 |
outgoing.gcm.success |
GCM 授权错误数(凭据无效) |
因为 PNS 未接受所提供的凭据或者凭据被阻止而失败的推送的计数。 |
outgoing.gcm.invalidcredentials |
GCM 坏通道错误 |
因为注册中的 registrationId 不可识别而失败的推送的计数(GCM 结果:无效的注册)。 |
outgoing.gcm.badchannel |
GCM 已过期通道错误 |
因为注册中的 registrationId 已过期而失败的推送的计数(GCM 结果:NotRegistered)。 |
outgoing.gcm.expiredchannel |
GCM 受限的通知数 |
由于GCM限制此应用而失败的推送计数 (GCM状态代码:501-599 或 result:不可用) 。 |
outgoing.gcm.throttled |
GCM 无效的通知格式 |
因为有效负载的格式不正确而失败的推送的计数(GCM 结果:InvalidDataKey 或 InvalidTtl)。 |
outgoing.gcm.invalidnotificationformat |
GCM 无效通知大小错误 |
因有效负载太大而失败的推送的计数(GCM 结果:MessageTooBig)。 |
outgoing.gcm.invalidnotificationsize |
GCM 通道不正确错误 |
因为注册中的 registrationId 没有关联到当前应用而失败的推送的计数(GCM 结果:InvalidPackageName)。 |
outgoing.gcm.wrongchannel |
GCM 错误数 |
因为与 GCM 通信时发生错误而失败的推送的计数。 |
outgoing.gcm.pnserror |
GCM 身份验证错误数 |
由于 PNS 不接受提供的凭据、凭据被阻止或发送方 Id 未在应用中正确配置结果而失败的推送计数 (GCM结果:MismatchedSenderId) 。 |
outgoing.gcm.authenticationerror |
Windows Phone 推送通知 (MPNS)
可以通过 MPNS 选项卡上的“选择指标”菜单访问 MPNS 指标。
下表引用 了 MPNS 的可能结果。
指标 | 说明 | REST 标识符 |
---|---|---|
MPNS 成功的通知数 |
所有成功的通知的计数。 |
outgoing.mpns.success |
MPNS 无效的凭据 |
因 PNS 不接受提供的凭据或凭据被阻止而失败的推送的计数。 |
outgoing.mpns.invalidcredentials |
MPNS 坏通道错误 |
因为注册中的 ChannelURI 不可识别(MPNS 状态:404 找不到)而失败的推送的计数。 |
outgoing.mpns.badchannel |
MPNS 受限的通知数 |
因为 MPNS 限制了此应用(WNS MPNS:406 不可接受)而失败的推送的计数。 |
outgoing.mpns.throttled |
MPNS 无效的通知格式 |
因通知的有效负载太大而失败的推送的计数。 |
outgoing.mpns.invalidnotificationformat |
MPNS 通道断开连接 |
因为注册中的 ChannelURI 断开连接(MPNS 状态:412 找不到)而失败的推送的计数。 |
outgoing.mpns.channeldisconnected |
MPNS 丢弃的通知数 |
MPNS 丢弃的推送的计数(MPNS 响应标头:X-NotificationStatus:QueueFull 或 Suppressed)。 |
outgoing.mpns.dropped |
MPNS 错误数 |
因为与 MPNS 通信时发生错误而失败的推送的计数。 |
outgoing.mpns.pnserror |
MPNS 身份验证错误数 |
因 PNS 不接受提供的凭据或凭据被阻止而失败的推送的计数。 |
outgoing.mpns.authenticationerror |