GetLogs

最近更新时间:2020-07-27 10:13:45

请求语法

POST /GetLogs HTTP/1.1
Authorization: <AuthorizationString>
x-klog-api-version: 0.1.0
Host: <Project Endpoint>
x-klog-signature-method: hmac-sha1
Date: <GMT Date>
Content-Type: application/json
Content-MD5: <Content-MD5>
Content-Length: <ContentLength>
Connection: Keep-Alive
{
  "ProjectName": <ProjectName>,
  "LogPoolName" : <logPoolName>,
}

请求参数

该接口无特有请求头。获取更多信息,请参见公共请求头。 参数详情具体如下表。

参数名称 类型 是否必须 描述
ProjectName String 项目名称
LogPoolName String 日志池名称
From Int 查询开始时间,unix时间戳
To Int 查询结束时间,unix时间戳
Query String 查询分析语法。关于查询分析的详细语法,详见查询语法,不填的情况下 返回原始日志

响应参数

  • 原始日志:如果为查询短语(非SQL),具体返回条数以 line参数为准,如果为SQL查询,原始日志返回10条。
  • 聚合日志:如果为SQL查询,需要将聚合结果返回。
参数名称 类型 描述
Time Int 查询结果总量,如简单短语查询有150w命中,该值为1500000
Count Int 本次查询返回结果数,如20
Logs List 是否为SQL
Keys List 返回所有的字段key
  • Log原始日志
参数名称 类型 描述
Key1 String key1为字段名,值为key1的值
... ... ...
Keyn String keyn为字段名,值为keyn的值

错误码

除公共错误码外,还可能返回如下特有错误码:

Http状态码 errorCode errorMessage
400 InvalidTimeRange Request time range is invalid
400 InvalidQueryString Query string is invalid
400 InvalidOffset Offset is invalid
400 InvalidLine line is invalid

示例

请求示例

POST /GetLogs HTTP/1.1
Authorization: KLOG <yourAccessKeyId>:<yourSignature>
x-klog-api-version: 0.6.0
Host: klog-cn-beijing-internal.ksyun.com
x-log-signature-method: hmac-sha1
Date: Sun, 27 May 2018 07:43:26 GMT
Content-Type: application/json
Content-MD5: A7967D81EFF5E3CD447FB6D8DF294E20
Content-Length: 80
Connection: Keep-Alive
{
  "ProjectName": “my-test-project”,
  "LogPoolName" : "my-test-logpool",
  "From": 1409529660,
  "To": 1409629660,
  "Query": "select * where key1=\"value\" limit 10"
}

响应示例

HTTP/1.1 200
Server: nginx
Content-Length: 0
Connection: close
Access-Control-Allow-Origin: *
Date: Sun, 27 May 2018 07:43:27 GMT
x-klog-requestid: 5B0A619F205DC3F30EDA9322
{
  "Total": 10000,
  "Count" : 1,
  "Logs": [
    {
        "__timestamp__" : 1409529660,
        "__source__": "192.168.1.1",
        "Key1": "value1",
        "Key2": "value2"
    }
  ],
  "Keys": ["key3", "key4"]
}

金山云,开启您的云计算之旅

免费注册