android logcat 命令详解

-b <buffer> 指定要查看的日志缓冲区，可以是system,events ,radio,main . 默认值是system和main 。

-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 

参数<filter-spec>

<filter-spec>以“tag:priority”的形式来对日志输出进行过滤的

优先级priority有以下几种，按照从低到高顺利排列如下:

V — Verbose (lowest priority) 对应于Log.i()系列函数

D — Debug 对应于Log.d()系列函数

I — Info 对应于Log.i()系列函数

W — Warning 对应于Log.w()系列函数

E — Error 对应于Log.e()系列函数

F — Fatal 对应于Log.wtf()系列函数

S — Silent (highest priority, on which nothing s ever printed)

在运行logcat的时候在前两列的信息中你就可以看到 logcat 的标签列表和优先级别,它是这样标出的:<priority>/<tag> .

<filter-spec>中的优先级是指显示该优先级即其以上优先级得日志。比如对于robin:D表示显示tag为robin的所有Debug及其以上优先级的日志。<filter-spec>只是的针对某类的tag的日志进行过滤，如果有多个针对同一个tag的过滤的话，以最后一个为准。另外对于tag,可以使用通配符。对于在tag中没有使用统配符的<filter-spec>，我称它为显式的日志过滤器；而对于在tag中使用统配符的，我称它它为隐式的日志过滤器。如果这两种过滤器有对着同一个tag的过滤的话，以显示的日志过滤器为准。如果是同一种的话（显式/隐式），以后一个为准。

因为<filter-spec>只是指明了对某一类tag应该进行如何过滤，它没说明的其他tag,将采用系统默认的方式（*:V）,即全部输出。我们可以通过选项"-s"来设置<filter-spec>中没有说明的tag来都不输出，相当于"*.S"

实例1：

adb logcat -s robin:i

这样将显现tag为robin的Info及以上优先级的所有的日志。该命令等同于adb logcat robin:i *:S

1. 解析 adb logcat 的帮助信息

 

在命令行中输入 adb logcat --help 命令, 就可以显示该命令的帮助信息;

 

adb logcat 命令格式 : adb logcat [选项] [过滤项], 其中 选项 和 过滤项 在 中括号 [] 中, 说明这是可选的;

 

(1) 选项解析

 

选项解析 : 

-- "-s"选项 : 设置输出日志的标签, 只显示该标签的日志;

--"-f"选项 : 将日志输出到文件, 默认输出到标准输出流中, -f 参数执行不成功;

--"-r"选项 : 按照每千字节输出日志, 需要 -f 参数, 不过这个命令没有执行成功;

--"-n"选项 : 设置日志输出的最大数目, 需要 -r 参数, 这个执行 感觉 跟 adb logcat 效果一样;

--"-v"选项 : 设置日志的输出格式, 注意只能设置一项;

--"-c"选项 : 清空所有的日志缓存信息;

--"-d"选项 : 将缓存的日志输出到屏幕上, 并且不会阻塞;

--"-t"选项 : 输出最近的几行日志, 输出完退出, 不阻塞;

--"-g"选项 : 查看日志缓冲区信息;

--"-b"选项 : 加载一个日志缓冲区, 默认是 main, 下面详解;

--"-B"选项 : 以二进制形式输出日志;

 

.

输出指定标签内容 : 

-- "-s"选项 : 设置默认的过滤器, 如 我们想要输出 "System.out" 标签的信息, 就可以使用adb logcat -s System.out 命令;

 

 

输出日志信息到文件 : 

-- "-f"选项 : 该选向后面跟着输入日志的文件, 使用adb logcat -f /sdcard/log.txt 命令, 注意这个log文件是输出到手机上，需要指定合适的路径。

 

 

这个参数对对不能一直用电脑连着手机收集日志的场景非常有用，其实android shell下也有一个相同参数的logcat命令。使用如下命令可以执行后断开PC和手机持续收集LOG。

 

 

注：

（1）以上shell@pc$ 指在pc的shell终端执行后边的命令， shell@android$ 表示在手机shell中执行后边的命令l

 

（2）一定注意合适的时候需要停止掉以上命令，否则再次使用相同命令的时候，就会有两个logcat写同一个文件了

          停止方法:  adb shell kill -9 <logcat_pid>         

           其中logcat_pid 通过 如下命令获取

           adb shell ps | grep logcat          # linux 平台

           adb shell ps | findstr "logcat"    #Windows平台

 

