4.2 KiB
title, parent, nav_order, last_updated, description, aliases
| title | parent | nav_order | last_updated | description | aliases | ||||
|---|---|---|---|---|---|---|---|---|---|
| デバッグログ | ユーザーガイド | 22 | 2026-07-08 | アプリのデバッグログをアプリ内で表示・エクスポートし、バグの診断に役立つよう GitHub の issue にキャプチャを添付できます。adb は不要です。 |
|
デバッグログ
何か不具合が起きたとき、アプリのデバッグログは、バグ報告に添付できる最も役立つものです。 Meshtastic は、アプリ内で自動的にログをキャプチャできます。収集に adb やデスクトップのツールは不要になりました。
「設定 → 詳細設定 → デバッグパネル」から「デバッグパネル」を開きます。
📎 issue を作成しますか? ログをエクスポートし(下記参照)、github.com/meshtastic/Meshtastic-Android/issues の報告に
.txtファイルを添付してください。 問題が起きた瞬間を含むログのキャプチャは、「動かない」という報告を、開発者が実際に追跡できるものに変えます。
2 つのタブ
デバッグパネルには 2 つのタブがあります:
- パケット:無線機が送受信した、デコード済みのメッシュトラフィック(プロトコルレベルのメッセージ)。 メッシュやルーティングの動作を診断するのに役立ちます。
- アプリログ:アプリ自身の診断ログ(Android の logcat)。アプリからの警告、エラー、スタックトレースを含みます。 通常、バグ報告に必要なのはこちらです。
各タブには独自のエクスポートボタンがあり、それぞれ別のファイルを生成するため、関連する方を、または両方を取得できます。
アプリログを表示する
「アプリログ」タブは、このアプリのみの最新のログ行を表示します。デバイス上の他のアプリのものは表示しません。
- 検索:検索ボックスに入力すると、一致する行に絞り込めます。
- レベルフィルター:V/D/I/W/E のチップで、Verbose、Debug、Info、Warn、Error の行を切り替えます。 レベルをタップすると非表示になり、もう一度タップすると再表示されます。 Fatal の行は常に表示されます。
- 更新:更新アイコンで最新のログを読み直します。
エラーと警告の行は色付けされ、問題が目立つようになっています。
エクスポート
ダウンロードアイコンをタップすると、現在のログをファイルに保存できます。 保存先はシステムのファイル選択画面で選び、ファイルにはタイムスタンプ付きの名前(例:meshtastic_logcat_20260701_143312.txt)が付くため、繰り返しエクスポートしても互いに上書きされることはありません。
そのファイルを GitHub の issue に添付してください。
🔒 プライバシー: エクスポートは、ファイルに書き込む前に、秘密鍵・管理者鍵・セッションパスキーを自動的に秘匿化します。 チャンネルの PSK は秘匿化されません。また、ログにはノード名、位置、その他の識別情報が含まれることがあります。公開して共有する前にファイルにざっと目を通し、少しでも不安があれば非公開で共有してください。
デスクトップ
デスクトップアプリにはシステムの logcat がないため、「アプリログ」タブは代わりに、アプリ自身がキャプチャしたログ出力を表示します。 検索、絞り込み、エクスポートは同じように機能します。
関連トピック
- ヘルプとアプリ内ドキュメント:このドキュメントをアプリ内でオフラインで読む
- コネクション:そもそも無線機に接続できないことが問題の場合