功能介绍

该接口用于查询不同维度（例如，集群、IP、应用等）下的日志内容，支持分页查询。

URI

POST /v1/{project_id}/als/action?type=querylogs

参数说明请参见表1。

请求消息

请求参数

{
"category": "app_*",
"searchKey":
{
"clusterId": "c693fa7c-54cd-11e8-8055-0255ac101e40",
"nameSpace": "",
"appName": "",
"podName": "",
"pathFile": "",
"hostIP":""
},
"keyWord": "",
"startTime": 1538970064983,
"endTime": 1538970364983,
"hideSyslog": 0
}

结构中的请求参数如表2所示。

Header说明

请求消息头（Header）如表4所示。

请求示例

/v1/{project_id}/als/action?type=querylogs
{  
    "category": "app_log",    
    "searchKey": 
              {
                "clusterId": "874819a2-bd6f-11e9-80be-0255ac1001b3"
              },
    "keyWord": "",
    "startTime": 1569463658895,
    "endTime": 1569463958895,
    "pageSize": 100,
    "hideSyslog": 0
}

示例2（分页查询）

/v1/{project_id}/als/action?type=querylogs
{  
    "category": "app_log",    
    "searchKey": 
              {
                "clusterId": "874819a2-bd6f-11e9-80be-0255ac1001b3"
              },
    "keyWord": "",
    "startTime": 1569463658895,
    "endTime": 1569463958895,
    "lineNum": "1569463911294010547",
    "type": "next",
    "size": 100,
    "hideSyslog": 0
}'

• 分页查询时需要增加三个参数：lineNum（上一次查询出的内容中最后一条日志的序列号）、type（取值"next"）和size。
• category、searchKey、keyWord、startTime、endTime等条件需要保持和第一次查询时相同。
• 如果需要继续分页查询，则修改请求参数中的lineNum为上次查询结果中最后一条日志的lineNum的值即可，以此类推。

响应消息

响应参数

响应参数如表5所示。

响应示例

{ 
 "errorCode":
 "SVCSTR.ALS.200200",
 "errorMessage":"Query data success",
 "result":"{\"total\":5000,
            \"data\":[{\"category\":\"app\",
            \"loghash\":\"496b2070d40a83c17f2625401af8a50aadc316f216771fbe38b94d31feaa30eb\",
            \"clusterId\":\"c693fa7c-54cd-11e8-8055-0255ac101e40\",
            \"clusterName\":\"aomdemo\",
            \"nameSpace\":\"default\",
            \"podName\":\"als0712-7c4875f884-q5wwp\",
            \"appName\":\"als0712\",
            \"serviceID\":\"\",
            \"containerName\":\"container-0\",
            \"logContent\":\"warn:2018/10/09 06:57:01 helloworld.go:108: the main process is running now.\\n\",
            \"pathFile\":\"/var/paas/sys/log/apm/debug_erro.trace\",
            \"hostIP\":\"192.168.0.133\",
            \"hostId\":\"c11c7211-5a0b-4925-bef4-d078661299b0\",
            \"hostName\":\"192.168.0.133\",
            \"collectTime\":\"1539068233983\",
            \"lineNum\":\"15390682339830002\",
            \"logContentSize\":\"77\"
                      }]
            }"
}

状态码

• 正常

  状态码如表6所示。

  表6 状态码

  状态码	编码	描述
  200	OK	请求响应成功。

• 异常

  状态码如表7所示。更多状态码请见状态码。

  表7 状态码

  状态码	编码	描述
  400	BadRequest	非法请求。 建议直接修改该请求，不要重试该请求。
  401	Unauthorized	在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。
  403	Forbidden	请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
  500	InternalServerError	表明服务端能被请求访问到，但是不能理解用户的请求。
  503	ServiceUnavailable	被请求的服务无效。 建议直接修改该请求，不要重试该请求。

错误码