调用DescribeFaultDiagnosisUserDetail获取异常诊断的用户详情。
使用说明
本接口用于获取异常诊断的概览数据。使用该接口时,支持查询最近48小时的数据。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /api/diagnosis/describeFaultDiagnosisUserDetail HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
AppId | String | Query | 是 | 0rbd**** |
App ID,可通过控制台创建和查询。 |
ChannelId | String | Query | 是 | 311 |
频道ID。 |
CreatedTs | Long | Query | 是 | 1615892596 |
创建频道的时间,使用UNIX时间戳表示,单位:秒。 |
UserId | String | Query | 是 | 0a497933**** |
用户ID。 |
FaultType | String | Query | 是 | JOIN_SLOW |
过滤的异常类型,取值:
关于异常类型详情,请参见异常类型说明。 |
QueryCallUserInfo | Boolean | Query | 否 | true |
是否查询通话用户信息,参数为空表示false。 |
返回数据
影响因素ID取值如下所示:
ID |
描述 |
---|
ID |
描述 |
---|---|
1 |
发布端网络差。 |
2 |
订阅端网络差。 |
3 |
发布端设备性能差。 |
4 |
发布端关闭摄像头。 |
5 |
发布端切到后台运行。 |
6 |
发布端WiFi信号差。 |
7 |
订阅端WiFi信号差。 |
8 |
发布端CPU使用率高。 |
9 |
订阅端CPU使用率高。 |
10 |
DNS解析慢。 |
11 |
获取配置解析慢。 |
12 |
GSLB解析慢。 |
13 |
发布端网络延迟抖动。 |
14 |
发布端网丢包抖动。 |
15 |
发布端带宽低。 |
16 |
订阅端网络延迟抖动。 |
17 |
订阅端网络丢包抖动。 |
18 |
订阅端带宽低。 |
UNKNOWN |
未知。 |
示例
请求示例
POST /api/diagnosis/describeFaultDiagnosisUserDetail?AppId=0rbd****&ChannelId=311&CreatedTs=1615892596&UserId=0a497933****&FaultType=JOIN_SLOW&QueryCallUserInfo=true HTTP/1.1
Host: vdc.cn-shenzhen.aliyuncs.com
Date: GMT Date
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeFaultDiagnosisUserDetailResponse>
<code>200</code>
<data>
<UserDetail>
<DestroyedTs>1620958150</DestroyedTs>
<Os>iOS</Os>
<UserId>0a497933****</UserId>
<Network>WiFi</Network>
<SdkVersion>2.2.2105081533277</SdkVersion>
<Duration>231</Duration>
<CreatedTs>1620957919</CreatedTs>
<OnlineDuration>231</OnlineDuration>
<OnlinePeriods>
<LeaveTs>1620958150</LeaveTs>
<JoinTs>1620957919</JoinTs>
</OnlinePeriods>
<Location>浙江省-杭州市</Location>
</UserDetail>
<FactorList>
<RelatedMetricDatas>
<Role>RECEIVER</Role>
<Type>AUDIO_STUCK</Type>
<UserId>0a497933****</UserId>
<Nodes>
<X>1620957937</X>
<Y>529.39</Y>
</Nodes>
<Nodes>
<X>1620957953</X>
<Y>359.99</Y>
</Nodes>
</RelatedMetricDatas>
<RelatedMetricDatas>
<Role>RECEIVER</Role>
<Type>AUDIO_RTT</Type>
<UserId>0a497933****</UserId>
<Nodes>
<X>1620957937</X>
<Y>323.5</Y>
</Nodes>
<Nodes>
<X>1620957939</X>
<Y>1002</Y>
</Nodes>
</RelatedMetricDatas>
<FactorId>2</FactorId>
</FactorList>
<RequestId>1DB846A6-969D-4873-B592-B4A8D1CA3294</RequestId>
<CallInfo>
<DestroyedTs>1620958150</DestroyedTs>
<AppId>0rbd****</AppId>
<CallStatus>OUT</CallStatus>
<Duration>245</Duration>
<CreatedTs>1620957905</CreatedTs>
<ChannelId>311</ChannelId>
</CallInfo>
<FaultMetricData>
<Nodes>
<X>1620957900</X>
<Y>0.4540</Y>
</Nodes>
<Nodes>
<X>1620957960</X>
<Y>0.5175</Y>
</Nodes>
<Nodes>
<X>1620958020</X>
<Y>0.4775</Y>
</Nodes>
<Nodes>
<X>1620958080</X>
<Y>0.3375</Y>
</Nodes>
</FaultMetricData>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>1DB846A6-969D-4873-B592-B4A8D1CA3294</requestId>
<successResponse>true</successResponse>
</DescribeFaultDiagnosisUserDetailResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"code" : "200",
"data" : {
"UserDetail" : {
"DestroyedTs" : 1620958150,
"Os" : "iOS",
"UserId" : "0a497933****",
"Network" : "WiFi",
"SdkVersion" : "2.2.2105081533277",
"Duration" : 231,
"CreatedTs" : 1620957919,
"OnlineDuration" : 231,
"OnlinePeriods" : [ {
"LeaveTs" : 1620958150,
"JoinTs" : 1620957919
} ],
"Location" : "浙江省-杭州市"
},
"FactorList" : [ {
"RelatedMetricDatas" : [ {
"Role" : "RECEIVER",
"Type" : "AUDIO_STUCK",
"UserId" : "0a497933****",
"Nodes" : [ {
"X" : "1620957937",
"Y" : "529.39"
}, {
"X" : "1620957953",
"Y" : "359.99"
} ]
}, {
"Role" : "RECEIVER",
"Type" : "AUDIO_RTT",
"UserId" : "0a497933****",
"Nodes" : [ {
"X" : "1620957937",
"Y" : "323.5"
}, {
"X" : "1620957939",
"Y" : "1002"
} ]
} ],
"FactorId" : "2"
} ],
"RequestId" : "1DB846A6-969D-4873-B592-B4A8D1CA3294",
"CallInfo" : {
"DestroyedTs" : 1620958150,
"AppId" : "0rbd****",
"CallStatus" : "OUT",
"Duration" : 245,
"CreatedTs" : 1620957905,
"ChannelId" : "311"
},
"FaultMetricData" : {
"Nodes" : [ {
"X" : "1620957900",
"Y" : "0.4540"
}, {
"X" : "1620957960",
"Y" : "0.5175"
}, {
"X" : "1620958020",
"Y" : "0.4775"
}, {
"X" : "1620958080",
"Y" : "0.3375"
} ]
}
},
"httpStatusCode" : "200",
"requestId" : "1DB846A6-969D-4873-B592-B4A8D1CA3294",
"successResponse" : true
}