Trace reading tools for WebSphere Application Server and IBM HTTP Server on z/OS
 Technote (FAQ)
 
Problem
Customers may find it more efficient and beneficial to review traces for problems before opening a PMR. This technote includes trace reading tools for IBM® WebSphere® Application Server and IBM HTTP Server on z/OS® .
 
Solution
The following JAR contains several tools to ease trace analysis:

TraceAssistant.jar

The JAR contains the following tools for WebSphere Application Server traces (along with usages):

  • A tool that will extract a single thread from a trace and place it in it's own file. Usage: java -classpath TraceAssistant.jar TraceAssist.WSTrace.WsThreadExtractor. When prompted, enter the full path to the file containing the trace, and the thread ID.
  • A tool to filter the trace on specific components. Usage: java -classpath TraceAssistant.jar TraceAssist.ComponentFilter.WsCompFilter. When prompted, enter the full path to the trace file, the output filename, and a filter. The filter argument can be multiple Application Server packages separated by a colon (you may use a wild card on the end to designate all classes of a particular package).

    An example filter would be: com.ibm.ws.webcontainer.*:com.ibm.ws.management.repository.FileRepository. The previous filter would create a new file with only trace entries from webcontainer classes and the com.ibm.ws.management.repository.FileRepository class.

  • A tool to analyze each request in a trace. Note that the trace must contain all webcontainer tracing (ideally, a com.ibm.*=all=enabled trace). This tool is only valid to run against Application Serverservant region traces. Usage: java -classpath TraceAssistant.jar TraceAssist.WSTrace.WsRequestAnalyzer. When prompted enter the full path to the trace file. The output file will contain a listing of all requests in the trace along with all header information and response codes that could be extracted.

The JAR also contains two tools for use against IBM HTTP Server (vv) traces and one for use against Application Server plug-in traces:

  • A tool to extract trace entries written on a particular thread in a vv trace. Usage: java -classpath TraceAssistant.jar TraceAssist.IHSHelpers.IHSThreadExtractor. When prompted, enter the full path to the trace file, and the thread to extract.
  • A tool to format out the 'V' entries in the trace. The 'V' entries in a vv trace contain the breadcrumb trails through particular pieces of code and can give ideas to point out slowdowns in application code. Usage: java -classpath TraceAssistant.jar TraceAssist.IHSHelper.IHSVTraceFormatter. When prompted enter the full path to the trace file. The JAR also contains a sample of the V format file created.
  • A tool to extract a single thread from a Application Server plug-in trace. Usage: java -classpath TraceAssistant.jar TraceAssist.HttpPlugin.HttpPluginThreadExtractor. When prompted, enter the full path to the trace file.

Note that this JAR is provided 'as-is', although it may be updated by the author from time to time. This article will be updated as the JAR is, to keep track of any changes.

 
 
 


Document Information


Current web document: swg21231133.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s): z/OS
Software version: 6.0.1
Software edition:
Reference #: 1231133
IBM Group: Software Group
Modified date: Feb 22, 2006