Td User Manual: Difference between revisions
| Line 32: | Line 32: | ||
Invert match. Select the stack traces that do not match the regular expression. | Invert match. Select the stack traces that do not match the regular expression. | ||
=Other Commands= | =Other Commands= | ||
Revision as of 01:51, 22 July 2017
Internal
Overview
tda (Thread Dump Analyzer) is a command-line utility that can be used to process Java thread dumps.
This documentation defines a thread dump as the result of one invocation of the jstack command, or of sending SIGQUIT (-3) into the Java virtual machine process. A thread dump consists in a set of stack traces, one stack trace for each thread in the Java virtual machine.
tda works by default in a manner similar to grep, processing the thread dump file sequentially, one thread dump at a time. Multiple thread dumps (i.e. the result of multiple invocations, at different moments in time), may be present in the file, and tda distinguishes this situation, by handling each thread dump individually. Once the stack trances are parsed, tda matches their content against the given regular expression and displays the stack traces that match.
The regular expression uses the grep syntax. More details about supported regular expressions are available in the "" section.
Syntax
tda [options] <regex|command> <thread-dump-file> [thread-dump-file, ...]
grep Mode
The utility filters and displays at standard output only the stack traces that match the given regular expression. For example:
tda http- thread-dump-file.txt
will display at stdout only the stack traces that contain "http-", anywhere in the stack trace, including method invocation lines. The regular expression is optional. If missing, all stack traces present in the file will be displayed. The output can be modified with the following options:
-c
Counts the number of threads that match the regular expression, and display the number. If only the file name is specified, the regular expression is assumed to be "match all".
-v
Invert match. Select the stack traces that do not match the regular expression.
Other Commands
count
diff
tda diff <thread-dump-file1.out> <thread-dump-file2.out>
The simplest form of the diff command compares the thread dump files and displays the names of the names of the threads that are present in one file and not in the other.
version
help
In-line help.