Skip to main content
OpenDC2 is no longer being developed

This page documents OpenDC2. OpenDC3 can still run OpenDC2 experiment files with opendc --legacy run, but new features are only added to OpenDC3. See the OpenDC3 documentation, or Migrating to OpenDC3.

host.parquet

host.parquet has one row per host per sample. It describes the state, utilization and power draw of each host.

ColumnTypeUnitDescription
timestampint64msThe time of the sample, since the start of the simulation.
timestamp_absoluteint64msThe time of the sample, since the Unix epoch.
host_namestringThe name of the host.
cluster_namestringThe name of the cluster of the host.
core_countint32countThe number of CPU cores of the host.
mem_capacityint64MiBThe memory of the host.
tasks_terminatedint32countThe number of terminated tasks on the host.
tasks_runningint32countThe number of tasks running on the host.
tasks_errorint32countThe number of tasks on the host that failed.
tasks_invalidint32countThe number of tasks on the host in an unexpected state.
cpu_capacityfloatMHzThe total CPU capacity of the host.
cpu_usagefloatMHzThe CPU capacity used by the tasks.
cpu_demandfloatMHzThe CPU capacity the tasks ask for.
cpu_utilizationfloatratiocpu_usage divided by cpu_capacity.
cpu_time_activeint64msThe time the CPU was active, since the previous sample.
cpu_time_idleint64msThe time the CPU was idle, since the previous sample.
cpu_time_stealint64msThe time tasks wanted to run but no CPU capacity was available, since the previous sample.
cpu_time_lostint64msThe CPU time lost to interference, since the previous sample.
power_drawfloatWThe power draw of the host.
energy_usagefloatJThe energy the host used since the previous sample.
embodied_carbonfloatgThe embodied carbon of the host, for the time since the previous sample.
uptimeint64msThe time the host was up, since the previous sample.
downtimeint64msThe time the host was down, since the previous sample.
boot_timeint64msWhen the host booted.

GPU columns​

When the topology has GPUs, the file has a set of columns for each GPU of a host. The columns of the first GPU end in _0, those of the second in _1, and so on.

ColumnTypeUnitDescription
gpu_capacity_ifloatMHzThe capacity of the GPU.
gpu_usage_ifloatMHzThe GPU capacity used by the tasks.
gpu_demand_ifloatMHzThe GPU capacity the tasks ask for.
gpu_utilization_ifloatratiogpu_usage_i divided by gpu_capacity_i.
gpu_time_active_iint64msThe time the GPU was active, since the previous sample.
gpu_time_idle_iint64msThe time the GPU was idle, since the previous sample.
gpu_time_steal_iint64msThe time tasks wanted to run but no GPU capacity was available, since the previous sample.
gpu_time_lost_iint64msThe GPU time lost to interference, since the previous sample.
gpu_power_draw_ifloatWThe power draw of the GPU.