すべてのプロダクト
Search
ドキュメントセンター

HTTPDNS:トラブルシューティング API

最終更新日:Nov 09, 2025

セッション ID の取得

セッション ID を取得して、解析プロシージャをトレースします。解析エラーが発生した場合は、DingTalk グループまたはチケットを通じてテクニカルサポートにこの ID を提供してください。

説明

セッション ID は、アプリのライフサイクル中に変更されない、ランダムに生成された 12 文字の文字列です。

getSessionId

API 定義

String getSessionId()

導入バージョン

1.3.2

クラス

HttpDnsService

戻り値

タイプ

説明

String

セッション ID を返します。

コード例

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

HTTPDNS ログ出力の有効化

HTTPDNS デバッグログをコンソールに出力するかどうかを指定できます。この機能はデフォルトで無効になっています。

重要

accountID や secretKey などのパラメーター、またはアプリの実行時に生成されたデータの漏洩を防ぐために、本番バージョンではログ出力を無効にする必要があります。

enable

API 定義

void enable(boolean enable)

導入バージョン

2.0.2

クラス

HttpDnsLog

パラメーター

パラメーター

タイプ

必須

説明

enable

boolean

はい

logcat にログを出力するかどうかを指定します。

コード例

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

SDK ログのコールバッククラスの設定

コールバッククラスを設定して、SDK から内部ログを取得できます。

setLogger

ログコールバッククラスを追加します。

API 定義

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

ログコールバッククラスを削除します。

API 定義

void removeLogger(ILogger logger)

導入バージョン

2.0.2

クラス

HttpDnsLog

パラメーター

パラメーター

タイプ

必須

説明

logger

ILogger

はい

以前に追加されたロガー。

コード例

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

ログによる解析失敗のトラブルシューティング

解析が失敗した場合は、コンソールで "RESOLVE FAIL" をフィルターして原因を特定します。

解析 API がエラーを報告すると、次のログが出力されます。

  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" でフィルターすると、他の失敗ログも出力されます。