logcat命令详解

Android日志系统提供了记录和查看系统调试信息的功能。日志都是从各种软件和一些系统的缓冲区中记录下来的，缓冲区可以通过logcat命令来查看和使用.

在使用 logcat 之前，请确保手机的 USB调试模式 已经开启，可以通过" Setting->Application->Development-> USB debugging"来开启。

logcat本身是android的shell的一个命令，你可以通过“adb shell”进入shell后执行logcat命令,也可以通过"adb logcat"直接运行。

语法：

[adb] logcat [<option>] ... [<filter-spec>] ...

选项：

-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的 日志输出进行过滤。每一个输出的Android日志信息都有一个tag和它的优先级.

日志的标签是系统部件原始信息的一个简要的标志。这个tag就是Log.i,Log.d,Log.i,Log.w,Log.e,Log.wtf系列函数中的tag.

对于 System.out.print 系列函数所对于的tag,其实就是"System.out"

<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

-b 选项

该选项用于指定要操作的日志缓冲区，可以是 system , events  , radio , main  .它们分别对应Android手机上 /dev/log 文件夹下的 system , events  , radio , main 日志文件 。系统默认的是 system 和 main  。该选项可以出现多次，以指定多个日志缓冲去。

比如：

adb logcat -b system -b main -b events -b radio -s robin:i

日志输出的开头几行说明了你当前查看的哪些日志缓冲区，比如上面的语句的前几行就是：

--------- beginning of /dev/log/radio

--------- beginning of /dev/log/events

--------- beginning of /dev/log/system

--------- beginning of /dev/log/main

其实“ adb logcat -s robin:i ”相当于“ adb logcat -b system -b main -s robin:i ”。

main 缓冲区: 我们的Log.i,Log.d,Log.i,Log.w,Log.e,Log.wtf系列函数及 System.out.print 系列函数以及 System.erro.print 系列都输出到了 main 缓冲区。因此我们一般用默认的就足够了。

events 缓冲区: events 缓冲区对应的日志文件 /system/etc/event-log-tags ，使用android.util.EventLog生成的日志就输出到该缓冲区。

android.database.sqlite.SQLiteDatabase 的 logTimeStat() 函数就是使用 EventLog 来进行日志输出的

system 缓冲区：  通过 system/core/include/cutils/log.h中的 SLOGD() 宏 就是把日志输出到 System 日志缓冲。

关于此的更多内容请阅读《 在Android的c/c++代码中使用LOG 》

radio 缓冲区: 这个是什么代码输出呢？puzzle me!

-c 选项

该选项用于清空你所指定的日志缓冲区。应该就是清除其对应的日志文件

-s 选项

该选项将把 tag 的默认过滤级别设置为 silent ,这样tag默认就不显示。系统把tag的默认过滤级别是设置为Verbose,这样其tag默认就是要显示的。

-f 选项

该选项指定输出日志信息的<filename> ，默认是stdout . 但是这里的文件是指android系统上的文件。如果我们想把日志输出到本地window系统的话，请采用如下形式的命令：

adb logcat -s robin:i>1.log

这样日志就输出了你的window的当前目录的1.log文件中。

-v 选项

日志信息包括了许多元数据域包括标签和优先级。可以通过 -v选项 可以用来指定 日志的输出格式，以显示出特定的元数据域。

brief  —  Display priority/tag and PID of originating process (the default format).显示prority/tag,产生日志的进程的id,和日志消息本身。它是日志默认的输出格式。

process  —  Display PID only.显示priority,产生日志的进程的id,和日志消息本身

tag  —  Display the priority/tag only.显示prority/tag,和消息本身

thread  —  Display process:thread and priority/tag only.显示priority,线程和日志消息本身

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.显示产生日志的时间，prority/tag,产生日志的进程Id,和日志消息本身。

long  —  Display all metadata fields and separate messages with a blank lines.显示产生日志的时间，prority/tag,产生日志的进程Id,和日志消息本身。但是日志消息本身另其一行进行显示。每个日志之间空一行。

当启动了 logcat  ，你可以通过-v 选项来指定输出格式:

[adb] logcat [-v <format>]

实例2:

adb logcat  -v time  -s robin:v

注意是通过 -v 选项 来设置输出格式.