xref: /aosp_15_r20/system/logging/logd/README.property (revision 598139dc91b21518d67c408eaea2644226490971)
1The properties that logd and friends react to are:
2
3name                       type default  description
4ro.logd.auditd             bool   true   Enable selinux audit daemon
5ro.logd.auditd.dmesg       bool   true   selinux audit messages sent to dmesg.
6ro.logd.auditd.main        bool   true   selinux audit messages sent to main.
7ro.logd.auditd.events      bool   true   selinux audit messages sent to events.
8persist.logd.security      bool   false  Enable security buffer.
9ro.organization_owned      bool   false  Override persist.logd.security to false
10ro.logd.kernel             bool  svelte+ Enable klogd daemon
11ro.debuggable              number        if not "1", ro.logd.kernel defaults to false.
12logd.logpersistd.enable    bool   auto   Safe to start logpersist daemon service
13logd.logpersistd          string persist Enable logpersist daemon, "logcatd"
14                                         turns on logcat -f in logd context.
15					 Responds to logcatd, clear and stop.
16logd.logpersistd.buffer          persist logpersistd buffers to collect
17logd.logpersistd.size            persist logpersistd size in MB
18logd.logpersistd.rotate_kbytes   	 persist logpersistd outout file size in KB.
19persist.logd.logpersistd   string        Enable logpersist daemon, "logcatd"
20                                         turns on logcat -f in logd context.
21persist.logd.logpersistd.buffer    all   logpersistd buffers to collect
22persist.logd.logpersistd.size      256   logpersistd size in MB
23persist.logd.logpersistd.count     256   sets max number of rotated logs to <count>.
24persist.logd.logpersistd.rotate_kbytes   1024  logpersistd output file size in KB
25persist.logd.size          number  ro    Global default size of the buffer for
26                                         all log ids at initial startup, at
27                                         runtime use: logcat -b all -G <value>
28ro.logd.size               number svelte default for persist.logd.size. Larger
29                                         platform default sizes than 256KB are
30                                         known to not scale well under log spam
31                                         pressure. Address the spam first,
32                                         resist increasing the log buffer.
33persist.logd.size.<buffer> number  ro    Size of the buffer for <buffer> log
34ro.logd.size.<buffer>      number svelte default for persist.logd.size.<buffer>
35ro.config.low_ram          bool   false  if true, ro.logd.kernel defaults to false,
36                                         and (if ro.debuggable is unset/false)
37                                         logd.size is 64K instead of 256K.
38persist.logd.filter        string        Pruning filter to optimize content.
39                                         At runtime use: logcat -P "<string>"
40ro.logd.filter       string "~! ~1000/!" default for persist.logd.filter.
41                                         This default means to prune the
42                                         oldest entries of chattiest UID, and
43                                         the chattiest PID of system
44                                         (1000, or AID_SYSTEM).
45log.tag                   string persist The global logging level, VERBOSE,
46                                         DEBUG, INFO, WARN, ERROR, ASSERT or
47                                         SILENT. Only the first character is
48                                         the key character.
49persist.log.tag            string build  default for log.tag
50log.tag.<tag>             string persist The <tag> specific logging level.
51persist.log.tag.<tag>      string build  default for log.tag.<tag>
52
53logd.buffer_type           string (empty) The log buffer type: 'simple' or
54                                          'serialized' (default: 'serialized').
55
56NB:
57- auto - managed by /init
58- svelte - see ro.config.low_ram for details.
59- svelte+ - If empty, default to true if `ro.config.low_ram == false && ro.debuggable == true`
60- ro - <base property> temporary override, ro.<base property> platform default.
61- persist - <base property> override, persist.<base property> platform default.
62- build - VERBOSE for native, DEBUG for jvm isLoggable, or developer option.
63- number - support multipliers (K or M) for convenience. Range is limited
64  to between 64K and 256M for log buffer sizes. Individual log buffer ids
65  such as main, system, ... override global default.
66- Pruning filter rules are specified as UID, UID/PID or /PID. A '~' prefix indicates that elements
67  matching the rule should be pruned with higher priority otherwise they're pruned with lower
68  priority. All other pruning activity is oldest first. Special case ~! represents an automatic
69  pruning for the noisiest UID as determined by the current statistics.  Special case ~1000/!
70  represents pruning of the worst PID within AID_SYSTEM when AID_SYSTEM is the noisiest UID.
71