Struct RunTraceWriter 

pub struct RunTraceWriter { /* private fields */ }

Run-specific trace writer

Generates trace files for run command failures with run-specific context and metadata.

Example

use std::path::PathBuf;
use std::sync::Arc;
use torrust_tracker_deployer_lib::infrastructure::trace::RunTraceWriter;
use torrust_tracker_deployer_lib::shared::SystemClock;

let traces_dir = PathBuf::from("data/my-env/traces");
let clock = Arc::new(SystemClock);
let writer = RunTraceWriter::new(traces_dir, clock);

Implementations

impl RunTraceWriter

pub fn new(traces_dir: impl Into<PathBuf>, clock: Arc<dyn Clock>) -> Self

Create a new run trace writer

pub fn write_trace<E: Traceable>( &self, ctx: &RunFailureContext, error: &E, ) -> Result<PathBuf, TraceWriterError>

Write a run failure trace file

Generates a trace file with run-specific context and logs the outcome. Success is logged at INFO level, failures at WARN level.

Arguments

• ctx - The run failure context with metadata
• error - The error that implements Traceable for chain extraction

Returns

Path to the generated trace file

Errors

Returns an error if directory creation or file writing fails

pub fn traces_dir(&self) -> &Path

Get the traces directory path