diff options
| author | Dante Niewenhuis <d.niewenhuis@hotmail.com> | 2025-05-16 10:32:08 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-05-16 10:32:08 +0200 |
| commit | d70312f122d9ef7c31b05757239ffc66af832dee (patch) | |
| tree | c8eb5d86ce751b783c3f15744bcda35861eed65d /site/docs/documentation/Input/Workload.md | |
| parent | 1bc17abd7691bc81f11ee125e2eeb4cb08da5245 (diff) | |
Updated website documentation (#334)
* Updated website documentation
* Updated some documentation and fixed links
* small updates
* small updates
Diffstat (limited to 'site/docs/documentation/Input/Workload.md')
| -rw-r--r-- | site/docs/documentation/Input/Workload.md | 47 |
1 files changed, 27 insertions, 20 deletions
diff --git a/site/docs/documentation/Input/Workload.md b/site/docs/documentation/Input/Workload.md index b0a45942..73f39e60 100644 --- a/site/docs/documentation/Input/Workload.md +++ b/site/docs/documentation/Input/Workload.md @@ -1,24 +1,31 @@ -OpenDC works with two types of traces that describe the tasks that need to be run. Both traces have to be provided as -parquet files. +Workloads define what tasks in the simulation, when they were submitted, and their computational requirements. +Workload are defined using two files: -#### Task -The meta trace provides an overview of the tasks: +- **[Tasks](#tasks)**: The Tasks file contains the metadata of the tasks +- **[Fragments](#fragments)**: The Fragments file contains the computational demand of each task over time -| Metric | Datatype | Unit | Summary | -|-----------------|----------|----------|------------------------------------------------| -| id | string | | The id of the server | -| submission_time | int64 | datetime | The submission time of the server | -| duration | int64 | datetime | The finish time of the submission | -| cpu_count | int32 | count | The number of CPUs required to run this task | -| cpu_capacity | float64 | MHz | The amount of CPU required to run this task | -| mem_capacity | int64 | MB | The amount of memory required to run this task | +Both files are provided using the parquet format. -#### Fragment -The Fragment file provides information about the computational demand of each task over time: +#### Tasks +The Tasks file provides an overview of the tasks: -| Metric | Datatype | Unit | Summary | -|-----------|------------|---------------|---------------------------------------------| -| id | string | | The id of the task | -| duration | int64 | milli seconds | The duration since the last sample | -| cpu_count | int32 | count | The number of cpus required | -| cpu_usage | float64 | MHz | The amount of computational power required. | +| Metric | Required? | Datatype | Unit | Summary | +|-----------------|-----------|----------|------------------------------|--------------------------------------------------------| +| id | Yes | string | | The id of the server | +| submission_time | Yes | int64 | datetime | The submission time of the server | +| nature | No | string | [deferrable, non-deferrable] | Defines if a task can be delayed | +| deadline | No | string | datetime | The latest the scheduling of a task can be delayed to. | +| duration | Yes | int64 | datetime | The finish time of the submission | +| cpu_count | Yes | int32 | count | The number of CPUs required to run this task | +| cpu_capacity | Yes | float64 | MHz | The amount of CPU required to run this task | +| mem_capacity | Yes | int64 | MB | The amount of memory required to run this task | + +#### Fragments +The Fragments file provides information about the computational demand of each task over time: + +| Metric | Required? | Datatype | Unit | Summary | +|-----------|-----------|----------|---------------|---------------------------------------------| +| id | Yes | string | | The id of the task | +| duration | Yes | int64 | milli seconds | The duration since the last sample | +| cpu_count | Yes | int32 | count | The number of cpus required | +| cpu_usage | Yes | float64 | MHz | The amount of computational power required. | |