diff --git a/docs/logging.html.in b/docs/logging.html.in index dc1f107ee0..44171de346 100644 --- a/docs/logging.html.in +++ b/docs/logging.html.in @@ -6,17 +6,37 @@ this complements the error handling mechanism and APIs to allow tracing through the execution of the library as well as in the libvirtd daemon.

+ +

+ Logging in the library +

The logging functionalities in libvirt are based on 3 key concepts, similar to the one present in other generic logging facilities like log4j:

+

Note that the logging module saves all logs to a debug buffer + filled in a round-robin fashion as to keep a full log of the + recent logs including all debug. The debug buffer can be resized + or deactivated in the daemon using the log_buffer_size variable, + default is 64 kB. This can be used when debugging the library + (see the virLogBuffer variable content).

+ +

+ Configuring logging in the library +

The library configuration of logging is through 3 environment variables allowing to control the logging behaviour: