查询日志直方图
功能介绍
查询关键词搜索条数该接口用于查询日志在某一时间段内，包含关键词的日志上报情况和日志条数统计结果。
URI
POST /v2/{project_id}/lts/keyword-count
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID，获取方式请参见：获取项目ID，获取账号ID，日志组ID、日志流ID 最小长度：32 最大长度：32 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 从IAM服务获取的用户Token，获取方式请参见：获取用户Token 最小长度：1000 最大长度：2000 |
| Content-Type | 是 | String | 该字段填为：application/json;charset=UTF-8。 最小长度：30 最大长度：30 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| start_time | 是 | Long | 开始时间，毫秒级时间戳 |
| end_time | 是 | Long | 结束时间，毫秒级时间戳 |
| step_interval | 是 | Long | 时间步长，单位为毫秒（ms）。 具体请参考如下公式计算： (end_time-start_time) / 1000 * 1000 / 60，其中 / 1000 * 1000 / 表示取整。 说明： 如果计算出的时间步长小于等于1000时，则时间步长为1000。 |
| group_id | 是 | String | 日志组ID 最小长度：36 最大长度：36 |
| stream_id | 是 | String | 日志流ID 最小长度：36 最大长度：36 |
| key_word | 是 | String | 查询语句。 |
| is_iterative | 否 | Boolean | 日志迭代查询，默认为false（不开启迭代），true为开启迭代。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Long | 日志条数 |
| histogram | Map<String,HistogramResponseBody> | 直方图结果 |
| isQueryComplete | Boolean | 是否查询完成 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Long | 日志总条数。 |
| histogram | histogram object | 日志直方图。 |
| isQueryComplete | Boolean | 是否查询完成。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| num | Long | 单个时间区间的日志条数。 |
| startTime | Long | 单个时间区间的开始时间，毫秒级时间戳。 |
| endTime | Long | 单个时间区间的结束时间，毫秒级时间戳。 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 调用失败响应信息描述。 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 调用失败响应信息描述。 |
请求示例
查询日志直方图
POST https://{endpoint}/v2/{project_id}/lts/keyword-count
{
"group_id" : "00330565-5baf-4e0d-bd16-ba0c6b951d9a",
"stream_id" : "715cda3b-e17f-492a-a6ca-98a1ba16ad8c",
"end_time" : 1637820813605,
"start_time" : 1637817213605,
"key_word" : "test",
"step_interval" : 60000
} 响应示例
状态码：200
查询直方图数据请求响应成功
{
"count" : 1,
"histogram" : [ {
"num" : 1,
"startTime" : 1637821594579,
"endTime" : 1637821595000
}, {
"num" : 0,
"startTime" : 1637821654000,
"endTime" : 1637821654579
} ],
"isQueryComplete" : true
} 状态码：400
BadRequest 非法请求建议根据error_msg直接修改该请求。
{
"error_code" : "LTS.0601",
"error_msg" : "params validator error"
} 状态码：500
InternalServerError。 表明服务端能被请求访问到，但是服务内部出错。
{
"error_code" : "LTS.0202",
"error_msg" : "Internal Server Error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询直方图数据请求响应成功 |
| 400 | BadRequest 非法请求建议根据error_msg直接修改该请求。 |
| 500 | InternalServerError。 表明服务端能被请求访问到，但是服务内部出错。 |
错误码
请参见错误码。
