发起HBlock日志采集 本节主要介绍如何使用API发起HBlock日志采集。 此操作用来发起HBlock日志采集。 注意 目前仅支持10个日志采集任务,超过10个将不能采集新日志。 系统中有正在进行的采集任务,不能执行新的采集任务。 每次采集的日志文件大小不超过5 GiB。 日志信息以服务器的系统时间为准进行记录。时间被调整,或集群中服务器时间不统一,都可能导致日志信息不准确,但用户数据不会受影响。 请求语法 plaintext POST /rest/v1/system/logcollect HTTP/1.1 Date: date Host: ip:port ContentLength: length Authorization: authorization { "startTime": startTime, "endTime": endTime, "servers": [ serverId1, serverId2, …, serverIdN ], "logTypes": [ logTypes ], "services": [ service1, service2, …, serviceN ], "outputDirectory": outputDirectory } 请求参数 参数 类型 描述 是否必须 startTime String HBlock日志采集的起始时间。 取值:unix时间戳(UTC),精确到毫秒。默认值为HBlock日志采集结束时间2小时之前的时间点。 注意 HBlock日志采集的起始时间必须早于HBlocks日志采集的结束时间。 如果HBlock日志采集的起始时间早于HBlock初始化时间,则HBlock初始化时间为日志采集起始时间。 如果修改系统时间,可能导致日志文件的最后修改时间出现波动甚至错误。 否 endTime String HBlock日志采集的结束时间。 取值:unix时间戳(UTC),精确到毫秒。默认值为当前时间。 注意 HBlock日志采集的起始时间必须早于HBlocks日志采集的结束时间。 HBlock日志采集的结束时间必须晚于HBlock初始化时间。 日志文件的最后修改时间大于结束时间时,如果存在多个大于结束时间的同类型日志,则HBlock日志采集时间值最小的那个日志文件。 否 servers Array of String 要采集HBlock日志的服务器ID。 取值:可以填写多个服务器ID,以英文逗号(,)隔开。默认采集所有服务器。 否 logTypes Array of String 采集的日志类型 取值: Config:配置相关的日志。 System:系统相关的日志。 Data:数据处理相关的日志(仅集群版支持)。 Coordination:内部协调服务相关的日志(仅集群版支持)。 Service:HBlock具体服务相关的日志。 默认采集所有类型的日志。 否 services Array of string 待采集的服务,一次可以指定多个服务,以英文逗号(,)分开。 说明 只有采集类型包含Service时,此参数才有效。 取值: mdm:元数据管理服务(仅集群版支持)。 fc:故障转移控制服务(仅集群版支持)。 ls:日志服务(仅集群版支持)。 cs:协调服务(仅集群版支持)。 ds:数据服务(仅集群版支持)。 dsx:磁盘的数据服务(仅集群版支持)。 ps:协议解析服务。 ms:管理服务。 ag:数据采集服务。 cloud:云服务。 net:网络服务(仅集群版支持)。 rb:数据均衡服务(仅集群版支持)。 stor:stor命令行服务。 ua:升级监听服务。 uc:升级控制器。 ws:监控服务。 默认采集所有服务的日志。 outputDirectory String HBlock日志采集后存放的目录,为绝对路径。 取值:如果不指定,默认存放在被请求服务器的HBlock安装目录下。以collectedlogs/hblocklogsidyyyyMMddHHmmssyyyyMMddHHmmss.zip命名,其中: id:本次日志请求的唯一标识符。 yyyyMMddHHmmss:日志采集的起始时间和结束时间,UTC+0时间。 否