Trace Analysis Tool¶
Calls Kieker.TraceAnalysis to analyze and visualize monitored trace data.
Usage¶
Short |
Long Option |
Required |
Description |
---|---|---|---|
–addDescriptions |
Adds descriptions to elements according to the given file as a properties file (key: component ID, e.g., @1; value: description) |
||
-d |
–debug |
false |
Prints additional debug information. |
–filter-traces |
Consider only the traces not identified by the list of trace IDs. Defaults to no traces. |
||
-h |
–help |
false |
Prints the usage information for the tool, including available options. |
–ignore-assumed-calls |
false |
If selected, assumed calls are visualized just as regular calls. |
|
–ignore-executions-after-date <timestamp> |
Executions ending after this date (UTC timezone) or monitoring timestamp are ignored. |
||
–ignore-executions-before-date <timestamp> |
Executions starting before this date (UTC timezone) or monitoring timestamp are ignored. |
||
–ignore-invalid-traces |
If selected, the execution aborts on the occurrence of an invalid trace. |
||
–include-self-loops |
If selected, self-loops are included in the visualizations. |
||
-i |
–inputdirs <dir1,dir2,…,dirN> |
Log directories to read data from. |
|
–max-trace-duration <duration> |
600000 |
Threshold (in ms) after which incomplete traces become invalid. Defaults to 600,000 (i.e, 10 minutes). |
|
-p |
–output-filename-prefix |
Prefix for output filenames. |
|
-o |
–outputdir |
Directory for the generated file(s). |
|
–plot-Aggregated-Assembly-Call-Tree |
false |
Generate and store an aggregated assembly-level call tree (.dot) |
|
–plot-Aggregated-Deployment-Call-Tree |
false |
Generate and store an aggregated deployment-level call tree (.dot) |
|
–plot-Assembly-Component-Dependency-Graph <none|*> |
Generate and store an assembly-level component dependency graph (.dot) |
||
–plot-Assembly-Operation-Dependency-Graph <none|*> |
Generate and store an assembly-level operation dependency graph (.dot) |
||
–plot-Assembly-Sequence-Diagrams |
false |
Generate and store assembly-level sequence diagrams (.pic) |
|
–plot-Call-Trees |
false |
Generate and store call trees for the selected traces (.dot) |
|
–plot-Container-Dependency-Graph |
false |
Generate and store a container dependency graph (.dot file) |
|
–plot-Deployment-Component-Dependency-Graph <none|*> |
Generate and store a deployment-level component dependency graph (.dot) |
||
–plot-Deployment-Operation-Dependency-Graph <none|*> |
Generate and store a deployment-level operation dependency graph (.dot) |
||
–plot-Deployment-Sequence-Diagrams |
false |
Generate and store deployment-level sequence diagrams (.pic) |
|
–print-Assembly-Equivalence-Classes |
false |
Output an overview about the assembly-level trace equivalence classes |
|
–print-Deployment-Equivalence-Classes |
false |
Output an overview about the deployment-level trace equivalence classes |
|
–print-Execution-Traces |
false |
Save execution trace representations of valid traces (.txt) |
|
–print-Message-Traces |
false |
Save message trace representations of valid traces (.txt) |
|
–print-System-Model |
false |
Save a representation of the internal system model (.html) |
|
–print-invalid-Execution-Traces |
false |
Save a execution trace representations of invalid trace artifacts (.txt) |
|
–repair-event-based-traces |
false |
If selected, BeforeEvents with missing AfterEvents e.g. because of software crash will be repaired. |
|
–select-traces |
Consider only the traces identified by the list of trace IDs. Defaults to all traces. |
||
–short-labels |
false |
If selected, abbreviated labels (e.g., package names) are used in the visualizations. |
|
–traceColoring |
Color traces according to the given color map given as a properties file (key: trace ID, value: color in hex format, e.g., 0xff0000 for red; use trace ID ‘default’ to specify the default color) |
||
-v |
–verbose |
false |
Verbosely prints additional information |
Example¶
The following commands generate a deployment-level operation dependency graph and convert it to pdf format:
trace-analysis
--inputdirs
examples/userguide/ch5–trace-monitoring-aspectj/testdata/kieker-20100830-082225522-UTC
--outputdir .
--plot-Deployment-Operation-Dependency-Graph
dot -T pdf deploymentOperationDependencyGraph.dot > deploymentOperationDependencyGraph.pdf
Listing A.5: Execution under UNIX-like systems
trace-analysis.bat
--inputdirs
..\examples\userguide\ch5–trace-monitoring-aspectj\testdata\kieker-20100830-082225522-UTC
--outputdir .
--plot-Deployment-Operation-Dependency-Graph
dot -T pdf deploymentOperationDependencyGraph.dot > deploymentOperationDependencyGraph.pdf
Listing A.6: Execution under Windows