JobsΒΆ

The main Batsim output file is exported as prefix + _jobs.csv (see Command-line Interface).

This file is formatted as CSV (with a header) and give information about jobs. There is one line per job. This file has the following fields in this order.

  • job_id, the job identifier. Value is unique within a workload.
  • workload_name, the name of the workload the job belongs to.
  • profile, the name of the profiles that defines how the job should be simulated.
  • submission_time, the (simulation world) time (in seconds) at which the job has been submitted.
  • requested_number_of_resources, the number of resources requested by the job.
  • requested_time, the requested time of the job (walltime).
  • success, whether the job has completed before reaching its walltime and returned 0.
  • final_state, the job final state. Possible values include the following.
    • COMPLETED_SUCCESSFULLY: Job executed without reaching walltime, with zero exit code.
    • COMPLETED_FAILED: Job executed without reaching walltime, with non-zero exit code.
    • COMPLETED_WALLTIME_REACHED: Job executed but reached its walltime (killed automatically).
    • COMPLETED_KILLED: Job executed but killed by the decision process.
    • REJECTED: Job not executed, it was rejected by the decision process.
  • starting_time, the (simulation world) time (in seconds) at which the job execution has been started.
  • execution_time, the (simulation world) duration (in seconds) of the job execution. Equals to \(finish\_time - starting\_time\).
  • finish_time, the (simulation world) time (in seconds) at which the job execution has finished.
  • waiting_time, the (simulation world) time (in seconds) the job waited before being executed. Equals to \(starting\_time - submission\_time\).
  • turnaround_time, the time the job spend in the system. Equals to \(finish\_time - submission\_time\).
  • stretch: equals to \(turnaround\_time / execution\_time\).
  • consumed_energy, the total amount of energy (in joules) consumed by the allocated_resources during the execution of the job. Warning: no energy sharing or allocation is done in case there is more than one job running on a machine.
  • allocated_resources, the resources onto which the job has been allocated (see Interval set string representation).
  • metadata, user-specified metadata about the job (empty string by default).

Please note that many fields can have empty values for jobs that have been rejected.