Logger
walkerOS provides a centralized logging system that enables consistent logging across the collector, sources, and destinations. The logger supports three log levels and provides scoped logging for better debugging.
Configuration
Configure logging when initializing the collector:
Log levels
| Level | Value | Description |
|---|---|---|
ERROR | 0 | Only errors (default) |
INFO | 1 | Errors and informational messages |
DEBUG | 2 | All messages including debug information |
Using the logger
The logger is automatically available in destination and source contexts:
In destinations
In sources
Logger API
Methods
| Method | Description |
|---|---|
error(message, context?) | Log an error message |
info(message, context?) | Log an informational message |
debug(message, context?) | Log a debug message |
throw(message, context?) | Log an error and throw an exception (returns never) |
scope(name) | Create a scoped logger with a prefixed scope |
Error handling
The logger accepts Error objects directly and automatically extracts relevant
information:
Throwing errors
Use logger.throw() to log an error and throw in a single call:
Scoped loggers
Scoped loggers prefix log messages with context information, making it easier to trace logs to their origin:
Custom handler
For advanced use cases like sending logs to external services, configure a custom handler:
The handler receives:
| Parameter | Type | Description |
|---|---|---|
level | Level | Log level enum (ERROR=0, INFO=1, DEBUG=2) |
message | string | The log message |
context | LogContext | Additional context object |
scope | string[] | Array of scope names |
originalHandler | DefaultHandler | The default console handler |
Testing
Use the mock logger utility for testing destinations and sources:
The mock logger provides jest mock functions for all logger methods plus:
scopedLoggers: Array of scoped loggers created viascope()