From 053fc02ac02d413702e540035d9e4e71e87fa886 Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:21:27 -0500 Subject: [PATCH 1/8] Updated log format for schedTrace --- docs/data/ScheduledTrace.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/ScheduledTrace.md b/docs/data/ScheduledTrace.md index 4d62bc0..380d072 100644 --- a/docs/data/ScheduledTrace.md +++ b/docs/data/ScheduledTrace.md @@ -9,6 +9,6 @@ The scheduled trace logs are written to a file named _\\_\ : +[]: = ``` From ad78b7827e7282b62e6e07a963436496198796a7 Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:24:47 -0500 Subject: [PATCH 2/8] Updated log format for SPS --- docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md b/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md index 4cf2984..b1dc90c 100644 --- a/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md +++ b/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md @@ -8,7 +8,7 @@ The logs are written to a file named _\\_\\_schedPol The format of the data logged is as shown below. ``` - +[]: ``` _Note: The names of the scheduling policies can be found [here](https://gitlab.com/spdf/elektron/blob/master/schedulers/store.go#L14)_ From 6a577a413567075b3f00e3c8070ab0c15323e0ea Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:27:33 -0500 Subject: [PATCH 3/8] Updated log format for SCHED_WINDOW --- docs/data/withSpsEnabled/SchedulingWindow.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/data/withSpsEnabled/SchedulingWindow.md b/docs/data/withSpsEnabled/SchedulingWindow.md index 0b47bf2..284b09c 100644 --- a/docs/data/withSpsEnabled/SchedulingWindow.md +++ b/docs/data/withSpsEnabled/SchedulingWindow.md @@ -8,5 +8,5 @@ The logs are written to a file named _\\_\\_schedWin The format of the data logged is as shown below. ``` - -``` \ No newline at end of file +[]: Window size=, Name= +``` From 57d0ea278d68ce99f11d54d03fdeb361441bad3b Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:28:37 -0500 Subject: [PATCH 4/8] Minor format fix --- docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md b/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md index b1dc90c..b0c1cb8 100644 --- a/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md +++ b/docs/data/withSpsEnabled/SchedulingPolicySwitchTrace.md @@ -8,7 +8,7 @@ The logs are written to a file named _\\_\\_schedPol The format of the data logged is as shown below. ``` -[]: +[]: Name= ``` _Note: The names of the scheduling policies can be found [here](https://gitlab.com/spdf/elektron/blob/master/schedulers/store.go#L14)_ From 49cc32134b3d0584d1ecc518c36e4d36e215e9d1 Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:32:29 -0500 Subject: [PATCH 5/8] Updated log format for CLSFN_TASKDISTR_OVERHEAD --- docs/data/withSpsEnabled/TaskClassificationOverhead.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/withSpsEnabled/TaskClassificationOverhead.md b/docs/data/withSpsEnabled/TaskClassificationOverhead.md index 98a52af..a15eb47 100644 --- a/docs/data/withSpsEnabled/TaskClassificationOverhead.md +++ b/docs/data/withSpsEnabled/TaskClassificationOverhead.md @@ -8,7 +8,7 @@ The logs are written to a file named _\\_\\_classifi The format of the data logged is as shown below. ``` - +[]: Overhead in microseconds= ``` _Note: The classification overhead is logged in **microseconds**._ From 01c130561b592bdbd5878adbe3e92dfa9e668d8b Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:39:21 -0500 Subject: [PATCH 6/8] Updated log format for PCP --- docs/data/PCP.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/data/PCP.md b/docs/data/PCP.md index 790102f..9e5a432 100644 --- a/docs/data/PCP.md +++ b/docs/data/PCP.md @@ -25,12 +25,12 @@ myhost:kernel.all.cpu.sys When we run the `pmdumptext` command mentioned above for 5 seconds, the PCP log from _Elektron_ would be as shown below. ``` - myhost:kernel.all.cpu.user,myhost:kernel.all.cpu.sys - , - , - , - , - , +[]: myhost:kernel.all.cpu.user,myhost:kernel.all.cpu.sys +[]: , +[]: , +[]: , +[]: , +[]: , ``` ## Power Measurements From 67af2b72ba7a831b58e7d146b770d3f737f0ee81 Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 11:40:58 -0500 Subject: [PATCH 7/8] Renamed log type Renamed CLSFN_TASKDIST_OVERHEAD to CLSFN_TASKDISTR_OVERHEAD --- docs/Logs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Logs.md b/docs/Logs.md index da2bc0f..972fe78 100644 --- a/docs/Logs.md +++ b/docs/Logs.md @@ -11,4 +11,4 @@ _Elektron_ logs can be categorized into the following. * _**Scheduling Policy Switching Logs**_ - When scheduling policy switching is enabled (`-switchSchedPol` is used when launching _Elektron_), the following information is logged. * [**Scheduling Policy Switch trace (SPS)**](data/withSpsEnabled/SchedulingPolicySwitchTrace.md) - Every time _Elektron_ switches to a different scheduling policy, the _name_ of the scheduling policy and the corresponding _time stamp_ is logged.
* [**SCHED_WINDOW**](data/withSpsEnabled/SchedulingWindow.md) - For every switch, the size of the scheduling window and the name of the scheduling policy is logged. - * [**CLSFN_TASKDIST_OVERHEAD**](data/withSpsEnabled/TaskClassificationOverhead.md) - If the switching criteria is task distribution based, then the time taken to classify the tasks into low power consuming and high power consuming, and then to determine the task distribution is logged. + * [**CLSFN_TASKDISTR_OVERHEAD**](data/withSpsEnabled/TaskClassificationOverhead.md) - If the switching criteria is task distribution based, then the time taken to classify the tasks into low power consuming and high power consuming, and then to determine the task distribution is logged. From 38c5142d01d733e5ad33cd1597a4692fa0f570e0 Mon Sep 17 00:00:00 2001 From: Bhargavi Hanumant Alandikar <44841561+balandi1@users.noreply.github.com> Date: Mon, 9 Dec 2019 12:38:28 -0500 Subject: [PATCH 8/8] Added documentation for log configurations --- docs/Logs.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/Logs.md b/docs/Logs.md index 972fe78..97554b4 100644 --- a/docs/Logs.md +++ b/docs/Logs.md @@ -12,3 +12,17 @@ _Elektron_ logs can be categorized into the following. * [**Scheduling Policy Switch trace (SPS)**](data/withSpsEnabled/SchedulingPolicySwitchTrace.md) - Every time _Elektron_ switches to a different scheduling policy, the _name_ of the scheduling policy and the corresponding _time stamp_ is logged.
* [**SCHED_WINDOW**](data/withSpsEnabled/SchedulingWindow.md) - For every switch, the size of the scheduling window and the name of the scheduling policy is logged. * [**CLSFN_TASKDISTR_OVERHEAD**](data/withSpsEnabled/TaskClassificationOverhead.md) - If the switching criteria is task distribution based, then the time taken to classify the tasks into low power consuming and high power consuming, and then to determine the task distribution is logged. + +_Elektron_ logs can be configured through [Log config file](../logConfig.yaml). The following is the format for configuration. +``` +: + enabled: + filenameExtension: + minLogLevel: + allowOnConsole: +``` +The file has default configurations set. One can also configure the above fields for every log type. +* `enabled` - Enable or disable a specific log type. +* `filenameExtension` - Provide the file extension for specific log type. +* `minLogLevel` - Provide a minimum log level above which all logs should be logged. This is available only for Console log type. The default value is debug). +* `allowOnConsole` - Allow or Disallow a specific log type on the console.