koog-agents-optimization/ai.koog.agents.optimization.training/TrainingLogging

TrainingLogging

Log formatting utilities for the training infrastructure.

Reads metrics from StageRecord.metrics to build console log strings.

Functions

fun buildSessionBeginConsoleLog(trainingName: ExperimentName, recordsFilePath: ResilientPath?): String

One-line message announcing the start of a training session and where its records will be written (recordsFilePath may be null, rendered as a "not persisted" hint).

buildSessionFinishedConsoleLog

fun buildSessionFinishedConsoleLog(rootRecord: StageRecord): String

Multi-line summary of a finished session: total elapsed time, consumption, per-stage substage counts, the overall session summary (stages finished/completed/failed, failure and solved rates), and any root failure. Reads aggregated values from StageRecord.metrics.

buildStageBeginConsoleLog

fun buildStageBeginConsoleLog(name: String, stagePath: List<String>, parentRecord: StageRecord): String

One-line message announcing the start of a stage, prefixed with its ancestor path (derived from stagePath) and optionally a parent ETC hint read from parentRecord.

buildStageFinishedConsoleLog

fun buildStageFinishedConsoleLog(stageRecord: StageRecord, stagePath: List<String>, parentRecord: StageRecord?): String

Multi-line summary of a finished stage: substage counts, timing (elapsed, averages, ETC), dataset results when present, consumption, any failure, and an optional parent ETC hint. Reads aggregated values from StageRecord.metrics; parentRecord is null for top-level stages.