GetProjectLogs - 日志服务

接口说明

该接口的query是一个标准的SQL查询语句。
查询的Project在请求的域名中指定。
查询的Logstore在查询语句的from条件中指定。可以将Logstore看做是SQL中的表。
在查询的SQL条件中必须指定要查询的时间范围，时间范围由__date__（Timestamp类型）或__time__（Integer类型，单位是秒）来指定。

请求语法

GET /logs query=SELECT avg(latency) as avg_latency FROM  where __date__ >'2017-09-01 00:00:00' and __date__ < '2017-09-02 00:00:00'
Authorization: LOG yourAccessKeyId:yourSignature
Date: Wed, 3 Sept. 2014 08:33:46 GMT
Host: Projectname.endpoint
x-log-bodyrawsize: 0
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

其中，Host由Project名称和日志服务Endpoint构成，您需要在Host中指定Project。

请求参数

请求头
GetProjectLogs接口无特有请求头。关于Log Service API的公共请求头，请参见公共请求头。

参数列表


参数名称	数据类型	是否必填	示例值	描述
projectName	String	是	big-game	Project名称。
query	String	是	* \| SELECT * FROM `logStoreName` where __line__ = 'error' and __date__ >'2014-09-01 00:00:00' and __date__ < '2014-09-01 22:00:00	SQL语句，表示查询时间区间为2014-09-01 00:00:00到2014-09-01 22:00:00，关键字为error的日志数据。

返回数据

响应头

关于Log Service API的公共响应头，请参见公共响应头。该接口特有的响应头如下表所示。


参数名称	数据类型	示例值	描述
x-log-progress	String	Complete	查询结果的状态，包括： Complete：查询已经完成，返回结果为完整结果。 Incomplete：查询已经完成，返回结果为不完整结果，需要重复请求以获得完整结果。
x-log-count	Integer	10000	当前查询结果的日志总数。
x-log-processed-rows	Integer	10000	本次查询处理的行数。
x-log-elapsed-millisecond	Integer	5	本次查询消耗的毫秒时间。

响应元素

GetProjectLogs的响应body是一个数组，数组中每个元素是一条日志结果。


参数名称	数据类型	示例值	描述
__time__	Integer	1409529660	日志的时间戳，精度为秒，从1970-1-1 00:00:00 UTC开始计算的秒数。
__source__	String	192.168.1.100	日志的来源，写入日志时指定。
content	Array	"Key3": "error", "Key4": "Value4"	日志原始内容。

示例

以杭州地域内名为big-game的Project为例，查询该Project内名为app_log的Logstore中，主题为groupA的日志数据。查询区间为2014-09-01 00:00:00到2014-09-01 22:00:00，查询关键字为error的日志数据。

请求示例

GET /logs/?query=SELECT * FROM logStoreName where __line__ = 'error' and __date__ >'2014-09-01 00:00:00' and __date__ < '2014-09-01 22:00:00'&line=20&offset=0 HTTP/1.1
Authorization: LOG yourAccessKeyId:yourSignature
Date: Wed, 3 Sept. 2014 08:33:46 GMT
Host: big-game.cn-hangzhou.log.aliyuncs.com
x-log-bodyrawsize: 0
x-log-apiversion: 0.4.0
x-log-signaturemethod: hmac-sha1

响应示例

HTTP/1.1 200 OK
Content-MD5: 36F9F7F0339BEAF571581AF1B0AAAFB5
Content-Type: application/json
Content-Length: 269
Date: Wed, 3 Sept. 2014 08:33:47 GMT
x-log-requestid: efag01234-12341-15432f
x-log-progress : Complete
x-log-count : 10000
x-log-processed-rows: 10000
x-log-elapsed-millisecond:5
{
    "progress": "Complete",
    "count": 2,
    "logs": [
        {
            "__time__": 1409529660,
            "__source__": "192.168.1.100",
            "Key1": "error",
            "Key2": "Value2"
        },
        {
            "__time__": 1409529680,
            "__source__": "192.168.1.100",
            "Key3": "error",
            "Key4": "Value4"
        }
    ]
}

响应示例中，x-log-progress的值为Complete，表明整个日志查询已经完成，返回结果为完整结果。本次请求共查询到2条符合条件的日志数据。如果响应结果中的x-log-progress的值为Incomplete，则需要重复请求以获得完整结果。

错误码


HTTP状态码	错误码	错误消息	描述
400	ParameterInvalid	Parameter is invalid.	请求的参数错误。

更多错误码，请参见通用错误码。