> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/ja/help/knowledge-base/retrieve-logs-from-an-android-device.md).

# Android デバイスからログを取得する

## 概要

Android Debug Bridge (ADB) を使用して、デバイスのログ（`logcat`）を取得し、トラブルシューティングに役立てます。

問題を制御された環境で再現できる場合は、失敗するフローの直前から直後にかけてのログを取得してください。

{% hint style="info" %}
アプリケーションのサンドボックス内にとどまる SDK ランタイムログが必要な場合は、代わりに `LogService` を使用します。参照してください [LogService でログを収集する](/nfc-wallet-sdk-android/ja/additional-features/collect-logs-with-secure-logger.md).
{% endhint %}

## 前提条件

Android デバイスからログファイルを取得する前に、次のセットアップを行っていることを確認してください。

* ホストマシンに Android Debug Bridge (ADB) をインストールします。
* 有効化 **USB デバッグ** をテスト対象デバイスで行います。
* USB ケーブルを使用して Android デバイスをホストマシンに接続します。
* 必要に応じて、Windows にデバイス用 USB ドライバーをインストールします。

セットアップを確認するには、次を実行します:

```bash
adb devices
```

ステータスが `device`:

```
のエントリが表示されれば、デバイスに到達できます
228b0e100d047ece device
```

デバイスが表示されない場合は、前提条件を再確認してください。ADB のセットアップとトラブルシューティングについては、Android 公式ドキュメントを参照してください: [Android Debug Bridge (adb)](https://developer.android.com/tools/adb).

{% hint style="warning" %}
一部のデバイスでは、ベンダー固有のメニューでデバイスのロギングを有効にする必要があります。

たとえば、一部の Huawei デバイスでは、 `*#*#2846579#*#*`をダイヤルすることでメニューにアクセスできます。参照してください [Huawei の logcat で自分のアプリのログが表示されない](https://stackoverflow.com/questions/18124334/huawei-logcat-not-showing-the-log-for-my-app) を参照してください。
{% endhint %}

## ログを取得する（推奨）

1. デバイスのログバッファをクリアします:

   ```bash
   adb logcat -b all -c
   ```
2. ログの取得を開始します（ミリ秒精度のタイムスタンプ、すべての優先度）:

   ```bash
   adb logcat -v threadtime -b all *:V > TestLogFileName.txt
   ```
3. 問題を再現します **デジタルウォレットアプリケーション**.
4. で、取得を停止してファイルを回収します:
   * を押します `CTRL+C`.
   * 取得します `TestLogFileName.txt` コマンドを実行したフォルダから取得します。

{% hint style="info" %}
最も詳細なログを得るには、NFC Wallet SDK を統合した **デジタルウォレットアプリケーション** のビルドを使用して再現します `dev` ビルド。

参照してください [成果物](/nfc-wallet-sdk-android/ja/general/deliverables.md) 対応しているビルドタイプについて。

ログは失敗するフローの周辺だけを取得してください。手順の直前に開始し、直後に停止します。
{% endhint %}

{% hint style="warning" %}
回避してください [logcat フィルター](https://developer.android.com/studio/command-line/logcat#filteringOutput)。これらは、根本原因分析に必要な行を隠してしまうことがよくあります。
{% endhint %}

## セットアップの検証

SDK API を呼び出すフローを実行することでセットアップを検証できます。たとえば、 **カード一覧を取得** で [デジタルカードを表示](/nfc-wallet-sdk-android/ja/implement-nfc-wallet/manage-digital-cards/display-digital-cards.md#retrieve-card-list).

推奨コマンドを使用すると、ログファイルには次が含まれているはずです。

* 各行にミリ秒精度のタイムスタンプ。
* ログ優先度の文字が `V` （Verbose）まで、PID および TID フィールドの後に表示されること。
* 次を含む行: `PublicAPI::Start of DigitalizedCardManager.getAllCards`.

次の例は、そのような機能を示すログの抜粋です:

```
08-06 17:11:21.790 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of DigitalizedCardManager.getAllCards
08-06 17:11:21.790 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of SDKController.getInstance
08-06 17:11:21.791 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of SDKController.getService
08-06 17:11:21.791 14171 14171 V util.h.xy.by.mb: 名前が DigitalizedCardBuinsessService のサービスを取得しようとしています
08-06 17:11:21.791 14171 14171 D util.h.xy.by.mb: business service = util.h.xy.l.a@f9a06e1
08-06 17:11:21.791 14171 14171 V util.h.xy.l.a: getAllCards が呼び出されました
08-06 17:11:21.791 14171 14171 D util.h.xy.aj.b: [DCM.getAllCards].increment
08-06 17:11:21.791 14171 14171 V util.h.xy.aj.b: [DCM.getAllCards] 残りの Ops は 1 です
08-06 17:11:21.792 14171 18982 I util.h.xy.n.mb: -----------------------------------------------------------------------GET_ALLCARDS-START----------------------------------------------------------------------

```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/ja/help/knowledge-base/retrieve-logs-from-an-android-device.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.