Skip to contents

Read per-rep resource logs written by landis_run_docker() / landis_run_local()

read_landis_resource_logs.Rd

Discovers all docker_resources.log and local_resources.log files under run_dir (typically a scenario directory containing per-rep subdirectories) and returns one row per rep with every key-value pair the run helpers wrote. Always includes elapsed_sec and peak_mem_bytes; rows from runs produced by landisutils >= 0.0.22 additionally include host_cpu_model, host_cpu_cores, and host_ram_bytes. Older logs return NA for missing fields.

Usage

read_landis_resource_logs(run_dir)

Arguments

run_dir

Character. Scenario directory to search (recursively) for resource logs. Returns an empty data.frame when run_dir does not exist or contains no logs.

Value

A data.frame with columns replicate, source (one of "docker" or "local"), and one numeric or character column per recorded key.

Details

Used by per-scenario report templates to surface run-time / memory / host statistics in build-provenance appendices.

See also

Other LANDIS-II execution helpers: host_cpu_info(), landis_find(), landis_find_docker(), landis_pool_exec(), landis_pool_restart_one(), landis_pool_start(), landis_pool_stop(), landis_replicate(), landis_run_docker(), landis_run_local(), tar_landis(), write_landis_scenario_file()