-- ">"输出 : ">" 后面跟着要输出的日志文件, 可以将 logcat 日志输出到文件中, 使用adb logcat > log 命令, 使用more log 命令查看日志信息;

 

 

-- " -d -f <log>" 组合命令：可以将日志保存到手机上的指定位置，对不能一直用电脑连着手机收集日志的场景非常有用。

 

指定 logcat 的日志输出格式 : 

-- "-v"选项 : 使用adb logcat -v time 命令, 可以啥看日志的输出时间;

              使用adb logcat -v threadtime 命令, 可以啥看日志的输出时间和线程信息;

-- "brief"格式 : 这是默认的日志格式" 优先级 / 标签 (进程ID) : 日志信息 ", 使用adb logcat -v prief 命令;

 

-- "process"格式 : " 优先级 (进程ID) : 日志信息 ", 使用adb logcat -v process 命令;

 

-- "tag"格式 : " 优先级 / 标签 : 日志信息", 使用adb logcat -v tag 命令;

 

-- "thread"格式 : " 优先级 ( 进程ID : 线程ID) 标签 : 日志内容 ", 使用adb logcat -v tag 命令;

 

-- "raw"格式 : 只输出日志信息, 不附加任何其他 信息, 如 优先级 标签等, 使用adb logcat -v raw 命令;

 

-- "time"格式 : "日期 时间 优先级 / 标签 (进程ID) : 进程名称 : 日志信息 ", 使用adb logcat -v time 命令;

 

-- "long"格式:" [ 日期 时间 进程ID : 线程ID 优先级 / 标签] 日志信息 ", 输出以上提到的所有的头信息, 使用adb logcat -v long 命令;

 

清空日志缓存信息 : 使用 adb logcat -c 命令, 可以将之前的日志信息清空, 重新开始输出日志信息;


将缓存日志输出 : 使用 adb logcat -d 命令, 输出命令, 之后推出命令, 不会进行阻塞;

 

输出最近的日志 : 使用adb logcat -t 5 命令, 可以输出最近的5行日志, 并且不会阻塞;

 

查看日志缓冲区信息 : 使用 adb logcat -g 命令;

 

加载日志缓冲区 : 使用 adb logcat -b 缓冲区类型 命令;

-- Android中的日志缓冲区 : system缓冲区 - 与系统相关的日志信息, radio缓冲区 - 广播电话相关的日志信息, events缓冲区 - 事件相关的日志信息, main缓冲区 - 默认的缓冲区;

 

以二进制形式输出日志 : 使用 adb logcat -B 命令;

 

 

 

(2) 过滤项解析

 

过滤项格式 : <tag>[:priority] , 标签:日志等级, 默认的日志过滤项是 " *:I " ;

-- V : Verbose (明细);

-- D : Debug (调试);

-- I : Info (信息);

-- W : Warn (警告);

-- E : Error (错误);

-- F: Fatal (严重错误);

-- S : Silent(Super all output) (最高的优先级, 可能不会记载东西);

 

过滤指定等级日志 : 使用 adb logcat 10 *:E 命令, 显示 Error 以上级别的日志;

 

过滤指定标签等级日志 : 使用 adb logcat WifiHW:D *:S 命令进行过滤;

-- 命令含义 : 输出10条日志, 日志是 标签为 WifiHW, 并且优先级 Debug(调试) 等级以上的级别的日志;

--注意 *:S : 如果没有 *S 就会输出错误;

 

 

可以同时设置多个过滤器 : 使用adb logcat WifiHW:D dalvikvm:I *:S 命令, 输出 WifiHW 标签 的 Debug 以上级别 和 dalvikvm 标签的 Info 以上级别的日志;

 

2. 使用管道过滤日志

 

(1) 过滤固定字符串

 

过滤固定字符串 : 只要命令行出现的日志都可以过滤, 不管是不是标签;

-- 命令 : adb logcat | grep Wifi ;

 

过滤字符串忽略大小写 : adb logcat | grep -i wifi ;

 

 

(2) 使用正则表达式匹配

 

分析日志 : 该日志开头两个字符是 "V/", 后面开始就是标签, 写一个正则表达式 "^..ActivityManager", 就可以匹配日志中的 "V/ActivityManager" 字符串;

 

正则表达式过滤日志: 使用上面的正则表达式组成命令 adb logcat | grep "^..Activity" ;