Merge pull request #1409 from PrzemekWirkus/devel_windowsperf_wpa_plugin_improvements

Update WindowsPerf + WPA plugin docs

Author: jasonrandrews

content/learning-paths/laptops-and-desktops/windowsperf_wpa_plugin/windowsperf_wpa_plugin.md

@@ -26,7 +26,7 @@ You can save a `.json` output from WindowsPerf by using the `--output` command f
     To create a file named `example.json`, run the following command:
 
     ```console
-    wperf stat -e ld_spec --output example.json
+    wperf stat -e ld_spec --timeout 5 --json --output example.json
     ```
 
 2. Open Windows Performance Analyzer, and see the following window:
@@ -54,9 +54,11 @@ You can use WPA to visualize PMU events in the recorded data.
 To try the timeline feature, run the command:
 
 ```command 
-wperf stat -m dcache -c 0,1,2,3,4,5,6,7 -t -i 0 -n 50 --json
+wperf stat -m dcache -c 0,1,2,3,4,5,6,7 -t -i 0 -n 10 --timeout 2 --json --output example2.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 Open the generated output (`.json` file) in WPA to see the graph:
 
 ![timeline-by-core #center](figures/timeline-by-core.png)
@@ -72,9 +74,11 @@ To see all the generated graphs you can expand the `Counting timeline` section i
 Run another `wperf` command with different options:
 
 ```console 
-wperf stat -t -i 0 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --json
+wperf stat -t -i 0 -n 10 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --timeout 2 --json --output --example3.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 The graph after opening the `.json` file is shown below:
 
 ![timeline-events-by-key #center](figures/timeline-events-by-key.png)
@@ -88,9 +92,11 @@ The WPA Plugin also provides visualization of [Arm telemetry metrics](https://de
 To visualize telemetry, run the following command:
 
 ```console 
-wperf stat -t -i 0 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --json
+wperf stat -t -i 0 -n 10 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --timeout 2 --json --output example4.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 You can also see the telemetry timeline graphs under the graph explorer level in WPA. 
 
 These graphs are generated dynamically so only the relevant metrics for the given `.json` output file are visible.
@@ -101,4 +107,4 @@ Once expanded, a more in-depth view is visible under the Analysis tab of WPA.
 
 ![telemetry-table #center](figures/telemetry-table.png)
 
-You now have a basic understanding of how to use `wperf` generated data in the Windows Performance Analyzer.
+You now have a basic understanding of how to use `wperf` generated data in the Windows Performance Analyzer.