功能描述
本接口用于根据指定的条件搜索日志内容。
请求
请求示例
GET /searchlog?logset_id=xxxx-xx-xx-xx-xxxxxxxx&topic_ids=xxxx&start_time=2017-08-22+10%3A10%3A10&end_time=2017-08-23+10%3A10%3A10&query_string=&limit=10&context= HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>
请求行
GET /searchlog
请求头
除公共头部外,无特殊请求头部。
请求参数
字段名 | 类型 | 位置 | 必须 | 含义 |
---|---|---|---|---|
logset_id | string | query | 是 | 要查询的 logset ID |
topic_ids | string | query | 是 | 要查询的 topic ID |
start_time | string | query | 是 | 要查询的日志的起始时间,格式 YYYY-mm-dd HH:MM:SS |
end_time | string | query | 是 | 要查询的日志的结束时间,格式 YYYY-mm-dd HH:MM:SS |
query_string | string | query | 是 | 查询语句,详情参考 检索语法与规则 |
limit | int | query | 是 | 单次要返回的日志条数,单次返回的最大条数为100 |
context | string | query | 否 | 加载更多使用,透传上次返回的 context 值,获取后续的日志内容,通过游标最多可获取10000条,请尽可能缩小时间范围 |
sort | string | query | 否 | 按时间排序 asc(升序)或者 desc(降序),默认为 desc |
响应
响应示例
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 53
{
"context": "abcdefg",
"listover": false,
"results": [
{
"timestamp": "2017-07-14 20:43:00",
"topic_id": "xxxx-xx-xx-xx-xxxxxxxx",
"topic_name": "xxxxxxx",
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
{
"timestamp": "2017-07-14 20:42:00",
"topic_id": "xxxx-xx-xx-xx-xxxxxxxx",
"topic_name": "xxxxxxx",
"content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
]
}
响应头
除公共响应头部外,无特殊响应头部。
响应参数
字段名 | 类型 | 必有 | 含义 |
---|---|---|---|
context | string | 是 | 获取更多检索结果的游标 |
listover | bool | 是 | 搜索结果是否已经全部返回 |
results | JsonArray(LogObject) | 是 | 日志内容信息 |
LogObject 格式如下:
字段名 | 类型 | 必有 | 含义 |
---|---|---|---|
topic_id | string | 是 | 日志属于的 topic ID |
topic_name | string | 是 | 日志主题的名字 |
timestamp | string | 是 | 日志时间 |
content | string | 是 | 日志内容 |
filename | string | 是 | 采集路径 |
source | string | 是 | 日志来源设备 |
错误码
请参见 错误码。