/threaddump-analyzer

A JVM threaddump analyzer

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Java Thread Dump Analyzer

This is a Java thread dump analyzer written in Javascript.

Click here to get your Java thread dump analyzed.

Click here to run the unit tests.

License

The Java Thread Dump Analyzer is licensed under version 2.0 of the Apache license, the copyright belongs to Spotify AB.

Testing Locally

npm install
npm test

Tested with npm 6.13.7 and node v13.8.0.

TODO

  • Enable multiple threads to hold the same lock in the Synchronizers section. This will happen when we have threads waiting on unnamed locks and we can't find out which lock it's waiting for. And of course it's wrong, but if we can't tell we can't tell.

  • In the Top Running Methods list, list thread names per top method and link them all to the stack traces list.

  • Support parsing gzipped thread dumps.

  • If one thread is holding multiple locks, this should be noted in the synchronizers section for all involved locks. Add a "Held with" header to the involved locks, listing which the other locks are held simultaneously with this one.

  • Make up new lock identifiers using the prettyClassName() + counter. These should be more human-readable than the raw pointers.

  • Add a warnings section. To begin with, warn about threads holding locks without running.

  • Warn about free locks that somebody wants to take. This would be an internal error or a problem with the thread dump.

  • Add a table of contents before the first section, making sure only the visible sections are in it.

  • If multiple threads have the same names in the Synchronizers section, uniquify the thread names by appending their tids to their names.

  • Change toString test methods into toHtml test methods and remove the corresponding toString methods from the source code.

  • Add a line above each <h2> element in the CSS and remove some <hr>s from the HTML code.

  • If all lines share the same prefix, strip it away before analyzing so we can parse dumps like this one: http://pastebin.com/fcSqxsku

  • If a thread is waiting for another thread to release a lock, make sure there's a clickable reference from the waiter to the holder.

  • Detect deadlocks and display deadlock information prominently at the top if detected.

  • Support parsing multiple consecutive thread dumps.

  • Auto detect if somebody copies a thread dump to the clipboard and spontaneously analyze that.

  • If two or more threads share both thread header and stack, print only one thread header line prefixed by "N x ".

  • Instead of showing the thread dump as text, show it in a tree with expandable nodes.

DONE

  • Publish the web page using Github pages.

  • Make submit button call a Javascript function.

  • Connect the submit button to a Javascript function that simply copies the whole thread dump to below the line.

  • HTML escape the text before writing it below the line.

  • Make an Analyzer class / prototype.

  • Parse the thread dump and reconstruct it below the line.

  • Handle thread names containing linefeeds.

  • Add tests, unit or otherwise.

  • Apply Apache License.

  • Our example thread dump contains 297 threads. Make sure we get all of them on the web page.

  • Add thread stack traces to the parse result.

  • Add thread stacks to the output.

  • Group threads with the same stacks and show the most common stack traces and their names first.

  • Put <empty stack trace> threads last, no matter how many they are.

  • If there are five or more threads in a group, prefix the group with a line saying: "NN threads with stack trace:"

  • Publish on public Github.

  • Update the README.md links to point to the public Analyzer location.

  • Put links to the Github project and the unit tests page on index.html.

  • Put an actual thread dump and the expected outcome of analyzing it in test.html and make a test that verifies that analyzing that dump gives the expected result.

  • Add a "report bug" link right after the analysis.

  • Add a Travis configuration.

  • Make Travis run the unit tests and fail the build if they fail.

  • If two stacks are just as common, use the stack trace contents itself as the secondary sort key. This way similar stacks will end up closer to each other.

  • Sort thread names in each group alphabetically.

  • Make Travis run a Javascript code checker and fail the build if there are warnings.

  • Make Travis validate the HTML and fail verifictaion on HTML problems.

  • Dump all input lines we failed to parse in red at the end so it's obvious if we need to add something.

  • Move styling into CSS.

  • Turn the Ignored Lines section at the bottom into an HTML table.

  • List top RUNNING methods before everything else. I have a thread dump taken on a system that was swapping basically getting the GC stuck. With a list of top RUNNING methods it should be possible to see this from the analysis.

  • Add a Clear button next to the Analyze button.

  • For top running methods belonging to only one thread, make a link from the top list method to the thread executing it.

  • For threads with a method in the top running methods at the start of the page, make a link from the top frame of the full stack back up to the Top Running Methods section.

  • N/A: Accessing iframes isn't possible because of the Javascript security model: Move unit test data from test.html into iframes of test.html and put each unit test data block in its own file, referenced from test.html.

  • Make the Thread class parse held locks, waited-for locks and waited-for condition variables from the thread dump.

  • List all synchronization things at the end; both locks and condition variables in the same list. For each, list who's holding it, who's waiting for the lock, and who's waiting for notification. All references should be clickable.

  • Add clickable links from each thread in the thread list to whatever synchronization thingie(s) it is involved with (if any).

  • Highlight the link target if the user clicks on an in-page cross reference.

  • If a synchronizer has five or more lock waiters or synchronization waiters, print the count before the headline.

  • Sort the synchronizers section by number of threads involved, class name and address, in that order.

  • Say "... threads with no stack" for threads with no stack, rather than "... threads with this stack".

  • If a thread is listed as holding the same lock more than once, remove duplicates from that list.

  • Support uploading thread dumps from the local file system: http://www.html5rocks.com/en/tutorials/file/dndfiles/