Lombardi BPM Instrumentation

Great article taken from http://www-01.ibm.com/support/docview.wss?uid=swg21613989

1. Log into the Process Admin Console as a user in the tw_admins group, such as tw_admin or admin. The error SECJ0305 may appear if this is run without the base internal users.
   
   For example:
   http://server_name:port_number/ProcessAdmin
   
   
2. Under Monitoring, click Instrumentation.
   
   
3. Click Start Logging to collect data. Note where it stores the file. For example, in IBM Business Process Manager Version 7.5, the file might be stored in the following directory:
   C:\IBM\BPM\v7.5\profiles\ProcCtr01\logs\inst001.dat
   
   
4. Click Stop Logging.
   
   
5. Retrieve the file for processing. 

 
How do I to decode the instrumentation .dat files? 
Use the following command to extract the data: 
java -Xmx1024M -cp svrcoreclnt.jar  com.lombardisoftware.instrumentation.log.tools.NonXMLDump inst001.dat >  inst001.txt 
 
Notes: 

• The svrcoreclnt.jar file needs to be in a path that Java can execute. You can copy this file to a separate directory to your desktop to run. The location of  the Java archive (JAR) file is: [install_dir]\Lombardi\lib
  
  
• 1024MB heap will be sufficient for almost all cases.
  
  
• inst001.dat is the instrumentation file.
  
  
• inst001.txt is a decoded file in the plain text format. 

Reading the decoded file
The instrumentation log files are important because they tell you exactly how long it took for something to run. The following command finds all threads that took longer than 1000 milliseconds (1 second) to complete, which are the threads that you should examine first.
 
grep -E "(THREAD|period [0-9]{4,}ms)" inst001.txt 

Example Sample output: 
>> THREAD Thread-47 << 
>> THREAD WebContainer : 2 << 
03:17:10.356 period 1156ms 'Resume Workflow Engine' { 
03:17:10.418    period 1031ms 'Do Job'  
Worker=com.lombardisoftware.component.javaconnector.worker.JavaConnectorWorker { 
03:17:10.418       period 1031ms 'Java Execution' { 
>> THREAD WebContainer : 13 << 
>> THREAD WebContainer : 16 << 

The times are nested,  1156ms 'Resume Workflow Engine' is running a coach and took 1.2 seconds. Within here, you see 1.0 seconds for executing Java. After this function, there might be another function that took 400 milliseconds.