pespin has submitted this change. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/41864?usp=email )
Change subject: logging: Improve syslog log documentation ...................................................................... logging: Improve syslog log documentation Change-Id: Ic3ab275fd1448e590a43251e226d690beee67004 --- M common/chapters/logging.adoc 1 file changed, 11 insertions(+), 1 deletion(-) Approvals: pespin: Looks good to me, approved Jenkins Builder: Verified osmith: Looks good to me, but someone else must approve laforge: Looks good to me, but someone else must approve diff --git a/common/chapters/logging.adoc b/common/chapters/logging.adoc index 4cf2e15..2275d65 100644 --- a/common/chapters/logging.adoc +++ b/common/chapters/logging.adoc @@ -358,10 +358,20 @@ `logging filter`, `logging level` as well as `logging color` and `logging timestamp`. -NOTE: Syslog daemons will normally automatically prefix every message +TIP: Syslog daemons will normally automatically prefix every message with a time-stamp, so you should disable the libosmocore time-stamping by issuing the `logging timestamp 0` command. +NOTE: Typical syslog implementations (such as glibc's one) write to _AF_UNIX_ +socket in `/dev/log` in a synchronous blocking I/O fashion, which means +transmitting a big amount of messages or text over it in a short amount of time +(before syslogd has time to read it) could potentially block the osmocom +program's thread issuing the logging. It is hence advised avoiding use of this +log target to log notable amounts of information in any osmocom program driven +by an event loop (which includes any program using a VTY), since it may block +the thread for an unspecified (potentially long or even infinite) amount of time +and hence prevent the event loop to run and process events. + ==== Logging to systemd-journal -- To view, visit https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/41864?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings?usp=email Gerrit-MessageType: merged Gerrit-Project: osmo-gsm-manuals Gerrit-Branch: master Gerrit-Change-Id: Ic3ab275fd1448e590a43251e226d690beee67004 Gerrit-Change-Number: 41864 Gerrit-PatchSet: 1 Gerrit-Owner: pespin <[email protected]> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: daniel <[email protected]> Gerrit-Reviewer: fixeria <[email protected]> Gerrit-Reviewer: laforge <[email protected]> Gerrit-Reviewer: osmith <[email protected]> Gerrit-Reviewer: pespin <[email protected]>
