top

読み取りのみ

1 回分のプロセス表：CPU 使用率、メモリ、状態、コマンドライン。

コマンド: adb shell top
コマンド: システムとログ
リスク: 読み取りのみ

構文

top -b -n 1 [-m <rows>] [-H] [-q]

フラグと引数

トークン	意味
-b	バッチモード：カーソル制御ではなくただの行を出します。
-n 1	1 回だけ実行して終了します。これがないと戻ってきません。
-m <rows>	プロセス行の数を制限します。転送量を小さく保つのはこれです。
-H	プロセスではなくスレッド。
-q	ヘッダを抑制します。ここでは決して有用ではありません。ヘッダがスキーマだからです。

使用例

```
top -b -n 1 -m 10
```
いちばん忙しい 10 プロセスを 1 回。
```
top -b -n 1
```
全プロセス。最近の端末では数百行になります。
```
top -b -n 1 -H -m 20
```
1 か所で忙しいアプリのために、スレッド単位で。

出力の読み方

出力例

Tasks: 1003 total,   1 running, 1002 sleeping,   0 stopped,   0 zombie
  PID USER         PR  NI VIRT  RES  SHR S[%CPU] %MEM   TIME+ ARGS
 3062 u0_a234      20   0 14.2G 353M 210M S  6.2   3.0  12:04.51 com.example

要約行、ヘッダ、そして 1 行 1 プロセスです。列はそのヘッダを通して読んでください。ソートされている列は角括弧で囲まれ、`S[%CPU] %MEM` は 1 列ではなく 2 列です。括弧を外さずにラベルを厳密一致させる読み方をすると、まさに表がソートされている列を失います。

出力フィールド

フィールド	意味
PID / USER	プロセス id と Android の uid 名（`u0_a234` はアプリ）。
%CPU	サンプル区間での使用率。小数第 1 位まで。
RES / VIRT / SHR	常駐・仮想・共有メモリを、有効桁 3 つに丸めた人間向けのバイト値で。
RSS	4 KiB ページを仮定した KiB 単位の常駐メモリ。これは toybox 自身の仮定なので、16 KiB ページの端末では小さく出ます。
S	プロセスの状態：S 休眠、R 実行中、D 割り込み不可、Z ゾンビ。
TIME+	累積 CPU 時間、分:秒.100 分の 1 秒。しかもそれは「総分数」なので、CPU 時間 2 時間は 120:00.00 と出ます。
ARGS	コマンドライン。空白を含みます。常に最後の列です。

バージョンとメーカーに関する注意

Android の `top` は procps ではなく toybox で、フラグも列も GNU の man ページとは違います。既定の列の組はヘルプではなくコードが決めています。
`-n 1` でも 4 分の 1 秒ほどかかります。CPU 使用率には 2 回のサンプルが必要だからです。得られる数値は起動以来の平均ではなく、本物の短時間の測定です。
要約行からメモリの合計を導かないでください。カーネルのカウンタを丸めて言い換えた不可逆な形です。`/proc/meminfo` の方が良い情報源です。

これには UI があります

Android System Monitor はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android System Monitor を開く

コマンド	何をするか
dumpsys meminfo	どのプロセスがメモリを最も使っているかを、PSS（比例配分したサイズ）で表示します。
am force-stop	あるアプリのプロセスとサービスをすべて終了させます。
dumpsys activity activities	いまどのアプリが前面にいるか、そしてその背後のタスクとスタックの構造。

他のシステムとログコマンド

コマンド	何をするか
getprop	システムプロパティを表示します。端末自身が語る「これは何か」です。
logcat	システムログを流し読みします。端末で起きていることすべての実況です。
run-as	あるアプリ自身の uid でコマンドを実行します。root なしで debuggable ビルドのプライベートファイルを読む方法です。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `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 経由で実行します。あるいは全コマンドを見る。

構文