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 <bmah...@apache.org> Authored: Tue Jul 3 18:26:29 2018 -0700 Committer: Benjamin Mahler <bmah...@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 `d...@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