日志服务(Log Service,简称 LOG)是针对日志平台化服务。服务提供各种类型日志的实时收集、存储和分发。除此之外,LOG 有 ODPS Table 间同步服务,通过 LOG 可以将日志投递至 ODPS 做大数据分析。

除了通过管理控制台进行操作外,LOG 还提供了 API(Application Programming Interface)方式写入、查询日志数据,管理自己的项目及日志库等。目前开放如下 API:

对象 方法
Log(日志) 日志、日志组表示等基本概念
Project (项目) ListCreateDeleteGet
(项目) GetProjectLogs(统计Project下所有日志)
Config (配置) ListCreateDeleteGetUpdate
GetAppliedMachineGroups(查询应用到的机器组)
MachineGroup (机器组) ListCreateDeleteGetUpdate
Apply/Remove(应用/删除配置)
GetAppliedConfigs(查询已应用配置列表)
LogStore (日志库) ListCreateDeleteGetUpdate
GetLogs(查询日志)、GetHistograms(查询日志分布)
Index(索引) CreateUpdateDeleteGetIndex
Shard (分区) ListSplitMerge
PostLogStoreLogs(写入日志)
GetCursor(定位日志位置)
PullLogs(消费日志)
Shipper(日志投递规则) GetShipperStatus(查询日志投递任务状态)
RetryShipperTask(重试失败投递任务)
ConsumerGroup(消费组) CreateUpdateDeleteList
HeartBeat(发送心跳)、GetCheckpoint, UpdateCheckpoint

通过 API 可以操作下列服务:

说明
  • API 目前提供 Rest 风格。
  • 为使用 API,需要知道 服务入口
  • API 所有请求都需要做安全验证,请参考请求签名解释了具体的 API 请求签名机制及流程。
  • Log Service 支持 RAM、STS,RAM 子用户使用 API,和一般云账号没有区别,使用子用户的 AK 签名即可。STS 临时身份除了临时 AK 外,还需要填写一个特殊的 HTTP header,详见公共请求头,这个 HTTP header 需要参与签名,详见 请求签名