Logging

Overview

WebRunner uses Python’s logging module with a rotating file handler for logging automation events, errors, and warnings.

Configuration

Property	Value
Log file	`WEBRunner.log`
Log level	`WARNING` and above
Max file size	1 GB (rotating)
Log format	`%(asctime)s \| %(name)s \| %(levelname)s \| %(message)s`
Handler	`RotatingFileHandler` (custom `WebRunnerLoggingHandler`)

Log Output

The log file is created in the current working directory as WEBRunner.log. When the file reaches 1 GB, it is rotated.

Example log entries:

2025-01-01 12:00:00 | je_web_runner | WARNING | WebDriverWrapper find_element failed: ...
2025-01-01 12:00:01 | je_web_runner | ERROR | WebdriverManager quit, failed: ...

Logger Instance

The global logger is accessible as web_runner_logger:

from je_web_runner.utils.logging.loggin_instance import web_runner_logger

web_runner_logger.warning("Custom warning message")

All WebRunner components use this logger internally to record their operations.