# 查询时序质量指标 (/zh-CN/api-reference/api-ref/agora-analytics/insight-quality-time) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 按分钟、小时或天的时间粒度获取指定时间范围内的质量指标,包括加入频道成功率、5s 加入频道成功率、音频卡顿率、视频卡顿率、网络延迟率。 - OpenAPI: /openapi/agora-analytics/analytics-rest-api.zh-CN.yaml - Operation ID: get-beta-insight-quality-by_time - Method: GET - Path: /beta/insight/quality/by_time - Endpoint: https://api.sd-rtn.com/beta/insight/quality/by_time ## Servers - https://api.sd-rtn.com ## Authorization This endpoint requires authentication. - `Authorization` ## Parameters - `startTs` (query, required, number) - 查询的时间范围起点,Unix 时间戳(秒)。响应中会包含起点所在的时间窗口。 - `endTs` (query, required, number) - 查询的时间范围终点,Unix 时间戳(秒)。响应中不会包含终点所在的时间窗口。 - `appid` (query, required, string) - 你的项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。 - `metric` (query, required, string) - 要查询的指标,支持设为以下值: - `joinSuccessRate`:加入频道成功率。 - `joinSuccessIn5sRate`:5s 内加入频道成功率。 - `audioFreezeRate`:音频卡顿率。 - `videoFreezeRate`:视频卡顿率。 - `networkDelay` :网络延迟率。 - `aggregateGranularity` (query, required, string) - 返回数据的粒度,支持设为以下值: - `1d`:按天。此时返回查询时间范围内以 UTC 时间为零点起始的一整天的数据。 - `1h`:按小时。此时返回查询时间范围内 UTC 时间为整小时的数据。 - `productType` (query, required, string) - 要查询的产品类型,支持设为以下值: - `Native`:指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。 - `WebRTC`:指 Web 平台的声网 RTC SDK。 ## Request body No request body. ## Responses ### 200 OK - `code` (number) - 响应状态码。200 表示请求成功,详见[响应状态码](/zh-CN/realtime-media/usage-analytics/reference/response-code)。 - `message` (string) - 错误消息。 - `data` (array) - `data.items` (object) - `data.items.networkDelay` (number) - 请求的指标名称,此处示例为网络延迟率。 - `data.items.ts` (number) - Unix 时间戳(秒)。 ## Response examples ### 200 ```json { "code": 200, "message": "success", "data": [ { "networkDelay": 0.064762, "ts": 1625097600 }, { "networkDelay": 0.028156, "ts": 1625101200 }, { "networkDelay": 0.03765, "ts": 1625184000 } ] } ```