HTTPDNS:Troubleshooting APIs

Get the session ID

Obtain the session ID to trace the parsing procedure. If a parsing error occurs, provide this ID to technical support through a DingTalk group or a ticket.

getSessionId

API definition

String getSessionId()

Version introduced

1.3.2

Class

HttpDnsService

Return value

Code example

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

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

Enable HTTPDNS log printing

You can specify whether to print HTTPDNS debug logs to the console. This feature is disabled by default.

enable

API definition

void enable(boolean enable)

Version introduced

2.0.2

Class

HttpDnsLog

Parameters

Code example

HttpDnsLog.enable(shouldPrintLog)

HttpDnsLog.enable(shouldPrintLog);

Set a callback class for SDK logs

You can set a callback class to obtain internal logs from the SDK.

setLogger

Adds a log callback class.

API definition

void setLogger(ILogger logger)

Version introduced

2.0.2

Class

HttpDnsLog

Parameters

Code example

HttpDnsLog.setLogger { s ->
    Log.d(
        "HttpDnsSDK",
        "resultILogger:$s"
    )
}

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

removeLogger

Removes a log callback class.

API definition

void removeLogger(ILogger logger)

Version introduced

2.0.2

Class

HttpDnsLog

Parameters

Code example

HttpDnsLog.removeLogger(logger)

HttpDnsLog.removeLogger(logger);

Troubleshoot parsing failures with logs

If parsing fails, filter for "RESOLVE FAIL" in the console to find the cause.

If the parsing API reports an error, the following logs are output:

1. Network connectivity failed for a single-host resolution.

2. Network connectivity failed for a batch resolution.

3. A signature error was reported for a single-host resolution.

4. A signature error was reported for a batch resolution.

5. An encryption error was reported for a single-host resolution.

6. An encryption error was reported for a batch resolution.

7. The log indicates the reason for an empty resolution result.