summaryrefslogtreecommitdiff
path: root/site/docs/documentation/Input/Traces.md
diff options
context:
space:
mode:
authorDante Niewenhuis <d.niewenhuis@hotmail.com>2024-03-05 16:50:35 +0100
committerGitHub <noreply@github.com>2024-03-05 16:50:35 +0100
commit960b3d8a13c67ac4b7f479d5764b0b618fc9ea09 (patch)
tree4f103bcf6635341827d9cfa10c10cfde9543f04f /site/docs/documentation/Input/Traces.md
parent5864cbcbfe2eb8c36ca05c3a39c7e5916aeecaec (diff)
Cpu fix (#208)
* Updated the topology format to JSON. Updated TopologyReader.kt to handle JSON filed. Added documentation for the new format. * applied spotless kotlin * small update * Updated for spotless apply * Updated for spotless apply
Diffstat (limited to 'site/docs/documentation/Input/Traces.md')
-rw-r--r--site/docs/documentation/Input/Traces.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/site/docs/documentation/Input/Traces.md b/site/docs/documentation/Input/Traces.md
new file mode 100644
index 00000000..ec5782cb
--- /dev/null
+++ b/site/docs/documentation/Input/Traces.md
@@ -0,0 +1,26 @@
+### Traces
+OpenDC works with two types of traces that describe the servers that need to be run. Both traces have to be provided as
+parquet files.
+
+#### Meta
+The meta trace provides an overview of the servers:
+
+| Metric | Datatype | Unit | Summary |
+|--------------|------------|----------|--------------------------------------------------|
+| id | string | | The id of the server |
+| start_time | datetime64 | datetime | The submission time of the server |
+| stop_time | datetime64 | datetime | The finish time of the submission |
+| cpu_count | int32 | count | The number of CPUs required to run this server |
+| cpu_capacity | float64 | MHz | The amount of CPU required to run this server |
+| mem_capacity | int64 | MB | The amount of memory required to run this server |
+
+#### Trace
+The Trace file provides information about the computational demand of each server over time:
+
+| Metric | Datatype | Unit | Summary |
+|-----------|------------|---------------|---------------------------------------------|
+| id | string | | The id of the server |
+| timestamp | datetime64 | datetime | The timestamp of the sample |
+| 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. |