查询分值分布
RUM 自定义字段
查询分值分布
按出现次数降序返回指定时间范围内某个分面字段的 Top N 值及其计数。
POST
查询分值分布
限制说明
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 1,000 次/分钟;50 次/秒 |
| 权限要求 | 无 —— 持有有效的 app_key 即可调用 |
使用说明
- 使用
POST /rum/facet/list发现每个 scope 下可用的facet_key值。 scope必须是以下之一:session、view、action、error、resource、long_task、vital、issue、sourcemap。- 传入
dql可在统计前进一步过滤事件,DQL 语法遵循 RUM 查询语言。 - 传入
sql可使用仅含 WHERE 子句(无 SELECT)的 SQL 风格过滤。 - 默认 limit 为 100,最大 100。
- 时间范围必填(
start_time/end_time为 Unix 毫秒时间戳),最大跨度 31 天。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
application/json
分面值分布统计的请求参数。
要查询的 RUM 数据 scope。
可用选项:
session, view, action, error, resource, long_task, vital, issue, sourcemap 要统计值分布的字段键。
时间范围起始,Unix 毫秒时间戳。
示例:
1712620800000
时间范围结束,Unix 毫秒时间戳。最大跨度 31 天。
示例:
1712707200000
设置后,统计前会先过滤 facet_key 等于该值的事件。接受字符串、数字或布尔值。
统计前应用的 RUM DQL 过滤表达式。
仅含 WHERE 子句(无 SELECT)的 SQL 附加过滤条件。
返回的最大 Top N 值数量。默认 100,最大 100。
必填范围:
x <= 100