全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
日志服务

PullLogs

更新时间:2018-03-30 00:04:13

PullLogs

根据游标、数量获得日志。获得日志时必须指定 shard。如果在 storm 等情况下可以通过 LoghubClientLib 进行选举与协同消费。目前仅支持读取 PB 格式 LogGroupList 数据。

请求语法

  1. GET /logstores/ay42/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=100 HTTP/1.1
  2. Accept: application/x-protobuf
  3. Accept-Encoding: lz4
  4. Authorization: <AuthorizationString>
  5. Date: <GMT Date>
  6. Host: <Project Endpoint>
  7. x-log-apiversion: 0.6.0
  8. x-log-signaturemethod: hmac-sha1

请求参数

URL 参数:

参数名称 类型 是否必须 描述
type string 此处为 logs。
cursor string 游标,用以表示从什么位置开始读取数据,相当于起点。
count int 返回的 loggroup 数目,范围为 0~1000。

请求头

  • Accept: application/x-protobuf
  • Accept-Encoding: lz4 或 deflate 或 “”

关于 API 的公共请求头,请参考 公共请求头

响应头

  • x-log-cursor:当前读取数据下一条 cursor
  • x-log-count:当前返回数量

关于 API 的公共响应头,请参考 公共响应头

响应元素

protobuf 格式序列化后的数据(可能经过压缩)。

细节描述

N/A

特有错误码

除了返回 API 的 通用错误码,还可能返回如下特有错误码:

HTTP 状态码 ErrorCode ErrorMessage
404 LogStoreNotExist Logstore {Name} does not exist
400 ParameterInvalid Parameter Cursor is not valid
400 ParameterInvalid ParameterCount should be in [0-1000]
400 ShardNotExist Shard {ShardID} does not exist
400 InvalidCursor this cursor is invalid
500 InternalServerError Specified Server Error Message

示例

请求示例:
  1. 读取 0 shard 上的数据
  2. GET /logstores/sls-test-logstore/shards/0?cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=1000&type=log
  3. Header:
  4. {
  5. "Authorization"="LOG 94to3z418yupi6ikawqqd370:WeMYZp6bH/SmWEgryMrLhbxK+7o=",
  6. "x-log-bodyrawsize"=0,
  7. "User-Agent" : "sls-java-sdk-v-0.6.0",
  8. "x-log-apiversion" : "0.6.0",
  9. "Host" : "ali-test-project.cn-hangzhou-failover-intranet.sls.aliyuncs.com",
  10. "x-log-signaturemethod" : "hmac-sha1",
  11. "Accept-Encoding" : "lz4",
  12. "Content-Length": 0,
  13. "Date" : "Thu, 12 Nov 2015 12:03:17 GMT",
  14. "Content-Type" : "application/x-protobuf",
  15. "accept" : "application/x-protobuf"
  16. }
响应示例:
  1. Header:
  2. {
  3. "x-log-count" : "1000",
  4. "x-log-requestid" : "56447FB20351626D7C000874",
  5. "Server" : "nginx/1.6.1",
  6. "x-log-bodyrawsize" : "34121",
  7. "Connection" : "close",
  8. "Content-Length" : "4231",
  9. "x-log-cursor" : "MTQ0NzMyOTQwMTEwMjEzMDkwNA==",
  10. "Date" : "Thu, 12 Nov 2015 12:01:54 GMT",
  11. "x-log-compresstype" : "lz4",
  12. "Content-Type" : "application/x-protobuf"
  13. }
  14. Body:
  15. <protobuf 格式 loggrouplist 内容> 压缩后结果

翻页

如果只为了翻页(拿到下一组 Token),不返回数据,可以通过 HTTP HEAD 方式进行请求。

本文导读目录