nla 数据统计¶

POST 查询高级监控数据¶

POST /prod-api/nlaV1/statistic/describeMostData

Body 请求参数

{
  "action": [
    {
      "metricName": "oid",
      "pageNo": 1,
      "pageSize": 5
    },
    {
      "metricName": "client_ip",
      "pageNo": 1,
      "pageSize": 5
    },
    {
      "metricName": "http_user_agent",
      "pageNo": 1,
      "pageSize": 5
    },
    {
      "metricName": "domain",
      "pageNo": 1,
      "pageSize": 5
    }
  ],
  "otherFilter": [],
  "params": {
    "beginTime": "2026-05-12 16:49:56",
    "endTime": "2026-05-15 16:49:56"
  }
}

请求参数¶

名称	位置	类型	必选	中文名	说明
Authorization	header	string	是		-
body	body	object	是		-
» action	body	[object]	是		-
»» metricName	body	string	是	metricName	统计维度，与返回 `data[].metricName` 一致；取值见下文「`metricName` 取值一览」。
»» pageNo	body	integer(int32)	是		-
»» pageSize	body	integer(int32)	是		-
» otherFilter	body	[StatisticOtherFilterVO]	否	筛选条件	-
»» StatisticOtherFilterVO	body	StatisticOtherFilterVO	否	StatisticOtherFilterVO	-
»»» oneVal	body	string	否	搜索名称	见下文「`oneVal` 常用取值（筛选维度）」。
»»» threeVal	body	[string]	否		-
»»» twoVal	body	string	否	等于或者不等于	`eq` 等于；`ne` 不等于；见下文「`otherFilter[]`」。
» pageNum	body	integer(int32)	否	当前页数	-
» pageSize	body	integer(int32)	否	每页显示条目个数	-
» params	body	object	否		-

Body 请求参数字段说明

字段名称	类型	说明
`action`	数组	要查询的指标与分页配置列表；每一项对应一次独立统计（见下表「`action[]`」）。
`otherFilter`	数组	附加筛选条件列表；每一项为一条筛选条件（见下表「`otherFilter[]`」）。无筛选时传 `[]`。
`params`	对象	公共查询参数，本接口至少需要统计时间范围（见下表）。

action[]（每一项）

字段名称	类型	说明
`metricName`	string	统计维度标识，与返回中 `data[].metricName` 一致。取值见下表「`metricName` 取值一览」，须与下表取值列完全一致（区分大小写）。
`pageNo`	number	该指标下列表的分页页码，从 `1` 开始。
`pageSize`	number	该指标下每页条数。

`metricName` 取值一览¶

以下为「高级监控 / 榜单类」统计支持的维度（与控制台各榜单对应）；返回中 list[].name 为该维度下的展示名或原始值（如 IP、域名、UA 原文等）。

`metricName`	含义说明
`oid`	套餐
`client_ip`	来源 IP
`http_user_agent`	HTTP `User-Agent`
`domain`	访问域名
`url`	URL
`status`	HTTP 状态码
`request_method`	请求方法
`ua_os_name`	操作系统（由 UA 解析）
`ua_name`	浏览器（由 UA 解析）
`client_country_name`	国家/地区
`client_city_name`	城市
`action`	处置动作（与控制台「动作」类榜单一致）
`server_port`	访问端口（部分控制台版本未展示该榜单；是否可查、是否有数据以实现为准）

otherFilter[]（每一项）

otherFilter 为对象数组：每个元素表示一条筛选条件；多条条件如何组合（与/或）以实现为准。单条元素为如下结构（示例表示：按套餐 oid 等于 22 过滤）：

{
  "oneVal": "oid",
  "twoVal": "eq",
  "threeVal": ["22"]
}

字段名称	类型	说明
`oneVal`	string	筛选维度（字段名），如 `oid` 表示套餐、`domain` 表示域名等；常用取值见下文「`oneVal` 常用取值（筛选维度）」。
`twoVal`	string	比较方式：`eq` 表示等于；`ne` 表示不等于。
`threeVal`	string[]	比较值列表，与 `oneVal`、`twoVal` 搭配使用；上例即「`oid` 等于列表中的 `22`」。多值语义以实现为准（如任一命中、全部命中等）。

