备案控制台
文档
产品文档
输入文档关键字查找
首页 视频直播 开发参考 API参考 工具箱 查询直播流卡顿和断流问题

查询直播流卡顿和断流问题

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

调用DetectLiveStreamsStuckInfo查询直播流卡顿和断流问题。

使用说明

单次查询的时间跨度最长为2h，允许追溯的历史时间范围为近7天。

QPS限制

本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述
Action String 是 DetectLiveStreamsStuckInfo

系统规定参数。取值：DetectLiveStreamsStuckInfo。
StartTime String 是 2016-06-29T19:00:00Z

起始时间，UTC格式，开始时间不能晚于当前时间。
EndTime String 是 2016-06-30T19:00:00Z

结束时间，UTC格式，结束时间不能早于开始时间，且不能早于当前时间。
Url String 是 rtmp://example.com/App/StreamName

直播URL，支持rtmp、flv、hls协议。

返回数据

名称

类型

示例值

描述
RequestId String B955107D-E658-4E77-B913-E0AC3D31693E

请求ID。
Status String Success

任务状态。取值：

  • Success：成功。
  • Failed：失败。
BreakCode String 600001

断流状态码，取值如下：

  • 600001：给定时间段内未查询到直播流信息。
  • 600002：给定时段未查询断流异常信息。
  • 200000：给定时间段内该直播流存在断流行为。
  • -1：未查出工具已知异常，请提交工单排查 。
BreakDetail String {\"p-ql-pod033079087118.eu126_14********\":{\"codecInfo\":\"H264-High 1280x720 25 1 0/AAC-HE 44100 2 1 125\",\"publish_stop_time\":\"2024-01-24 15:08:21\",\"stream_id\":\"p-ql-pod033079087118.eu126_14036_73********\",\"push_error_code\":620002,\"fps\":\"25\",\"push_error\":\"客户端主动断开\",\"publish_start_time\":\"2024-01-24 04:03:03:470\"}}

断流诊断详情。
StuckCode String 200000

卡顿状态码，取值如下：

  • 600001：给定时间段内未查询到流信息。
  • 600003：给定时间段内未查询到卡顿异常信息。
  • 200000：给定时间段内查询到流且诊断有卡顿异常信息。
StuckDetail String {\"p-ql-pod033079087159.eu126_22********\":[{\"push_type\":\"rtmp_live_source_pub\",\"field\":\"framerate\",\"stream_id\":\"p-ql-pod033079087159.eu126_22********\",\"count\":1,\"from\":\"eu126\",\"to\":\"livesource-ql-pod033******.eu126\",\"points\":[{\"start_time\":\"2024-01-24 04:02:52\",\"code\":600101,\"solution\":\"帧率发生突降，突降最低至0, 教育类直播容易发生拉流卡顿，请注意查看是否为教育类直播\",\"end_time\":\"2024-01-24 04:02:53\"}]}]}

卡顿诊断详情。
StuckCount Integer 1

卡顿次数。
BreakCount Integer 0

断流次数。

BreakDetail参数说明

名称

类型

示例

描述

codecInfo

String

H264-High 1280x720 30 1 2500/AAC-LC 48000 2 1 160

客户推流的Codec信息 。

stream_id

String

17.cn1576_888********

流ID 。

fps

String

30

帧率 。

push_error_code

int

620103

断流错误码，表示诊断出的断流类型 。详情可参见下方的断流错误码。

push_error

String

被断流接口踢掉

断流错误描述 。

publish_start_time

String

2022-02-22 12:02:09:472

推流开始时间 。

publish_stop_time

String

2022-02-22 12:03:33

推流结束时间 。

StuckDetail参数说明

名称

子参数

类型

示例

描述

count

-

int

14

异常统计次数

field

-

String

framerate

范围在[framerate, avconfig, avgap, timestamp]。分别表示：帧率，视频头，视频关键帧间隔，视频时间戳 。

from

-

String

42.120.55.132

推流上行节点 。

to

-

String

cn528

推流下行节点。

points

end_time

String

2022-06-12 13:03:49

卡顿结束时间 。

points

start_time

String

2022-06-12 13:03:20

卡顿开始时间 。

points

solution

String

帧率发生突变，该流帧率设定为25，其中突增最高至50，突降最低至0

帧率，视频头，关键帧间隔或者时间戳的突变说明 。

points

code

int

600100

卡顿错误码，表示诊断出的卡顿类型。详情可参见下方的卡顿错误码。

push_type

-

String

rtmp_live_proxy_pub

推流类型 。

stream_id

-

String

liverelay011171136142.et15_179********

流ID 。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DetectLiveStreamsStuckInfo
&StartTime=2016-06-29T19:00:00Z
&EndTime=2016-06-30T19:00:00Z
&Url=rtmp://example.com/App/StreamName
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetectLiveStreamsStuckInfoResponse>
    <RequestId>B955107D-E658-4E77-B913-E0AC3D31693E</RequestId>
    <Status>Success</Status>
    <BreakCode>600001</BreakCode>
    <BreakDetail>{\"p-ql-pod033079087118.eu126_14********\":{\"codecInfo\":\"H264-High 1280x720 25 1 0/AAC-HE 44100 2 1 125\",\"publish_stop_time\":\"2024-01-24 15:08:21\",\"stream_id\":\"p-ql-pod033079087118.eu126_14036_73********\",\"push_error_code\":620002,\"fps\":\"25\",\"push_error\":\"客户端主动断开\",\"publish_start_time\":\"2024-01-24 04:03:03:470\"}}</BreakDetail>
    <StuckCode>200000</StuckCode>
    <StuckDetail>{\"p-ql-pod033079087159.eu126_22********\":[{\"push_type\":\"rtmp_live_source_pub\",\"field\":\"framerate\",\"stream_id\":\"p-ql-pod033079087159.eu126_22********\",\"count\":1,\"from\":\"eu126\",\"to\":\"livesource-ql-pod033******.eu126\",\"points\":[{\"start_time\":\"2024-01-24 04:02:52\",\"code\":600101,\"solution\":\"帧率发生突降，突降最低至0, 教育类直播容易发生拉流卡顿，请注意查看是否为教育类直播\",\"end_time\":\"2024-01-24 04:02:53\"}]}]}</StuckDetail>
    <StuckCount>1</StuckCount>
    <BreakCount>0</BreakCount>
</DetectLiveStreamsStuckInfoResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B955107D-E658-4E77-B913-E0AC3D31693E",
  "Status" : "Success",
  "BreakCode" : 600001,
  "BreakDetail" : "{\\\"p-ql-pod033079087118.eu126_14********\\\":{\\\"codecInfo\\\":\\\"H264-High 1280x720 25 1 0/AAC-HE 44100 2 1 125\\\",\\\"publish_stop_time\\\":\\\"2024-01-24 15:08:21\\\",\\\"stream_id\\\":\\\"p-ql-pod033079087118.eu126_14036_73********\\\",\\\"push_error_code\\\":620002,\\\"fps\\\":\\\"25\\\",\\\"push_error\\\":\\\"客户端主动断开\\\",\\\"publish_start_time\\\":\\\"2024-01-24 04:03:03:470\\\"}}",
  "StuckCode" : 200000,
  "StuckDetail" : "{\\\"p-ql-pod033079087159.eu126_22********\\\":[{\\\"push_type\\\":\\\"rtmp_live_source_pub\\\",\\\"field\\\":\\\"framerate\\\",\\\"stream_id\\\":\\\"p-ql-pod033079087159.eu126_22********\\\",\\\"count\\\":1,\\\"from\\\":\\\"eu126\\\",\\\"to\\\":\\\"livesource-ql-pod033******.eu126\\\",\\\"points\\\":[{\\\"start_time\\\":\\\"2024-01-24 04:02:52\\\",\\\"code\\\":600101,\\\"solution\\\":\\\"帧率发生突降，突降最低至0, 教育类直播容易发生拉流卡顿，请注意查看是否为教育类直播\\\",\\\"end_time\\\":\\\"2024-01-24 04:02:53\\\"}]}]}",
  "StuckCount" : 1,
  "BreakCount" : 0
}

错误码

访问错误中心查看更多错误码。

卡顿错误码

code

描述

600100

帧率多次发生突降，且持续时间大于4s，多次突降最低至%s。该时间段每秒收帧数最高不超过5帧，容易造成拉流侧卡顿。

600101

帧率发生突降，突降最低至%s, 教育类直播容易发生拉流卡顿，请注意查看是否为教育类直播。

600102

接收间隔不稳定，当前接收最大间隔大于2000ms，当前值为%ms，容易造成拉流卡顿。

600103

视频时间戳和音频时间戳差值过大，容易造成音画不同步，其中差值最高为%s，最低为%s。

600104

视频头不合规，视频头应该为1，当前值是%s。

断流错误码

code

描述

620101

客户侧调用ForbidLiveStream接口主动断流。

620104

客户端推流的chunk streamid太大。

620105

客户端推流的单帧超5MB。

620122

直播远程鉴权失败，回调接口返回403。

620121

直播远程鉴权失败，远程鉴权接口异常，请求超时。

620123

直播远程鉴权失败，回调接口鉴权失败。

620124

直播远程鉴权失败，回调接口鉴权失败。

620127

直播远程鉴权失败，回调接口鉴权失败。

620400

推流、拉流路数超限。

620401

鉴权失败。

620403

推流鉴权失败。

620402

同名流已经存在系统中，推流重复。

620405

同名流在禁止直播流黑名单中。

620407

推流QPS超限。

620408

该直播域名不允许中心推流，但该直播流异常时段采用中心推流方式推流。

620129

live拉流请求源站建联失败。

620130

live拉流请求源站写超时。

620131

live拉流请求源站写错误。

620133

live拉流请求源站读超时。

620134

live拉流请求源站主动中断请求。

620135

live拉流请求源站读错误。

620137

live拉流请求源站返回404状态码。

620138

live拉流请求源站非法响应行。

620139

live拉流请求源站非法响应头。

620140

live拉流请求源站帧长度过大。

620142

live拉流请求源站没有拿到音视频数据。

620143

live拉流请求源站重定向出错。

620144

live拉流请求源站返回403状态码。

620145

live拉流请求源站返回5xx状态码。

620146

live拉流请求源站返回其他异常状态码。

620147

live拉流请求源站提前检查发现读错误。

620148

live拉流请求源站提前检查发现写错误。

620149

live拉流请求源站重定向次数超过4次。

文档推荐
  • 本页导读 （1）
文档反馈