クラッシュ、ANR、tombstone を保持するプラットフォームのリングバッファ。root なしで ANR トレースを読む方法です。
dumpsys dropbox [--print <tag>]| トークン | 意味 |
|---|---|
| --print <tag> | その tag のエントリの本文をすべて印字します。tag なしなら索引だけで、最初に見るべきはそちらです。 |
dumpsys dropbox索引:1 エントリ 1 行、本文なし。安価です。
dumpsys dropbox --print data_app_anr実際の ANR トレース。スタックも入っています。
dumpsys dropbox --print data_app_crash直近のアプリのクラッシュと、その例外。
出力例
Drop box contents: 96 entries
Max entries: 1000
2026-07-26 11:04:31 data_app_crash (text, 4321 bytes)
2026-07-26 11:41:02 data_app_anr (compressed text, 12043 bytes)
2026-07-26 12:00:00 SYSTEM_TOMBSTONE (data, 91234 bytes)索引はタイムスタンプ、tag、そしてエントリの保存形式についての括弧書きです。tag が分類で、`data_app_*` は使用者が入れたアプリ、`system_app_*` はプリインストール、`*_anr` は応答なしのトレース、`*_crash` は Java の例外、`*_native_crash` と `SYSTEM_TOMBSTONE` はネイティブのクラッシュです。括弧の中身は自由書式で、メーカーは言い換えます。
| フィールド | 意味 |
|---|---|
| Drop box contents: N entries | いまバッファが保持しているエントリ数。 |
| <date> <time> <tag> | 端末自身のタイムゾーンでの発生時刻と、どの種類の失敗か。 |
| (text, N bytes) | 保存形式とサイズ。読めないサイズは 0 ではなく不明です。 |
| data_app_anr | 使用者が入れたアプリでの ANR。/data/anr に探しに行っていたトレースです。 |
| SYSTEM_TOMBSTONE | システムが保持することを選んだネイティブのクラッシュ。 |
Android ADB Toolbox はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
dumpsys dropbox と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| logcat | システムログを流し読みします。端末で起きていることすべての実況です。 |
| dumpsys activity activities | いまどのアプリが前面にいるか、そしてその背後のタスクとスタックの構造。 |
| run-as | あるアプリ自身の uid でコマンドを実行します。root なしで debuggable ビルドのプライベートファイルを読む方法です。 |
| コマンド | 何をするか |
|---|---|
| dumpsys battery | バッテリーサービスの現在の状態:残量、充電状態、健康度、電圧、温度。 |
| dumpsys diskstats | パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。 |
| dumpsys thermalservice | 端末が発熱で性能を絞っているか、そしてハードウェア層が報告する各温度ゾーンを摂氏で表示します。 |
| dumpsys sensorservice | 端末にあるすべてのセンサーとそのベンダー、type、レート、バッチング。加えて直近の測定値のバッファ。 |
| dumpsys meminfo | どのプロセスがメモリを最も使っているかを、PSS(比例配分したサイズ)で表示します。 |
| dumpsys package | パッケージマネージャが知っているすべて:バージョン、パス、flags、インストール元、ユーザーごとの状態。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。
端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。
このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り(debuggable なビルドに対する `run-as` を除く)、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。
Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。
多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。
打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。