dumpsys diskstats

唯讀

每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。

指令: adb shell dumpsys diskstats
指令: 系統服務（dumpsys）
風險: 唯讀

語法

dumpsys diskstats

範例

```
dumpsys diskstats
```
服務手上的全部：即時那半與快取那半。
```
df -k /data
```
對真正重要的那個分割區，再取一次獨立的剩餘空間讀數。

輸出怎麼讀

輸出範例

Latency: 3ms [512B Data Write]
Data-Free: 12345678K / 111222333K total = 11% free
Cache-Free: 1234K / 5678K total = 21% free
App Size: 45678901234
App Data Size: 23456789012
App Cache Size: 3456789012

一份輸出裡有兩個互不相干的半邊。即時的那半——寫入延遲與 `*-Free:` 行——每次呼叫都會實測，它的 `K` 後綴是 KiB，換成位元組要乘 1024。另一半來自一個背景工作大約每天更新一次的檔案，儘管別處有個名字很像的欄位容易讓人誤會，這裡的大小是純位元組。如果那個工作從沒跑過，快取的那半會整段不存在。

輸出欄位

欄位	意義
Latency: Nms [512B Data Write]	現在往 /data 寫 512 個位元組花了多久。
<partition>-Free: aK / bK total = c% free	以 KiB 表示的剩餘與總量，加上裝置自己用整數除法算的百分比。
<partition>-Error: …	那個分割區量不到。輸出的其餘部分仍然有效。
App Size / App Data Size / App Cache Size	來自快取那半的程式碼、資料與快取總量，單位是位元組。
Package Names / App Sizes / App Data Sizes / Cache Sizes	四條只靠索引對齊的平行陣列。

版本與廠商注意事項

各 app 的數字不是一筆一筆的記錄，而是四條各自獨立的陣列。只要有一條比較短，缺口之後的每一列都會被算到別的 app 身上。所以四條長度不一致時，那張表就沒有價值，該丟掉而不是硬拼起來。
這是真的會失敗的輸出之一：它會做一次同步磁碟寫入與一次 binder 往返，所以可能撞上 dumpsys 的逾時，也有版本以權限為由整份拒絕。
快取那半最多可能是一天前的。想要當下可信的數字，用 `df` 或 `du`。

這個我們有 UI

Android Storage Analyzer 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android Storage Analyzer

指令	做什麼
df	回報每個已掛載檔案系統的剩餘與已用空間。
du	回報一棵目錄樹占掉多少磁碟空間。
pm trim-caches	要求系統一直丟掉快取檔案，直到剩下你指定的空間為止。
find	走過一棵目錄樹，印出符合條件的東西——大檔案、空資料夾、殘留物。

其他系統服務（dumpsys）指令

指令	做什麼
dumpsys battery	電池服務目前的狀態：電量、充電狀態、健康度、電壓與溫度。
dumpsys thermalservice	手機是不是正在因為溫度而降速，以及硬體層回報的每一個溫區，單位是攝氏。
dumpsys sensorservice	手機上的每一個感測器，含廠商、type、取樣率與批次能力，以及一段近期讀數的緩衝。
dumpsys meminfo	哪些行程最吃記憶體，量的是 PSS（按比例分攤的用量）。
dumpsys package	套件管理員知道的一切：版本、路徑、flags、安裝來源，以及每個使用者的狀態。
dumpsys activity activities	現在哪個 app 在前景，以及它背後的 task 與 stack 結構。
dumpsys dropbox	平台用來存放當機、ANR 與 tombstone 的環形緩衝——這是不用 root 讀 ANR 追蹤的方法。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `shell` 使用者身分執行，可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入，以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事：讀取其他 app 的私有資料（除了對可除錯版本使用 `run-as`）、寫入系統分割區，或直接讀 `/data/anr`。

為什麼在我的手機上輸出看起來不一樣？

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的，那些都在各指令頁註明了。其餘是廠商改動，而受影響最深的是 `dumpsys`：一份 dump 是除錯輸出，它的文字就是那個服務的作者最後印了什麼，而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位，並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎？

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話，不必安裝 SDK，也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道：同一時間只有一個程式能持有 ADB 介面，所以桌面的 `adb server` 要先停掉；而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。

比較想按而不是打字？Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。

語法

範例