AIDK API Reference / aidk-kernel / KernelLogger

Interface: KernelLogger

Defined in: packages/kernel/src/logger.ts:181

Kernel logger interface with structured logging and context injection.

Loggers automatically inject execution context (requestId, traceId, etc.) from the current KernelContext via AsyncLocalStorage.

Example

const log = Logger.get();

// Simple message
log.info('Request received');

// With structured data
log.debug({ userId, action }, 'Processing action');

// Create child logger with bindings
const reqLog = log.child({ requestId: 'abc-123' });

// Check level before expensive operation
if (log.isLevelEnabled('trace')) {
  log.trace({ fullState: getState() }, 'State dump');
}

See

• Logger - Static methods to get/configure loggers
• LogLevel - Available log levels

Properties

Property	Type	Description	Defined in
debug	LogMethod	Log at debug level (debugging information)	packages/kernel/src/logger.ts:185
error	LogMethod	Log at error level (error conditions)	packages/kernel/src/logger.ts:191
fatal	LogMethod	Log at fatal level (severe errors)	packages/kernel/src/logger.ts:193
info	LogMethod	Log at info level (normal operations)	packages/kernel/src/logger.ts:187
level	LogLevel	Get the current log level	packages/kernel/src/logger.ts:199
trace	LogMethod	Log at trace level (very detailed debugging)	packages/kernel/src/logger.ts:183
warn	LogMethod	Log at warn level (warning conditions)	packages/kernel/src/logger.ts:189

Methods

child()

child(bindings: Record<string, unknown>): KernelLogger;

Defined in: packages/kernel/src/logger.ts:196

Create a child logger with additional bindings

Parameters

Parameter	Type
bindings	Record<string, unknown>

Returns

KernelLogger

---

isLevelEnabled()

isLevelEnabled(level: LogLevel): boolean;

Defined in: packages/kernel/src/logger.ts:202

Check if a level is enabled

Parameters

Parameter	Type
level	LogLevel

Returns

boolean