本页介绍可在 DNS analytics API 请求中使用的 API 属性。
指标是基于数据属性的数值，例如查询计数。
在 API 请求中，指标通过 metrics 参数设置。如果需要列出多个指标，请用逗号分隔。
| Metric | Name | Example | Unit |
|---|---|---|---|
| queryCount | 查询计数 | 1000 |
Count |
| uncachedCount | 未缓存查询计数 | 1 |
Count |
| staleCount | 过期查询计数 | 1 |
Count |
| responseTimeAvg | 平均响应时间 | 1.0 |
时间（毫秒） |
| responseTimeMedian | 中位数响应时间 | 1.0 |
时间（毫秒） |
| responseTime90th | 第 90 百分位响应时间 | 1.0 |
时间（毫秒） |
| responseTime99th | 第 99 百分位响应时间 | 1.0 |
时间（毫秒） |
维度可用于按给定属性细分数据。
在 API 请求中，维度通过 dimensions 参数设置。如果需要列出多个维度，请用逗号分隔。
| Dimension | Name | Example | Notes |
|---|---|---|---|
| queryName | 查询名称 | example.com |
|
| queryType | 查询类型 | AAAA |
IANA 定义的类型 ↗。未知类型为空。 |
| responseCode | 响应代码 | NOERROR |
IANA 定义的响应代码 ↗。始终为大写。 |
| responseCached | 响应是否缓存 | Cached |
为 Cached 或 Uncached。 |
| coloName | Colo 名称 | SJC |
PoP 代码。 |
| origin | 源站 | 2001:db8::1 |
用于解析查询的源站。不适用或查询从缓存应答时为空。 |
| dayOfWeek | 星期几 | 1 |
按星期几细分。周一为 1，周日为 7。 |
| tcp | TCP | 1 |
根据使用的协议为 1 或 0。 |
| ipVersion | IP 版本 | 6 |
使用的 IP 协议版本（当前为 4 或 6）。 |
| querySizeBucket | 查询大小分桶 | 16-31 |
按 16 的倍数划分的查询大小分桶。 |
| responseSizeBucket | 响应大小分桶 | 16-31 |
按 16 的倍数划分的响应大小分桶。 |
筛选器采用 dimension operator expression 形式，各部分对应如下：
- Dimension（维度）：指定要筛选的维度。例如
queryName。 - Operator：定义要使用的筛选匹配类型。运算符特定于维度。
- Expression（表达式）：声明要从结果中包含或排除的值。表达式使用正则表达式（regex）语法。
| Operator | 名称 | 示例 | 说明 | URL 编码 |
|---|---|---|---|---|
== |
等于 | queryName==example.com | 返回 queryName 完全等于 example.com 的结果。 |
%3D%3D |
!= |
不等于 | responseCode!=NOERROR | 返回 responseCode 与 NOERROR 不同的结果。 |
!%3D |
> |
大于 | dimension>1000 |
返回维度大于 1000 的结果。 |
%3E |
< |
小于 | dimension<1000 |
返回维度小于 1000 的结果。 |
%3C |
>= |
大于或等于 | dimension>=1000 |
返回维度大于或等于 1000 的结果。 |
%3E%3D |
<= |
小于或等于 | dimension<=1000 |
返回维度小于或等于 1000 的结果。 |
%3C%3D |
使用 OR 和 AND 布尔逻辑组合筛选器：
-
在所有表达式中，
AND的优先级高于OR。 -
OR运算符使用逗号,或前后带空格的OR关键字定义。 -
AND运算符使用分号;或前后带空格的AND关键字定义。
使用 OR 的示例
responseCode==NOERROR,responseCode==NXDOMAIN表示响应代码为NOERROR或NXDOMAIN。coloName==SJC OR coloName==LAX表示SJC或LAX中的查询。
使用 AND 的示例
responseCode==NOERROR;queryType==AAAA表示响应代码为NOERROR且查询类型为AAAA。queryType==AAAA AND coloName==SJC表示SJC中的AAAA查询。