New in version 2.0.0.

Logging may be enabled programmatically via couchbase_core.enable_logging() or via the environment, setting the LCB_LOGLEVEL environment variable to a value between 0 and 5.

“Programmatic” logging uses Python’s standard logging module. If you are not familiar with Python’s logging module, see https://docs.python.org/2/howto/logging.html#logging-basic-tutorial for a basic tutorial (note, the logging module is also available on Python 3)

Note the environment variable method is actually a variable interpreted by the underlying C library (libcouchbase) and is available on all C library versions starting from 2.4.0.

Note that logging messages themselves are currently limited to output from the C library


Enables integration with Python’s logging module.

This function enables the C library’s logging to be propagated to the Python standard logging module.

Calling this function affects any Client objects created afterwards (but not before). Note that currently this will also override any LCB_LOGLEVEL directive inside the environment as well.

The “root” couchbase_core logger is couchbase.