From 4def1e04ee652e542cc2880863a321e9d3304920 Mon Sep 17 00:00:00 2001
From: j-dunham <j-dunham@github.com>
Date: Wed, 31 Aug 2022 10:34:44 -0400
Subject: [PATCH] Update valet-forecast-lab.md

---
 azure_devops/valet-forecast-lab.md | 132 ++++++++++++++++++++++++++++-
 1 file changed, 131 insertions(+), 1 deletion(-)

diff --git a/azure_devops/valet-forecast-lab.md b/azure_devops/valet-forecast-lab.md
index c463bc1..e9dcc8b 100644
--- a/azure_devops/valet-forecast-lab.md
+++ b/azure_devops/valet-forecast-lab.md
@@ -33,7 +33,110 @@ gh valet forecast azure-devops --output-dir ./tmp/forecast_reports --azure-devop
 ![sample-report](https://user-images.githubusercontent.com/18723510/187694590-9121b997-0c89-4984-bbf2-84f3df2ed882.png)
 
 ## Review forecast report
-  
+Open the forecast report and review the calculated metrics. 
+- From the codespace explorer pane find `./tmp/sample_report/forecast_report.md` and right-click, and select __Open Preview__.
+![explorer-report](https://user-images.githubusercontent.com/18723510/187696893-6d503d8d-b512-427a-af42-bbf053fa4df4.png)
+- The file should be similar to this.
+  <details>
+  <summary>example forecast_report.md</summary>
+ 
+  # Forecast report for [Azure DevOps](https://dev.azure.com/jd-testing-org/ValetBootstrap/_build)
+
+  - Valet version: **0.1.0.13529(efcc91120eaf5ecb40df6af034c64580cbcfd2e8)**
+  - Performed at: **8/31/22 at 13:46**
+  - Date range: **4/5/22 - 8/19/22**
+
+  ## Total
+
+  - Job count: **186**
+  - Pipeline count: **60**
+
+  - Execution time
+
+    - Total: **153 minutes**
+    - Median: **0 minutes**
+    - P90: **1 minutes**
+    - Min: **0 minutes**
+    - Max: **4 minutes**
+
+  - Queue time
+
+    - Median: **0 minutes**
+    - P90: **1 minutes**
+    - Min: **0 minutes**
+    - Max: **5 minutes**
+
+  - Concurrent jobs
+
+    - Median: **0**
+    - P90: **0**
+    - Min: **0**
+    - Max: **4**
+
+  ---
+
+  ## Azure Pipelines
+
+  - Job count: **183**
+  - Pipeline count: **58**
+  - Total consumption: **99%**
+
+  - Execution time
+
+    - Total: **151 minutes**
+    - Median: **0 minutes**
+    - P90: **1 minutes**
+    - Min: **0 minutes**
+    - Max: **4 minutes**
+
+  - Queue time
+
+    - Median: **0 minutes**
+    - P90: **1 minutes**
+    - Min: **0 minutes**
+    - Max: **5 minutes**
+
+  - Concurrent jobs
+
+    - Median: **0**
+    - P90: **0**
+    - Min: **0**
+    - Max: **4**
+
+  ---
+
+  ## Default
+
+  - Job count: **3**
+  - Pipeline count: **2**
+  - Total consumption: **1%**
+
+  - Execution time
+
+    - Total: **1 minutes**
+    - Median: **0 minutes**
+    - P90: **0 minutes**
+    - Min: **0 minutes**
+    - Max: **0 minutes**
+
+  - Queue time
+
+    - Median: **0 minutes**
+    - P90: **0 minutes**
+    - Min: **0 minutes**
+    - Max: **0 minutes**
+
+  - Concurrent jobs
+
+    - Median: **0**
+    - P90: **0**
+    - Min: **0**
+    - Max: **1**
+
+  > Note: Concurrent jobs are calculated by using a sliding window of 1m 0s.
+ 
+</details>
+
 ### Metric Definitions
 |  Name | Description |
 | ----- | ----------- |
@@ -43,7 +146,34 @@ gh valet forecast azure-devops --output-dir ./tmp/forecast_reports --azure-devop
 | Max | The highest value |
    
 ### Total Section
+- This section shows the metrics for all of the jobs run in our sample data. 
+   ## Total
 
+   - Job count: **186**
+   - Pipeline count: **60**
+   ---
+  We can see there were 60 pipelines that ran and they contained 186 jobs.  The number of jobs is expected to be equal or larger than pipelines because a pipeline is typically a collection of jobs.
+
+-  `Execution time` shows the metrics for the time a job __took to run__. Looking closer we can see during our forecast timeframe the total job run time was 153 minutes, with 90% of the jobs finishing under 1 minute, and the longest job taking 4 minutes.  The `Min` and `Median` are 0 because they were less than a minute and was rounded down to 0.
+     - Execution time
+       - Total: **153 minutes**
+       - Median: **0 minutes**
+       - P90: **1 minutes**
+       - Min: **0 minutes**
+       - Max: **4 minutes**
+    
+- `Queue time` shows the metrics for how long jobs __waited__ for a runner to be available.  
+     - Queue time
+       - Median: **0 minutes**
+       - P90: **1 minutes**
+       - Min: **0 minutes**
+       - Max: **5 minutes**
+- `Concurrent jobs` show the metrics for how many jobs were run at the __same time__.
+     - Concurrent jobs
+       - Median: **0**
+       - P90: **0**
+       - Min: **0**
+       - Max: **4**
 
 ### Runner Group Sections
 - The preceding sections shows the same metrics as the `Total` section, but are broken out into runner groups. A runner group is a logical grouping of one or more runners.