The IBM Whole-system Analysis of Idle Time (“WAIT”) tool is a web-based tool for diagnosing performance and scalability bottlenecks, especially in deployed enterprise environments, but useful throughout the software life cycle from development to test to deployed customer environments and IBM customer support.
WAIT's value proposition lies in the fact that it can be used with any deployed system running a JVM -- with no restart, no agents, no special flags, no special versions, no kernel patches, etc.
WAIT is lightweight and its output starts at a high level (for example: Delayed waiting on database, or Dashboards load, artifacts loading, etc).
WAIT employs an expert rule system to look at how Java code communicates with the wider world to provide a high-level view of system and application bottlenecks.
Finally, WAIT's output is viewed in a standard browser (Firefox, Chrome, Safari, Internet Explorer),so no install is needed.
WAIT uses the same website for initial user registration, downloading of scripts (if desired), uploading of data, and viewing of reports (in your web browser). Thus, to get started, go to:
1. Learn about WAIT: Read about the “Latest News” and updates, read a possibly updated version of this manual, and view an interactive “Report Gallery” of WAIT reports illustrating how WAIT is used.
2. Collect Data from Your System to submit to WAIT and see reports about your own systems. WAIT’s data is sufficiently easy to collect that you can do get it with no agents or scripts, as outlined in “Quick Start.” However, it is often easier and allows more data to be collected to use WAIT’s “Data Collector” scripts. You can also see “Example Input” illustrating of the sort of data that WAIT collects, in particular ps and vmstat on Unix/Linux systems, and java cores or java thread dumps. Java thread dumps have call stacks for all threads in the JVM, as well as monitor lock graphs and verbose garbage collection information.
We also emphasize the data WAIT does not collect: information from Java heaps or other generalized pools of memory. Thus, WAIT inputs do not have information like credit card numbers, social insurance numbers, or passwords, i.e. information about which individuals and companies worry in terms of identity theft and other exploits.
3. Upload the Generated Data: Once you have data from your system or just the “Example Input”, the next step is to upload it to the WAIT server. To do that, “Use WAIT Now.” Clicking this button will allow you to upload your data and see the report all in the same browser window. We will describe that in slightly more detail shortly.
4. View the Report in Your Browser: As you use WAIT, you may wish to “View Your Past Reports”, e.g. to compare the current situation to past situations. Note that when you upload data in Step 3, WAIT automatically shows the report for that data in your current browser Window. There is no need to go back to the main WAIT screen and this Step 4 to see your data.
The first time you use WAIT, it will ask you to setup a UserName (your email address) and password. For example, if you click “Use WAIT Now” in Step 3, the following screen will appear:
As noted in the explanatory text in the box, “Click Cancel If You Would Like To Register” as when you use WAIT for the first time. More specifically clicking “Cancel” yields the following screen in your browser:
Please note that WAIT currently requires its own ID be established – separate from any other IDs you may have with IBM. Thus, enter your email address and password, then click the green “Register” box. Doing so yields:
Clicking the green “Log in, and Use WAIT!” box takes you to the Authentication screen again:
Entering your new credentials takes you back to the main screen shown on the cover.
If you are uncertain about how to begin or what reports may look like, you can look at a sample gallery of reports by going to the “View Example Reports” – the third entry under Box (1) “Learn About WAIT.”
To get started right away, you can gather your own data, if you do not already have it. If you are an expert, you can collect data with no scripts or agents. For details, see the “Quick Start” entry under Box (2) above “Collect Data from Your System” (also described below in Section 4). However, for most people and situations, it is generally easist to use our Data Collector scripts downloadable for Unix and Windows under the
“Data Collectors” entry under Box (2) “Collect Data from Your System” as illustrated below: