排查追踪接口

获取sessionId

获取用于追踪解析过程的sessionId,若遇到解析异常的情况,通过钉群、工单等方式寻找技术支持协助排查时,需要提供此信息。

说明

sessionId为随机生成,长度为12位,App生命周期内保持不变。

getSessionId

接口定义

String getSessionId()

引入版本

1.3.2

所属类

HttpDnsService

返回说明

类型

说明

String

返回sessionId

代码示例

val httpdns = HttpDns.getService(accountID)
val sessionId = httpdns?.getSessionId()
HttpDnsService httpdns = HttpDns.getService(accountID);
String sessionId = httpdns.getSessionId();

是否允许HTTPDNS打印Log

设置是否打开HTTPDNS的日志开关,默认关闭。

enable

接口定义

void enable(boolean enable)

引入版本

2.0.2

所属类

HttpDnsLog

参数说明

参数

类型

是否必填

说明

enable

boolean

是否打印Loglogcat。

代码示例

HttpDnsLog.enable(shouldPrintLog)
HttpDnsLog.enable(shouldPrintLog);

设置接收SDK日志的回调类

可以通过设置日志的回调类来获取SDK内部输出的日志。

setLogger

添加日志回调类。

接口定义

void setLogger(ILogger logger)

引入版本

2.0.2

所属类

HttpDnsLog

参数说明

参数

类型

是否必填

说明

logger

ILogger

设置该接口后,SDK内部的日志会通过ILogger接口进行回调,便于自行控制日志的打印和存储。

代码示例

HttpDnsLog.setLogger { s ->
    Log.d(
        "HttpDnsSDK",
        "resultILogger:$s"
    )
}
HttpDnsLog.setLogger(new ILogger() {
    @Override
    public void log(String s) {
        Log.d("HttpDnsSDK", "resultILogger:" + s);
    }
});

removeLogger

删除日志回调类。

接口定义

void removeLogger(ILogger logger)

引入版本

2.0.2

所属类

HttpDnsLog

参数说明

参数

类型

是否必填

说明

logger

ILogger

之前添加过的logger。

代码示例

HttpDnsLog.removeLogger(logger)
HttpDnsLog.removeLogger(logger);

解析失败日志排查

解析失败后,可以在控制台过滤“RESOLVE FAIL”查看失败原因。

解析接口报错会输出以下日志:

  1. 单发解析网络连接失败。

76BE3851-990E-4CC6-A812-3BFDA358D3A0

  1. 批量解析网络连接失败。

DC58501C-9F5E-4088-A9B2-5E135982A74D

  1. 单发解析加签报错输出。

B5CF3EB1-2157-4F4E-A9A4-16ACE5DCC231

  1. 批量解析加签报错输出。

F3B10F07-9EB6-469C-A5B6-C1B078F46D04

  1. 单发解析加密报错输出。

6167D44B-E9F5-4A26-A8C8-56C5672F2F69

  1. 批量解析加密报错输出。

A6F5B59D-809F-4CB6-BF27-0229216A6B3A

  1. 解析结果为空原因输出。

E95977FE-B0BC-4E24-AC3A-430B4AB9F5F5

说明

以上日志只是解析失败的部分原因。过滤“RESOLVE FAIL”还会打印别的解析失败日志。