Android远程日志SDK的API调用方法-移动研发平台-阿里云

此文档介绍Android远程日志SDK提供的接口。

设置日志等级

远程日志SDK提供了设置日志等级的API。支持五个日志等级，从低到高分别是VERBOSE<DEBUG<INFO<WARN<ERROR，默认日志等级是INFO。

`updateLogLevel`

更新日志等级。

接口定义

static void updateLogLevel(ApmRemoteLogLevel apmRemoteLogLevel)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
apmRemoteLogLevel	ApmRemoteLogLevel	是	异常

代码示例

Kotlin

import com.aliyun.emas.apm.remote.log.ApmRemoteLog
import com.aliyun.emas.apm.remote.log.ApmRemoteLogLevel

ApmRemoteLog.updateLogLevel(ApmRemoteLogLevel.DEBUG)

Java

import com.aliyun.emas.apm.remote.log.ApmRemoteLog;
import com.aliyun.emas.apm.remote.log.ApmRemoteLogLevel;

ApmRemoteLog.updateLogLevel(ApmRemoteLogLevel.DEBUG);

`updateLogLevel`

更新日志等级。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void updateLogLevel(TLogLevel tLogLevel)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
tLogLevel	TLogLevel	是	异常

代码示例

Kotlin

import com.alibaba.ha.adapter.service.tlog.TLogLevel
import com.alibaba.ha.adapter.service.tlog.TLogService

TLogService.updateLogLevel(TLogLevel.DEBUG)

Java

import com.alibaba.ha.adapter.service.tlog.TLogLevel;
import com.alibaba.ha.adapter.service.tlog.TLogService;

TLogService.updateLogLevel(TLogLevel.DEBUG);

打印日志

远程日志SDK根据日志等级，提供了一系列打印日志的API。

`v`

打印VERBOSE级别的日志。

接口定义

static void v(String module, String tag, String content)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`logv`

打印VERBOSE级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void logv(String module, String tag, String content)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`d`

打印DEBUG级别的日志。

接口定义

static void d(String module, String tag, String content)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`logd`

打印DEBUG级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void logd(String module, String tag, String content)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`i`

打印INFO级别的日志。

接口定义

static void i(String module, String tag, String content)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`logi`

打印INFO级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void logi(String module, String tag, String content)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`w`

打印WARN级别的日志。

接口定义

static void w(String module, String tag, String content)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`logw`

打印WARN级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void logw(String module, String tag, String content)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`w`

打印包含异常信息的WARN级别的日志。

接口定义

static void w(String tag, String content, Throwable t)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。
t	Throwable	是	异常信息。

`logw`

打印包含异常信息的WARN级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void logw(String tag, String content, Throwable t)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。
t	Throwable	是	异常信息。

`e`

打印ERROR级别的日志。

接口定义

static void e(String module, String tag, String content)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`loge`

打印ERROR级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void loge(String module, String tag, String content)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
module	String	是	输出日志内容的功能模块，便于后续根据来源筛选日志。
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。

`e`

打印包含异常信息的ERROR级别的日志。

接口定义

static void e(String tag, String content, Throwable t)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。
t	Throwable	是	异常信息。

`loge`

打印包含异常信息的ERROR级别的日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void loge(String tag, String content, Throwable t)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
tag	String	是	日志的关键字，便于后续根据标签筛选日志。
content	String	是	日志信息。
t	Throwable	是	异常信息。

主动上报日志

远程日志SDK提供了主动上报日志的能力。

说明

主动上报仅上报当天的本地缓存日志。

`positiveUploadLog`

触发主动上报日志。

接口定义

static void positiveUploadLog(String bizAliyunComment)

引入版本

2.6.0

所属类

ApmRemoteLog

参数说明

参数	类型	是否必填	说明
bizAliyunComment	String	是	本次上报日志的备注，用于在控制台上查找日志。

代码示例

Kotlin

import com.aliyun.emas.apm.remote.log.ApmRemoteLog

ApmRemoteLog.positiveUploadLog("bizAliyunComment")

Java

import com.aliyun.emas.apm.remote.log.ApmRemoteLog;

ApmRemoteLog.positiveUploadLog("bizAliyunComment");

`positiveUploadTlog`

触发主动上报日志。

说明

该接口适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

接口定义

static void positiveUploadTlog(String bizAliyunComment)

所属类

TLogService

参数说明

参数	类型	是否必填	说明
bizAliyunComment	String	是	本次上报日志的备注，用于在控制台上查找日志。

代码示例

Kotlin

import com.alibaba.ha.adapter.service.tlog.TLogService

TLogService.positiveUploadTlog("bizAliyunComment")

Java

import com.alibaba.ha.adapter.service.tlog.TLogService;

TLogService.positiveUploadTlog("bizAliyunComment");

日志等级

可用于在“设置日志等级”接口设置的日志等级

`ApmRemoteLogLevel`

引入版本

2.6.0

日志等级类是枚举类型，包含以下几个枚举值。

public enum ApmRemoteLogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
    VERBOSE
}

`TLogLevel`

说明

该类适用于SDK 2.5.0及以前版本，自2.6.0及后续版本起不再支持。

日志等级类是枚举类型，包含以下几个枚举值。

public enum TLogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
    VERBOSE
}