Change in osmo-gsm-manuals[master]: Logging: Describe all log options, including set-all and force-all

[daniel]

daniel has uploaded this change for review. ( https://gerrit.osmocom.org/11617


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

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

Change-Id: Ica03c3ea08289314819448a22ae7ed38a7bd4f83
---
M common/chapters/logging.adoc
1 file changed, 47 insertions(+), 0 deletions(-)



  git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/17/11617/1

diff --git a/common/chapters/logging.adoc b/common/chapters/logging.adoc
index db6afdb..a89526c 100644
--- a/common/chapters/logging.adoc
+++ b/common/chapters/logging.adoc
@@ -70,6 +70,53 @@
 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
 

-- 
To view, visit https://gerrit.osmocom.org/11617
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-MessageType: newchange
Gerrit-Change-Id: Ica03c3ea08289314819448a22ae7ed38a7bd4f83
Gerrit-Change-Number: 11617
Gerrit-PatchSet: 1
Gerrit-Owner: daniel <dwillmann at sysmocom.de>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20181106/a7d13fb9/attachment.htm>