Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
newbrough Merge pull request #19 from newbrough/release/update-docs
update docs for release artifacts
Latest commit 0f480e1 Jun 14, 2016

README.md

Gumshoe Load Investigator

Overview

Monitor application performance statistics associated with individual calling stacks, interactively filter and view as a flame graph or root graph.

Gumshoe was first created initially for internal use in the Dell Cloud Manager application but source code has since been released for public use under these terms.

Features

  • Analyze resource usage: measure TCP, UDP, filesystem or processor utilization
  • Pinpoint lines of code: all statistics are associated with a call stack and individual stack frames
  • Capture, filter and visualize as statistics are generated
  • Intuitive views: flame graph and root graph
  • Filter stack frames at capture and/or during visualization, modify on the fly.

Documentation

Don't Just Measure and Report: Understand

Looking at stack traces scaled by metrics gives a fast, intuitive way to understand application resource usage. Consider network I/O in a hypothetical application...

Flame graph example:

image

Looking at callers into an application, Invoker.invoke is responsible for >90% of the read operations in this application. It always calls RestRequestHandler.handle which in turn calls three different REST operations. One -- showItemDetails -- is responsible for >80% of read operations as it makes different calls into the DAO layer.

Root graph example:

image

Grouping now by the last frame where the application calls out to a resource, the couchdb Database.getDocument is responsible for over half of the read operations, while the JDBC Statement.execute about 25%, the vast majority of those from getItemDetails.

These two examples are completely contrived, but not overly simplified. The original call stacks in your application are generally huge, with hundreds of frames, but gumshoe uses stack filters to find just the relevant portions and focus the view on just those parts.

You can’t perform that action at this time.