基本概念

术语

说明

远程日志/用户日志

App保存在用户终端设备上的日志。

日志拉取

将App保存在用户终端设备上的日志，拉取到远程日志服务的控制台。

日志级别

远程日志服务定义了4个日志级别，分别是：

• Error：错误信息

• Warn：警告信息

• Info：一般信息

• Debug：调试信息

日志级别排序为：Error > Warn > Info > Debug

拉取级别

用于限制拉取至远程日志服务控制台的日志的级别。只有等级高于拉取级别的日志，才会被拉取至远程日志服务的控制台。

• 当拉取级别设置为Error，拉取Error级别的日志。

• 当拉取级别设置为Warn，拉取Warn及以上级别的日志，即Warn/Error级别的日志。

• 当拉取级别设置为Info，拉取Info及以上级别的日志，即Info/Warn/Error级别的日志。

• 当拉取级别设置为Debug，拉取Debug及以上级别的日志，即全部级别的日志。

拉取级别在初始化SDK时进行全局设置，如未设置，则默认设置为Info。

拉取任务

按照既定设置，执行一次日志拉取。其中，设置拉取设备可采用设备拉取和条件拉取2种方式。

任务类型

远程日志的任务可分为2种类型：设备拉取、条件拉取。

设备拉取

指向性回捞。针对已知历史上线过的设备下发指令，用于定点排查历史存量设备的问题。

条件拉取

预设过滤规则，监听设备上线事件，实时捕获符合条件设备（含新设备）的现场日志。

拉取状态

拉取任务在执行过程中，描述拉取进度的若干阶段。拉取状态包括：

• 开始拉取： 任务已生成，但是设备未活跃。

• 任务下发： 设备响应拉取任务，检查本地文件。

• 令牌下发： 设备通过服务端申请了相关文件上传的令牌。

• 获取日志： 成功获取到设备上传的日志。

• 发送解析： 设备日志发送至服务端解析。

• 拉取成功： 日志解析成功。

• 拉取失败： 拉取任务异常中断。

• 拉取超时： 24小时内，设备未获取任务。

• 任务取消： 设备拉取任务被用户或系统取消。