GP 32 i、BX 7 A、BF 600 S、BJ 7 A、Bi 56 AなどのAndroid IP電話から、syslog、デバッグパッケージ、パケットキャプチャ、ADBログ、スクリーンショットなどのデバッグ情報を収集する方法を学びます。
Android IP電話機の内部試験または顧客導入時に不具合が発生した場合、技術者はトラブルシューティングと分析のためにデバッグ情報を提出する必要があります。本ガイドでは、必要な診断ファイルの収集方法について説明します。
GP32i、BX7A、BF600S、BJ7A、Bi56A
1. Android IP電話機1台、USBメモリ1個、PoEスイッチまたはDC電源を用意します。電話機をスイッチに接続してください。
2. デバッグ用PC1台を用意し、同じスイッチに接続します。PCと電話機がネットワーク上で通信できることを確認してください。
Android IP電話機（ここではA32iを例に）をスイッチに接続し、PCも同じスイッチに接続します。PCと機器のネットワークが疎通できることを確認してください。接続例は図1の通りです。
図1. 機器とPCの接続図
不具合の内容に応じて、分析に必要な診断情報の種類が異なります。以下のセクションでは、状況別に提出すべきファイルについて説明します。
ほとんどの場合、以下の3つのファイルを収集して開発チームに提出する必要があります：
1. デバッグシステムログファイル
電話機のWebインターフェースにログインし、システム > サポートページに移動し、システムログを見つけてください。
以下の設定を行ってください：
1) システムログを有効にする
2) サーバーアドレスをローカルPCのIPアドレスに設定する
3) サーバーポートを514に設定する
4) システムログレベルをデバッグに設定する
5) ログのエクスポートを有効にする
6) 不具合を再現した後、ログのエクスポートをクリックしてシステムログファイルをダウンロードする
図2. デバッグシステムログのエクスポート
2. デバッグパッケージ
デバッグパッケージには、電話機のキャッシュログ、実行情報、ファームウェアの詳細、その他の内部診断データが含まれており、Webインターフェースからエクスポートできます。
システム > サポートツールに移動し、ワンクリックでデバッグ情報をエクスポートオプションを見つけてエクスポートをクリックしてください。この処理は約1分かかります。
図3. デバッグパッケージのエクスポート
3. ネットワークキャプチャファイル
キャプチャファイルは送受信されたネットワークパケットを記録し、Wiresharkなどのツールで分析できます。
ネットワークトラフィックをキャプチャする手順：
1) 開始をクリックし、Webページのキャプチャプロセスが開始するのを待つ
2) 不具合を再現する
3) 不具合を再現した後、停止をクリックする
4) ブラウザのダウンロードページを開き、キャプチャファイルを探す
図4. ネットワークパケットのキャプチャ
上記3つのファイルを提出した後、状況によっては追加情報が必要になる場合があります。
開発チームがデバッグシステムログ、デバッグパッケージ、キャプチャファイルを分析した後、詳細な分析のためにAndroidリアルタイムログを要求する場合があります。以下のセクションでは、ADBを使用したAndroidリアルタイムログの収集方法について説明します。
Androidリアルタイムログ
電話機の動作中、Androidプラットフォームは実行ログを継続的に出力します。これらのログはエンジニアが問題を特定・分析するのに役立ちます。
1. PCにADBツールをインストールする
お使いのOSに対応したADBツールは以下のURLからダウンロードできます：
https://developer.android.google.cn/studio/releases/platform-tools
インストール後、ADBのインストールパスをシステム環境変数に追加してください。Windowsの場合、このPC > プロパティ > システムの詳細設定 > 詳細設定 > 環境変数に移動し、ADBディレクトリの絶対パスをPath変数に追加します。
図5. ADBパスの追加
PCでコマンドプロンプトを開き、adbコマンドを入力してください。コマンドが正常に実行されれば、ADBが正しくインストールされています。
図6. ADBインストール成功
2. 電話機でUSBデバッグを有効にする
2020年12月1日以降にリリースされたAndroidファームウェアでは、ADBデバッグはデフォルトで無効になっており、手動で有効にする必要があります。
電話機にUSBメモリを挿入し、設定 > デバイス情報に移動し、ファームウェアバージョン番号を5回タップして開発者モードを有効にしてください。
図7. 開発者モードの有効化
その後、設定 > システム > 開発者向けオプションに移動し、USBデバッグをオンにしてください。
図8. USBデバッグの有効化
3. デバッグログレベルを変更する
電話機のデフォルトのログレベルは通常通知に設定されており、必要最小限の情報のみ記録されます。より詳細なログを取得するには、ログレベルをトレースに変更してください。
電話機の設定 > システムメンテナンス > ツールに移動し、ログレベルをトレースに設定してください。
図9. ログレベルの変更
4. リアルタイムログをキャプチャする
以下のADBコマンドを使用します：
adb connect 172.18.8.28
172.18.8.28を電話機の実際のIPアドレスに置き換えてください。このコマンドはネットワーク経由で電話機に接続します。
adb devices
このコマンドは接続されているデバイスを一覧表示し、電話機が正常に接続されているか確認できます。
adb logcat -G 16M
このコマンドはログバッファサイズを拡張し、より多くのログ内容を保存できるようにします。
adb logcat > logcat-202111051708.log
このコマンドはリアルタイムログの出力をPC上のファイルに保存します。推奨される命名形式：年+月+日+時+分+秒+.log
図10. リアルタイムログのキャプチャ
ログ取得が完了したら、以下のコマンドを実行します：
adb disconnect 172.18.8.28
これによりPCと電話機の接続が切断されます。その後、PC上の対応するディレクトリで生成されたリアルタイムログファイルを見つけることができます。
図11. リアルタイムログファイルのパス
不具合がLCD画面または表示動作に関連する場合、スクリーンショットファイルも提出する必要があります。
電話機のWebインターフェースにログインし、システム > サポートページに移動し、画面キャプチャを見つけてください。画像を保存をクリックしてスクリーンショットをダウンロード・保存してください。
図12. スクリーンショットの保存