带 otherFilter 的完整 Body 示例（在上方「无筛选」示例基础上增加筛选）：

{
  "action": [
    {
      "metricName": "client_ip",
      "pageNo": 1,
      "pageSize": 5
    }
  ],
  "otherFilter": [
    {
      "oneVal": "oid",
      "twoVal": "eq",
      "threeVal": ["22"]
    }
  ],
  "params": {
    "beginTime": "2026-05-12 16:49:56",
    "endTime": "2026-05-15 16:49:56"
  }
}

params（时间范围）

字段名称	类型	说明
`beginTime`	string	统计开始时间，格式与示例一致（`YYYY-MM-DD HH:mm:ss`）。
`endTime`	string	统计结束时间，需不早于 `beginTime`。

`oneVal` 常用取值（筛选维度）¶

`oneVal`	含义
`oid`	套餐
`client_ip`	来源 IP
`domain`	域名
`url`	URL
`status`	状态码
`request_method`	请求方法
`server_port`	端口
`ua_os_name`	操作系统
`ua_name`	浏览器
`rule_tags`	规则标签
`client_country_name`	国家/地区
`client_city_name`	城市
`waf_acl_id`	策略组
`rule_Id`	规则 ID

（其它用于 otherFilter.oneVal 的筛选维度以实现与控制台为准。）

返回示例

200 Response

{
  "msg": "成功",
  "code": 200,
  "data": [
    {
      "metricName": "oid",
      "list": [],
      "total": 0,
      "termsCount": 0
    },
    {
      "metricName": "client_ip",
      "list": [
        { "name": "20.197.195.237", "value": 121 },
        { "name": "142.248.80.72", "value": 17 },
        { "name": "47.251.93.227", "value": 3 },
        { "name": "8.209.96.179", "value": 3 },
        { "name": "35.94.160.85", "value": 2 }
      ],
      "total": 146,
      "termsCount": 5
    },
    {
      "metricName": "http_user_agent",
      "list": [
        { "name": "", "value": 121 },
        { "name": "quic-go HTTP/3", "value": 6 },
        {
          "name": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3 Safari/605.1.15",
          "value": 2
        },
        {
          "name": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36 Edg/147.0.0.0",
          "value": 2
        },
        {
          "name": "Mozilla/5.0 (X11; Linux x86_64; rv:149.0) Gecko/20100101 Firefox/149.0",
          "value": 2
        }
      ],
      "total": 146,
      "termsCount": 17
    },
    {
      "metricName": "domain",
      "list": [
        { "name": "lwtest.ruisuyun.com", "value": 140 },
        { "name": "38.47.50.157", "value": 3 },
        { "name": "38.47.50.35", "value": 3 }
      ],
      "total": 146,
      "termsCount": 3
    }
  ]
}

返回结果¶

状态码	状态码含义	说明	数据模型
200	OK	OK	Inline
201	Created	Created	-
401	Unauthorized	Unauthorized	-
403	Forbidden	Forbidden	-
404	Not Found	Not Found	-

返回数据结构¶

状态码 200

名称	类型	必选	约束	中文名	说明
» additionalProperties	object	false	-		-

数据模型¶

StatisticOtherFilterVO

{
  "oneVal": "string",
  "threeVal": ["string"],
  "twoVal": "string"
}

StatisticOtherFilterVO

属性¶

名称	类型	必选	约束	中文名	说明
oneVal	string	false	-	搜索名称	取值含义见上文「`oneVal` 常用取值（筛选维度）」。
threeVal	[string]	false	-		-
twoVal	string	false	-	等于或者不等于	取值有： eq：表示等于 ne：表示不等于

nla 数据统计¶

POST 查询高级监控数据¶

请求参数¶

metricName 取值一览¶

oneVal 常用取值（筛选维度）¶

返回结果¶

返回数据结构¶

数据模型¶

StatisticOtherFilterVO

属性¶

`metricName` 取值一览¶

`oneVal` 常用取值（筛选维度）¶