cellular-infrastructure
/
osmo-gsm-manuals
mirror of https://gerrit.osmocom.org/osmo-gsm-manuals
9
0
Fork 0
Code Releases Activity

Logging: Describe all log options, including set-all and force-all 

Change-Id: Ica03c3ea08289314819448a22ae7ed38a7bd4f83
This commit is contained in:
Daniel Willmann 2018-11-06 09:02:26 +01:00 committed by Harald Welte
parent 987aa54d56
commit 6e5b7d3cdc
1 changed files with 47 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
common/chapters/logging.adoc
View File

@ -70,6 +70,53 @@ So for example, in OsmoBSC, to set the log level of the Mobility
Management category to info, you can use the following command:
`log level mm info`.
There is also a special command to set all categories as a one-off to a desired
log level. For example, to silence all messages but those logged as notice and
above issue the command: `log level set-all notice`
Afterwards you can adjust specific categories as usual.
A similar command is `log level force-all <level>` which causes all categories
to behave as if set to log level <level> until the command is reverted with
`no log level force-all` after which the individually-configured log levels will
again take effect. The difference between `set-all` and `force-all` is that
`set-all` actually changes the individual category settings while `force-all`
is a (temporary) override of those settings and does not change them.
[[log_options]]
=== Log printing options
The logging system has various options to change the information
displayed in the log message.
log color 1::
With this option each log message will log with the color of its
category. The color is hard-coded and can not be changed. As with
other options a '0' disables this functionality.
log timestamp 1::
Includes the current time in the log message. When logging to syslog
this option should not be needed, but may come in handy when debugging
an issue while logging to file.
log print extended-timestamp 1::
In order to debug time-critical issues this option will print a
timestamp with millisecond granularity.
log print category 1::
Prefix each log message with the category name.
log print category-hex 1::
Prefix each log message with the category number in hex ('<000b>').
log print level 1::
Prefix each log message with the name of the log level.
log print file 1::
Prefix each log message with the source file and line number. Append
the keyword `last` to append the file information instead of prefixing
it.
[[log_filters]]
=== Log filters