|
|
Right Java tools for J2EE, Web Service, Grid and more |
| |Home | Products | Documents | Downloads | Purchase | Support | Company | Partners | Contact | |
SuperTracer Tutorial
Java EE (Java Enterprise Edition) is the new name for the Java platform.
But J2EE (Java 2 Enterprise Edition) is still widely used. In this document J2EE
and Java EE are interchangeable.
Welcome to SuperTracer!
By the way, you can press the F1 key to access context sensitive help system from any window throughout the whole program.
It is recommended that you run your J2EE server and Super on the same machine (localhost) for this tutorial. Your screen may or may not be exactly the same with our screen shots, especially when the values change.
If you have not gone with SuperLogging tutorial, please do so. This tutorial needs some log records which are generated by SuperLogging tutorial.
This tutorial use SuperLogging as the example. If you do not use SuperLogging, you should have no problem to work with native server log files. The only difference is the way to open the file. If you do use SuperLogging, you should go through SuperLogging Tutorial first, so some log records can be generated.
Click the following links for related information:
1. Go to the main menu. Click on the Modules > SuperTracer > Tracer.
2. A Name Tracer Panel appears for you to name the panel. Let's type MyFirstTracer and click on the Ok button.
3. The MyFirstTracer appears. It is a Tracer Panel.
4. Click on the File menu and
click on the Open SuperLogging (direct) menu item.
5. The Log Database Panel appears. All default values are there. If you use other database as your log database, you need to change database parameters. You can click on the Save all button to save all parameters, or click on Save basic button to save all parameters, but User and Password, if you have security concerns.
For this tutorial, let's accept the default values by simply clicking on the Ok button.
6. The Filter Panel appears. It allows you to specify time period of your interest and a WHERE clause to filter out unwanted log messages. For this tutorial, let's simply click on the Ok button. That means: load all log messages for the day, without extra WHERE clause.
7. Now, the content of log messages appears on the main area of the Tracer Panel with syntax highlighting.
The Log shows where the content came from. The Filter shows the
WHERE clause used to select log records. Although we did not type anything on
the Where clause of the Filter Panel, the real WHERE clause
contains the time period specified by the Period Panel on the Filter
Panel. SuperTracer translates information from the Period Panel to
machine readable time period for performance in selecting.
8. Let's click on the word (CasinoExampleEJB.java:58) to see the source code. A Source Code Panel appears with the line (number 58) marked and highlighted. The title of the panel shows the name of the source file. This is the tracing facility. It is so easy.
9. Let's close this panel by clicking the close icon on the top-right corner of this panel. Then click on the Source Path menu item. The Source Path Panel appears.
We can see the examples directory is on the list. As matter of fact, the source code file CasinoExampleEJB.java is under the examples directory. This is why the Source Code Panel appears when we click on a file name. SuperTracer tries find source code files on the source code path. You need to add your source path for your source code files here. That is so easy that we do not need to cover it in this tutorial. Let's close this panel by clicking Cancel button and go back to the Tracer Panel.
10. Let's do some search. Let's type "getresult" into What. Then click on the Search button.
The first occurrence of the word "getResult" is found and highlighted. The caret moves to the end of the word. Note, we typed What with lower case letters, the search found mix cases word. This is because the algorithm we used is case insensitive.
You can press Control-s instead of press the Search button to find the next. But the focus must be on the main text area.
You have choice for algorithm and for direction. When you click on the Direction box and Algorithm box, you will see:
You can combine all choices together for your search. If you are not familiar with Regular Expression, See Regular Expression for more information.
11. Do you like the colors of the syntax highlighting? If not, you can change them. Let's click on the Preference menu. The Preference Panel appears.
The value of Column is 0 now. The Color for this column is blue. Let's change it to red. To do so, we need to click on the Set color button. the Set Color Panel appears. You can choose any color you want. Let's click on the red. The Preview Panel shows what it will look like. Let's click the Ok button to confirm red.
12. When we come back to the Preference Panel, we see the color for Column 0 is red now.
When click on the Ok button, all changed values are saved. When we go back to the Tracer Panel, the colors are changed according to new values. The 0th column is red now.
If there are a lot of log records, it will take noticeable time to repaint the panel. SuperTracer is smart: it repaint only when it is necessary. If the color change is not for the current log type, there is no need to repaint. The color change will take effect the next time a file is open for the log type.
13. This is the tutorial for the tracing facility. Now let's click on the Close button to close MyFirstTracer. When you click on the Close button, SuperTracer will remember the size of the Tracer Panel. So, next time you open a Tracer Panel, the new size will be the size you save now.
14. The last feature we introduce for this tutorial is Dump. It dumps log records from log database to a flat file.
Go to the main menu. Click on the Module > SuperTracer > Dump. The Dump Panel appears.
The log database can either the current log database or an archive log database. You can select time period to dump.
This is the end of this tutorial. Thanks for your interest in SuperTracer.