# 获取通话质量指标 (/zh-CN/api-reference/api-ref/agora-analytics/call-metrics)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

获取指定通话的质量指标数据。

- OpenAPI: /openapi/agora-analytics/analytics-rest-api.zh-CN.yaml
- Operation ID: get-beta-analytics-call-metrics
- Method: GET
- Path: /beta/analytics/call/metrics
- Endpoint: https://api.sd-rtn.com/beta/analytics/call/metrics

## Servers

- https://api.sd-rtn.com

## Authorization

This endpoint requires authentication.

- `Authorization`

## Parameters

- `start_ts` (query, required, number) - 查询的时间范围起点。Unix 时间戳（秒）。
- `end_ts` (query, required, number) - 查询的时间范围终点。Unix 时间戳（秒）。
- `appid` (query, required, string) - 你的项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。
- `call_id` (query, required, string) - 通话 ID，即通话的唯一标识。
- `sids` (query, required, string) - 请求的用户通话 sid 列表。最多可以指定 20 个 sid，多个 sid 用逗号隔开。

## Request body

No request body.

## Responses

### 200

OK

- `code` (number) - 响应状态码。200 表示请求成功，详见[响应状态码](/zh-CN/realtime-media/usage-analytics/reference/response-code)。
- `message` (string) - 错误消息。
- `requestId` (string) - 对应请求的 ID。
- `metrics` (array) - 各个用户通话（`sid`）的具体指标数据。
  - `metrics.items` (object)
    - `metrics.items.sid` (string) - 用户在该通话中的唯一标识。
    - `metrics.items.data` (array) - 用户通话的质量指标数据。
      - `metrics.items.data.items` (object)
        - `metrics.items.data.items.mid` (number) - 指标 ID。详见下表：
| `mid` | 描述                                     | 单位 | 举例       |
| ----- | ---------------------------------------- | ---- | ---------- |
| 20001 | App 的 CPU 使用率                        | %    | 27%        |
| 20002 | 系统 CPU 使用率                          | %    | 15%        |
| 20003 | 音频发送码率                             | Kbps | 126 Kbps   |
| 20004 | 音频接收码率                             | Kbps | 108 Kbps   |
| 20005 | 音频渲染卡顿时间                         | ms   | 106.67 ms  |
| 20006 | 视频小流发送码率                         | Kbps | 472 Kbps   |
| 20007 | 视频采集帧率                             | fps  | 16 fps     |
| 20008 | 视频大流发送帧率                         | fps  | 12 fps     |
| 20009 | 视频大流接收码率                          | Kbps | 309 Kbps   |
| 20030 | 视频小流接收码率                       | Kbps | 100 Kbps   |
| 20010 | 视频大流接收帧率                             | fps  | 6 fps      |
| 20031 | 视频小流接收帧率                             | fps  | 6 fps      |
| 20011 | 视频渲染卡顿时间                         | ms   | 2000.50 ms |
| 20015 | 音频上行丢包率                           | %    | 1%         |
| 20016 | 音频端到端丢包率                         | %    | 3%         |
| 20017 | 视频上行丢包率                           | %    | 5%         |
| 20018 | 视频端到端丢包率                         | %    | 7%         |
| 20019 | 视频大流接收分辨率的宽                       | px   | 360        |
| 20020 | 视频大流接收分辨率的高                       | px   | 640        |
| 20032 | 视频小流接收分辨率的宽                       | px   | 360        |
| 20033 | 视频小流接收分辨率的高                       | px   | 640        |
| 20021 | SDK 任务调度延迟                         | ms   | 2 ms       |
| 20022 | 客户端到本地路由器的往返时延（表征 Wi-Fi 信号质量）             | ms   | 3 ms       |
| 20023 | 视频小流发送帧率                         | fps  | 108 fps    |
| 20024 | 视频大流发送码率                         | Kbps | 126 Kbps   |
| 20025 | 采集音量                                 | dB   | 105 dB     |
| 20026 | 播放音量                                 | dB   | 98 dB      |
| 20027 | 视频大流发送分辨率的宽                       | px   | 360        |
| 20028 | 视频大流发送分辨率的高                       | px   | 640        |
| 20034 | 视频小流发送分辨率的宽                       | px   | 360        |
| 20035 | 视频小流发送分辨率的高                       | px   | 640        |
| 20036 | WebRTC 下行视频丢包率                       | /   | /        |
| 20037 | WebRTC 上行音频丢包率                       | /   | /        |
| 20038 | WebRTC 上行视频丢包率                       | /   | /        |
| 20039 | APP 内存占用                               | %    | 50%      |
| 20040 | 系统内存占用                               | %    | 70%      |
        - `metrics.items.data.items.kvs` (array) - 时间戳及相应时间的指标数值。
        - `metrics.items.data.items.peer_uid` (number) - 远端用户的 ID。如果为 `0`，表示收到的是本地用户的指标数据。

## Response examples

### 200

```json
{
  "code": 0,
  "message": "错误消息。",
  "requestId": "对应请求的 ID。",
  "metrics": [
    {
      "sid": "用户在该通话中的唯一标识。",
      "data": [
        {
          "mid": 0,
          "kvs": null,
          "peer_uid": 0
        }
      ]
    }
  ]
}
```