Logging

Logging with the Analytics Python SDK.

The Analytics Python SDK allows logging via the standard logging module, or directly to the console.

Enabling Logging

Python Logging Module

import logging

from couchbase_analytics import LOG_DATE_FORMAT, LOG_FORMAT
from couchbase_analytics.cluster import Cluster
from couchbase_analytics.credential import Credential


# output log messages to example.log
logging.basicConfig(filename='example.log',
                    filemode='w', 
                    level=logging.DEBUG,
                    format=LOG_FORMAT,
                    datefmt=LOG_DATE_FORMAT)

logger = logging.getLogger(__name__)
# Good to set the logger's level because if the root level is not set, only WARNING level and above logs are output.
logger.setLevel(logging.DEBUG)


def main() -> None:
    # Update this to your cluster
    endpoint = 'https://--your-instance--'
    username = 'username'
    pw = 'Password!123'
    # User Input ends here.

    cred = Credential.from_username_and_password(username, pw)
    cluster = Cluster.create_instance(endpoint, cred)

    # Execute a query and buffer all result rows in client memory.
    statement = 'SELECT * FROM `travel-sample`.inventory.airline LIMIT 10;'
    res = cluster.execute_query(statement)
    all_rows = res.get_all_rows()
    for row in all_rows:
        logger.info(f'Found row: {row}')
    logger.info(f'metadata={res.metadata()}')

if __name__ == '__main__':
    main()

Logging via Environmental Settings

Only one logger can be created. Either use PYCBAC_LOG_LEVEL to create a console logger or python logging, as mentioned above.

In the command line environment, the PYCBAC_LOG_LEVEL variable is set as follows:

GNU/Linux and Mac

export PYCBAC_LOG_LEVEL=<log-level>

Windows

set PYCBAC_LOG_LEVEL=<log-level>

Where <log-level> is either error, warn, info, or debug.

Log Levels

You can increase the log level for greater verbosity (more information) in the logs:

off — disables all logging, which is normally set by default.
critical — important functionality not working.
error — error messages.
warn — error notifications.
info — useful notices, not often.
debug — diagnostic information (level required to investigate problems).