Log statements from the blueye.sdk

The blueye.sdk package uses the standard Python logging module to log information about the SDK's operation. The log statements are useful for debugging and troubleshooting, and can be used to get a better understanding of what is happening inside the SDK.

Note: These logs must not be confused with the divelogs that are generated and stored on the drone. See Listing and downloading logfiles for instructions on how to get the divelogs.

Events with severity WARNING or greater are printed to sys.stderr by default, but can be configured to be written to a file or sent to a remote server. See the Python logging documentation for more information about how to configure the logging module.

Enabling logging with lower severity

By default, the events with severity lower than WARNING are muted. To enable them, you need to configure the logger to capture the logs. Here's an example of how to enable debug logs:

import logging
import blueye.sdk

def enable_debug_logs():
    # Set the logger configuration
    logger = logging.getLogger(blueye.sdk.__name__)
    logger.setLevel(logging.DEBUG)

    # Define the log handler
    handler = logging.StreamHandler()
    handler.setLevel(logging.DEBUG)

    # Define the log format
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    handler.setFormatter(formatter)

    # Add the log handler to the logger
    logger.addHandler(handler)

In the example above, we import the necessary modules and create a function enable_runtime_logs() to enable the runtime logs. We configure the logger to capture logs with the logging.getLogger(blueye.sdk.__name__) statement and set the log level to DEBUG to capture all logs.

We also define a log handler to determine where the logs should be outputted. In this example, we use a logging.StreamHandler() to print the logs to the console. You can customize the log handler based on your requirements, such as writing logs to a file or sending them to a remote server.

Finally, we set the log format using logging.Formatter() and add the log handler to the logger using logger.addHandler(handler).

Disabling Logging

If you want to completely disable logging and prevent any logs from being captured, you can use a NullHandler. Here's an example:

import logging
import blueye.sdk

def disable_logging():
    # Disable all logging
    logger = logging.getLogger(blueye.sdk.__name__)
    logger.addHandler(logging.NullHandler())

In the example above, we define a function disable_logging() that sets a NullHandler to the logger. The NullHandler is a special handler that essentially discards all log records, effectively disabling logging.