You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by bm...@apache.org on 2018/07/04 01:26:37 UTC

mesos git commit: Added documentation for performance profiling with perf/flamescope.

Repository: mesos
Updated Branches:
  refs/heads/master 1dde513c7 -> 07dc7d29b


Added documentation for performance profiling with perf/flamescope.


Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/07dc7d29
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/07dc7d29
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/07dc7d29

Branch: refs/heads/master
Commit: 07dc7d29ba1b022cbc1d65af6562f36c551fcaea
Parents: 1dde513
Author: Benjamin Mahler <bm...@apache.org>
Authored: Tue Jul 3 18:26:29 2018 -0700
Committer: Benjamin Mahler <bm...@apache.org>
Committed: Tue Jul 3 18:26:29 2018 -0700

----------------------------------------------------------------------
 docs/home.md                  |  1 +
 docs/performance-profiling.md | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos/blob/07dc7d29/docs/home.md
----------------------------------------------------------------------
diff --git a/docs/home.md b/docs/home.md
index 077096d..68b1c74 100644
--- a/docs/home.md
+++ b/docs/home.md
@@ -27,6 +27,7 @@ layout: documentation
 * [Operational Guide](operational-guide.md)
 * [Fetcher Cache Configuration](fetcher.md)
 * [Fault Domains](fault-domains.md)
+* [Performance Profiling](performance-profiling.md) for debugging performance issues in Mesos.
 * [Memory Profiling](memory-profiling.md) for debugging potential memory leaks in Mesos.
 
 ## Resource Management

http://git-wip-us.apache.org/repos/asf/mesos/blob/07dc7d29/docs/performance-profiling.md
----------------------------------------------------------------------
diff --git a/docs/performance-profiling.md b/docs/performance-profiling.md
new file mode 100644
index 0000000..b3608a1
--- /dev/null
+++ b/docs/performance-profiling.md
@@ -0,0 +1,22 @@
+---
+title: Apache Mesos - Performance Profiling
+layout: documentation
+---
+
+# Performance Profiling
+
+This document over time will be home to various guides on how to use various profiling tools to do performance analysis of Mesos.
+
+## Flamescope
+
+[Flamescope](https://github.com/Netflix/flamescope) is a visualization tool for exploring different time ranges as [flamegraphs](https://github.com/brendangregg/FlameGraph). In order to use the tool, you first need to obtain stack traces, here's how to obtain a 60 second recording at 100 hertz using Linux perf:
+
+```
+$ sudo perf record --freq=100 --all-cpus --no-inherit --call-graph dwarf -p <mesos-master-pid> -- sleep 60
+$ sudo perf script --header | c++filt > mesos-master.stacks
+$ gzip mesos-master.stacks
+```
+
+If you'd like to solicit help in analyzing the performance data, upload the `mesos-master.stacks.gz` to a publicly accessible location and file with `dev@mesos.apache.org` for analysis, or send the file over [slack](mesos.slack.com) to the #performance channel.
+
+Alternatively, to do the analysis yourself, place mesos-master.stacks into the `examples` folder of a flamescope git checkout.
\ No newline at end of file