diff options
author | Dmitry Krivoschekov <dkrivoschokov@dev.rtsoft.ru> | 2018-04-28 21:09:20 +0300 |
---|---|---|
committer | Dmitry Krivoschekov <dkrivoschokov@dev.rtsoft.ru> | 2018-05-13 22:58:19 +0300 |
commit | 1e83881a2ada2508c9847691edee8b66c7c08927 (patch) | |
tree | a0421fe9e64056043288adef5db8fb01f3e13994 | |
parent | 33d22ced2c934b487f2961dd4910acd413dfb3a6 (diff) | |
download | heaptrack-1e83881a2ada2508c9847691edee8b66c7c08927.tar.gz heaptrack-1e83881a2ada2508c9847691edee8b66c7c08927.tar.bz2 heaptrack-1e83881a2ada2508c9847691edee8b66c7c08927.zip |
Add 'Running' chapter to README
-rw-r--r-- | README.md | 62 | ||||
-rw-r--r-- | docs/image/memory_profiler_gui_allocation_histogram.png | bin | 0 -> 37984 bytes | |||
-rw-r--r-- | docs/image/memory_profiler_gui_allocations_graph.png | bin | 0 -> 90924 bytes | |||
-rw-r--r-- | docs/image/memory_profiler_gui_flame_graph.png | bin | 0 -> 71271 bytes | |||
-rw-r--r-- | docs/image/memory_profiler_gui_managed_heap.png | bin | 0 -> 48953 bytes | |||
-rw-r--r-- | docs/image/memory_profiling_app_started.png | bin | 0 -> 55166 bytes | |||
-rw-r--r-- | docs/image/memory_profiling_msvs_output.png | bin | 0 -> 78026 bytes | |||
-rw-r--r-- | docs/image/run_memory_profiler.png | bin | 0 -> 50301 bytes | |||
-rw-r--r-- | docs/image/run_memory_profiler_gui.png | bin | 0 -> 98187 bytes | |||
-rw-r--r-- | docs/image/start_emulator.png | bin | 0 -> 13824 bytes |
10 files changed, 61 insertions, 1 deletions
@@ -122,4 +122,64 @@ styles\qwindowsvistastyle.dll These files shall be copied to the following directory: `SDK\tools\memory-profiler` -##Running +## Running +Basic instructions for Running the Memory Profiler under Visual Studio are provided below. For more detailed guide on the Memory profiler please refer to the [Original README](docs/TIZEN_HEAPTRACK_ORIGINAL_README.md) + +### Step 1. Running Memory Profiler + * In the menu, choose Tools > Tizen > Profiler > Run Memory Profiler. + + ![Run Memory Profiler](docs/image/run_memory_profiler.png) + + + * If no Tizen device is connected and no Tizen emulators are running then Emulator Manager will be started. Please launch the type of emulator you want to use for running and profiling your application. + + ![Launch Emulator](docs/image/start_emulator.png) + + + * If everything is OK then the application starts as if you run it normally (using Start Debugging in Visual Studio). + + ![Tizen application running](docs/image/memory_profiling_app_started.png) + + + * In case of errors the Output Window will display them (the output below corresponds to the normal operation case). + + ![Memory Profiler Output Window](docs/image/memory_profiling_msvs_output.png) + + + * After finishing the application the memory profiling data file will be copied from Tizen to Windows host. + +### Step 2. Running Memory Profiler GUI + * You can open the memory profiling data file in the GUI application to analyze it. In the menu, choose Tools > Tizen > Profiler > Show Memory Profiler. + + ![Run Memory Profiler GUI](docs/image/run_memory_profiler_gui.png) + +### Step 3. Analyzing the results + * The GUI application provides several views to the memory profiling data. The views include: + + - summary page with information on which process was profiled, its total runtime, some memory related statistics, etc. + - bottom-up table tree view of the code locations that allocated memory with their aggregated cost and stack traces + - caller/callee table + - top-down table tree view of the code locations + - managed heap table tree view + - flame graph visualization (explanation: <http://www.brendangregg.com/FlameGraphs/memoryflamegraphs.html>) + - consumed memory size over time graph + - number of instances over time graph + - number of memory allocations over time graph + - size of memory allocated over time graph + - allocation histogram displaying the number of allocations (the total number and the several topmost code locations) belonging to one of the groups divided by allocation size (0 - 8 bytes, 9 - 16 bytes, ... , 512 bytes - 1 KB, more than 1 KB) + +#### Managed heap view sample + + ![Managed heap view](docs/image/memory_profiler_gui_managed_heap.png) + +#### Flame graph view sample + + ![Flame graph view](docs/image/memory_profiler_gui_flame_graph.png) + +#### Memory allocations graph view sample + + ![Memory allocations graph view](docs/image/memory_profiler_gui_allocations_graph.png) + +#### Allocation histogram view sample + + ![Allocation histogram view](docs/image/memory_profiler_gui_allocation_histogram.png) diff --git a/docs/image/memory_profiler_gui_allocation_histogram.png b/docs/image/memory_profiler_gui_allocation_histogram.png Binary files differnew file mode 100644 index 0000000..00969ac --- /dev/null +++ b/docs/image/memory_profiler_gui_allocation_histogram.png diff --git a/docs/image/memory_profiler_gui_allocations_graph.png b/docs/image/memory_profiler_gui_allocations_graph.png Binary files differnew file mode 100644 index 0000000..5516946 --- /dev/null +++ b/docs/image/memory_profiler_gui_allocations_graph.png diff --git a/docs/image/memory_profiler_gui_flame_graph.png b/docs/image/memory_profiler_gui_flame_graph.png Binary files differnew file mode 100644 index 0000000..eaf75ef --- /dev/null +++ b/docs/image/memory_profiler_gui_flame_graph.png diff --git a/docs/image/memory_profiler_gui_managed_heap.png b/docs/image/memory_profiler_gui_managed_heap.png Binary files differnew file mode 100644 index 0000000..c8718b3 --- /dev/null +++ b/docs/image/memory_profiler_gui_managed_heap.png diff --git a/docs/image/memory_profiling_app_started.png b/docs/image/memory_profiling_app_started.png Binary files differnew file mode 100644 index 0000000..ff42d1a --- /dev/null +++ b/docs/image/memory_profiling_app_started.png diff --git a/docs/image/memory_profiling_msvs_output.png b/docs/image/memory_profiling_msvs_output.png Binary files differnew file mode 100644 index 0000000..6f4ae7b --- /dev/null +++ b/docs/image/memory_profiling_msvs_output.png diff --git a/docs/image/run_memory_profiler.png b/docs/image/run_memory_profiler.png Binary files differnew file mode 100644 index 0000000..0d7208d --- /dev/null +++ b/docs/image/run_memory_profiler.png diff --git a/docs/image/run_memory_profiler_gui.png b/docs/image/run_memory_profiler_gui.png Binary files differnew file mode 100644 index 0000000..e25620c --- /dev/null +++ b/docs/image/run_memory_profiler_gui.png diff --git a/docs/image/start_emulator.png b/docs/image/start_emulator.png Binary files differnew file mode 100644 index 0000000..5d09774 --- /dev/null +++ b/docs/image/start_emulator.png |