1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166
//! Trace of a simulation.
use serde::{Deserialize, Serialize};
use crate::system::HostConfig;
/// One trace event in a simulation.
#[derive(Clone, Serialize, Deserialize)]
#[serde(tag = "type")]
pub enum TraceEvent {
/// Task stage is ready.
TaskReady {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
/// Stage id.
stage_id: usize,
/// Task id.
task_id: usize,
},
/// Task is waiting in a queue of a specific host for enough resources to start.
TaskInQueue {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
/// Stage id.
stage_id: usize,
/// Task id.
task_id: usize,
/// Host.
host: String,
},
/// Task is assigned to a host and waits for input data to be transfered.
TaskAssigned {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
/// Stage id.
stage_id: usize,
/// Task id.
task_id: usize,
/// Host.
host: String,
},
/// Task started processing input.
TaskStarted {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
/// Stage id.
stage_id: usize,
/// Task id.
task_id: usize,
/// Number of cores used.
cores: u32,
/// Amount of memory used.
memory: u64,
/// Host where the task was run.
host: String,
},
/// Task finished processing input.
TaskCompleted {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
/// Stage id.
stage_id: usize,
/// Task id.
task_id: usize,
},
/// Dag received by [Runner](crate::runner::Runner).
DagStarted {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
},
/// Dag completed.
DagCompleted {
/// Time of the event.
time: f64,
/// DAG id.
dag_id: usize,
},
}
impl TraceEvent {
/// Time of an event.
pub fn time(&self) -> f64 {
match self {
TraceEvent::TaskReady { time, .. }
| TraceEvent::TaskInQueue { time, .. }
| TraceEvent::TaskAssigned { time, .. }
| TraceEvent::TaskStarted { time, .. }
| TraceEvent::TaskCompleted { time, .. }
| TraceEvent::DagStarted { time, .. }
| TraceEvent::DagCompleted { time, .. } => *time,
}
}
/// (dag id, stage id, task id) if the event corresponds to a task.
pub fn task_path(&self) -> Option<(usize, usize, usize)> {
match self {
TraceEvent::TaskReady {
dag_id,
stage_id,
task_id,
..
}
| TraceEvent::TaskInQueue {
dag_id,
stage_id,
task_id,
..
}
| TraceEvent::TaskAssigned {
dag_id,
stage_id,
task_id,
..
}
| TraceEvent::TaskStarted {
dag_id,
stage_id,
task_id,
..
}
| TraceEvent::TaskCompleted {
dag_id,
stage_id,
task_id,
..
} => Some((*dag_id, *stage_id, *task_id)),
_ => None,
}
}
}
/// Trace of a simulation.
#[derive(Clone, Serialize, Deserialize)]
pub struct Trace {
/// Information about hosts.
pub hosts: Vec<HostConfig>,
/// Simulation events.
pub events: Vec<TraceEvent>,
}
impl Trace {
/// Creates new trace.
pub fn new(hosts: Vec<HostConfig>) -> Self {
Self {
hosts,
events: Vec::new(),
}
}
/// Adds event to a trace.
pub fn log(&mut self, event: TraceEvent) {
self.events.push(event);
}
}