如何過濾adb logcat輸出
本文介紹如何在 shell 命令行中過濾 adb logcat 輸出的幾個小技巧。
開發當中經常看到別人的 log 如洪水般瞬間刷滿了屏幕,對自己有用的信息都被淹沒了,影響心情也影響效率。下面是幾個我所知道的過濾方法。
1. 只顯示需要的輸出,白名單
最方便的當然是通過管道使用 grep 過濾了,這樣可以使用 grep 強大的正則表達式匹配。簡單的匹配一行當中的某個字符串,例如 MyApp:
adb logcat | grep MyApp
adb logcat | grep -i myapp #忽略大小寫。
adb logcat | grep --color=auto -i myapp #設置匹配字符串顏色。更多設置請查看 grep 幫助。
進階一點可以使用 grep 的正則表達式匹配。例如上一個例子會匹配一行中任意位置的 MyApp,可以設置為僅匹配 tag。默認的 log 輸出如下,如果修改過輸出格式相應的表達式也要修改。
I/CacheService( 665): Preparing DiskCache for all thumbnails.
可以看出 tag 是一行開頭的第三個字符開始,根據這點寫出表達式:
adb logcat | grep "^..MyApp"
根據這個格式也可以設置只顯示某個優先級的 log,再匹配行首第一個字符即可。例如僅顯示 Error 級別 tag 為 MyApp 的輸出:
adb logcat | grep "^E.MyApp"
當然也可以匹配多個,使用 | 分割多個匹配表達式,要加轉義符。例如要匹配 tag 為 MyApp 和 MyActivity 的輸出:
adb logcat | grep "^..MyApp\|^..MyActivity"
adb logcat | grep -E "^..MyApp|^..MyActivity" #使用 egrep 無須轉義符
2. 過濾不需要的輸出,黑名單
還是使用 grep,用法也跟上面的一樣,加一個 -v 即可。例如要過濾 tag 為 MyApp 和 MyActivity 的輸出:
adb logcat | grep -v "^..MyApp\|^..MyActivity"
adb logcat | grep -vE "^..MyApp|^..MyActivity" #使用 egrep 無須轉義符
3. 顯示同一個進程的所有輸出
有時一個程序裡面的 tag 有多個,需要輸出該程序(同一個 PID)的所有 tag;僅使用 tag 過濾有時也會漏掉一些錯誤信息,而一般錯誤信息也是和程序同一個 PID。還是通過 grep 實現,思路是先根據包名找到 pid 號,然後匹配 pid。寫成 shell 腳本如下,參數是程序的 java 包名(如 com.android.media)。
查看源代碼打印幫助
1 #!/bin/bash
2 packageName=$1
3 pid=`adb shell ps | grep $packageName | awk '{print $2}'`
4 adb logcat | grep --color=auto $pid
4. 從當前開始顯示
logcat 有緩存,如果僅需要查看當前開始的 log,需要清空之前的。
adb logcat -c && adb logcat
5. 過濾 log 文件
有時需要分析 log 文件,過濾 log 文件還是使用 grep。例如 log 文件為 myapp.log,要匹配 tag 為 MyApp 和 MyActivity 的輸出,然後輸出到 newmyapp.log:
cat myapp.log | grep "^..MyApp\|^..MyActivity" > newmyapp.log
Windows 下推薦使用 Notepad++,一個免費強大的記事本,支持正則表達式查找替換。可以高亮顯示匹配內容,也可以刪除不需要的內容。
以上的技巧主要用到了 grep,其實 logcat 本身也有過濾功能,可以根據 tag、優先級過濾 log,具體請參考 Android 官方文檔 Reading and Writing Logs。如果喜歡使用圖形界面,請參考 Using DDMS,DDMS 裡面的 logcat 也可以同樣過濾。
android的logcat詳細用法
Android日志系統提供了記錄和查看系統調試信息的功能。日志都是從各種軟件和一些系統的緩沖區中記錄下來的,緩沖區可以通過 logcat 命 令來查看和使用.
使用logcat命令
你可以用 logcat 命令來查看系統日志緩沖區的內容:
[adb] logcat [<option>] ... [<filter-spec>] ...
請查看Listing of logcat Command Options ,它有對logcat命 令有詳細的描述 .
你也可以在你的電腦或運行在模擬器/設備上的遠程adb shell端來使用logcat命 令,也可以在你的電腦上查看日志輸出。
$ adb logcat
你也這樣使用:
# logcat
過濾日志輸出
每一個輸出的Android日志信息都有一個標簽和它的優先級.
日志的標簽是系統部件原始信息的一個簡要的標志。(比如:“View”就 是查看系統的標簽).
優先級有下列集中,是按照從低到高順利排列的:
V — Verbose (lowest priority)
D — Debug
I — Info
W — Warning
E — Error
F — Fatal
S — Silent (highest priority, on which nothing is ever printed)
在運行logcat的時候在前兩列的信息中你就可以看到 logcat 的標簽列表和優先級別,它是這樣標出的:<priority>/<tag> .
下面是一個logcat輸出的例子,它的優先級就似乎I,標簽 就是ActivityManage:
I/ActivityManager( 585): Starting activity: Intent { action=android.intent.action...}
為了讓日志輸出能體現管理的級別,你還可以用過濾器來控制日志輸出,過濾器可以幫助你描述 系統的標簽等級.
過濾器語句按照下面的格式描tag:priority ... , tag 表 示是標簽,priority 是表示標簽的報告的最低等級. 從上面的tag的中可以得到日志的優先級. 你可以在過濾器中多次寫tag:priority .
這些說明都只到空白結束。下面有一個列子,例子表示支持所有的日志信息,除了那些標簽 為”ActivityManager”和優先級為”Info”以上的和標簽為” MyApp”和優先級為” Debug”以上的。 小等級,優先權報告為tag.
adb logcat ActivityManager:I MyApp:D *:S
上面表達式的最後的元素 *:S ,,是設置所有的標 簽為”silent”,所有日志只顯示有”View” and “MyApp”的,用 *:S 的另一個用處是 能夠確保日志輸出的時候是按照過濾器的說明限制的,也讓過濾器也作為一項輸出到日志中.
下面的過濾語句指顯示優先級為warning或更高的日志信息:
adb logcat *:W
如果你電腦上運行logcat ,相比在遠程adbshell端,你還可以 為環境變量ANDROID_LOG_TAGS :輸入一個參數來設置默認的過濾
export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"
需要注意的是ANDROID_LOG_TAGS 過濾器如果 通過遠程shell運行logcat 或 用adb shell logcat 來 運行模擬器/設備不能輸出日志.
控制 日志輸出格式
日志信息包括了許多元數據域包括標簽和優先級。可以修改日志的輸出格式,所以可以顯示出特 定的元數據域。可以通過 -v 選項得到格式化輸出日志的相關信息.
brief — Display priority/tag and PID of originating process (the default format).
process — Display PID only.
tag — Display the priority/tag only.
thread — Display process:thread and priority/tag only.
raw — Display the raw log message, with no other metadata fields.
time — Display the date, invocation time, priority/tag, and PID of the originating process.
long — Display all metadata fields and separate messages with a blank lines.
當啟動了logcat ,你可以通過-v 選 項來指定輸出格式:
[adb] logcat [-v <format>]
下面是用 thread 來產生的日志格式:
adb logcat -v thread
需要注意的是你只能-v 選項來規定輸出格式 option.
查看 可用日志緩沖區
Android日志系統有循環緩沖區,並不是所有的日志系統都有默認循環緩沖區。為了得到 日志信息,你需要通過-b 選項來啟動logcat 。如果要使用循環緩沖區,你需要查看剩余的 循環緩沖期:
radio — 查看緩沖區的相關的信息.
events — 查看和事件相關的的緩沖區.
main — 查看主要的日志緩沖區
-b 選項使用方法:
[adb] logcat [-b <buffer>]
下面的例子表示怎麼查看日志緩沖區包含radio 和 telephony信息:
adb logcat -b radio
查看 stdout 和stderr
在默認狀態下,Android系統有stdout 和 stderr (System.out和System.err ) 輸出到/dev/null , 在運行Dalvik VM的進程中,有一個系統可以備份日志文件。在這種情況下,系統會用stdout 和stderr 和 優先級 I.來記錄日志信息
通過這種方法指定輸出的路徑,停止運行的模擬器/設備,然後通過用setprop 命 令遠程輸入日志
$ adb shell stop
$ adb shell setprop log.redirect-stdio true
$ adb shell start
系統直到你關閉模擬器/設備前設置會一直保留,可以通過添加/data/local.prop 可 以使用模擬器/設備上的默認設置
Logcat命令列表
Option Description
-b <buffer> 加載一個可使用的日志緩沖區供查看,比如event 和radio . 默認值是main 。具體查看Viewing Alternative Log Buffers.
-c 清楚屏幕上的日志.
-d 輸出日志到屏幕上.
-f <filename> 指定輸出日志信息的<filename> , 默認是stdout .
-g 輸出指定的日志緩沖區,輸出後退出.
-n <count> 設置日志的最大數目<count> ., 默認值是4,需要和 -r 選 項一起使用。
-r <kbytes> 每<kbytes> 時 輸出日志,默認值為16,需要和-f 選 項一起使用.
-s 設置默認的過濾級別為silent.
-v <format> 設置日志輸入格式,默認的是brief 格 式,要知道更多的支持的格式,參看Controlling Log Output Format .