Expand description
Diagnostic logging system for Ralph orchestration.
Captures agent output, orchestration decisions, traces, performance metrics,
and errors to structured JSONL files when RALPH_DIAGNOSTICS=1 is set.
Structs§
- Agent
Output Entry - Single agent output entry in JSONL format.
- Agent
Output Logger - Logger for agent output events.
- Diagnostic
Stream Handler - Wrapper that logs agent output while delegating to inner handler.
- Diagnostic
Trace Layer - Diagnostics
Collector - Central coordinator for diagnostic logging.
- Error
Logger - Hook
RunLogger - JSONL writer for hook invocation telemetry (
hook-runs.jsonl). - Hook
RunTelemetry Entry - Structured diagnostics record persisted for each hook invocation.
- Orchestration
Logger - Performance
Logger - Trace
Entry
Enums§
- Agent
Output Content - Types of agent output content.
- Diagnostic
Error - Hook
Disposition - Final outcome category for a hook invocation.
- Orchestration
Event - Performance
Metric
Functions§
- create_
log_ file - Creates a new timestamped log file in
.ralph/diagnostics/logs/. - rotate_
logs - Rotates log files in the given directory, keeping at most
max_filesentries.