12.6 Using the Log Analysis Tool

The Log Analysis Tool lets you parse the UNIX agent log files to consolidate information about default threads executed by the agent, and information about threads executed in conjunction with jobs.

During normal operation, the UNIX agent records information about its activity in log files. Because the UNIX agent makes entries in the log file at each execution of a thread, the various thread entries become interspersed with each other. The Log Analysis Tool helps you analyze the information recorded in the log file by consolidating entries by thread and extracting the consolidated information in a more readable format. The output from the Log Analysis Tool makes it easier to troubleshoot agent operation and identify any agent problems.

NOTE:For information about configuring logging for the UNIX agent, see the AppManager for UNIX Servers Management Guide, available on the AppManager Modules Documentation page.

The Log Analysis Tool is located in $NQMAGT_HOME/bin/logparser/fileParse.sh.

You can use the following arguments and options with the Log Analysis Tool:

Option	Description
-v level	Set the verbosity level. Valid levels are: 1 Displays only the start and end steps of each task thread (default). 2 Displays start and end steps, as well as all intermediate steps of each task thread.
-a	Display the average time for each iteration.
-i interval	Set the iteration interval to any whole number you specify for the interval. For example, if you specify 3, the Log Analysis Tool returns every 3rd iteration of a thread. If you do not specify an interval, the Log Analysis Tool returns information for all intervals.
-x type	Specify the type of information you want to exclude from the output. The valid types of output you can exclude are: threads to exclude the default agent threads and display only job threads. jobs to exclude job threads and display only the default agent threads. NOTE:The default agent threads are the Heartbeat, Event Queue, Job Status Queue, Exception Queue, Job Sync, and Thread Monitoring threads. If you do not specify a type of output to exclude, the Log Analysis Tool returns information for all threads.
-d date	Specify a date range for the information returned. You can identify a specific date or a range of dates using the format: mm/dd/yy For example, if you want information for a specific date, you can enter that date: -d 03/01/04 To specify a date range, enter the start and end dates. For example: -d 03/01/04-03/05/04 If you do not specify a date or date range, the Log Analysis Tool returns information for all dates in the log file.
-j jobID	Identify a specific job for which you want to return information. You can separate multiple job IDs by using commas. For example, to specify you want information for Job IDs 1, 12, and 23: -j 1,12,23 If you do not specify a job ID, the Log Analysis Tool returns information for all jobs.
-q siteID	Identify a specific QDB for which you want to return information. NOTE:This option is not supported in this version of the Log Analysis Tool.
-h or ?	Display usage Help for the Log Analysis Tool.
-f logfile	Specify the filename for the log file to parse. You should use this option if you are running the Log Analysis Tool in the log file directory. Use nqmlog to parse the most recent log file. The nqmlog is a hard link to the most recent log file. To parse an earlier file, enter the exact filename. You can parse multiple files by entering the filenames, separated by commas. For example: -f log20030412180531,log20030412180531 If you do not specify a filename, the Log Analysis Tool parses all UNIX agent log files.
-l path	Specify the path to the log file directory. You should use this option if you are running the Log Analysis Tool from a directory other than the log file directory. For example: $NQMAGT_HOME/log If you use this option without specifying the -f option, the Log Analysis Tool parses all log files in the directory. If you use this option with the -f option, the Log Analysis Tool parses only the files specified by the -f option.
-e messageoption	Indicate whether you want to write error messages to file or standard output. The valid messageoptions are: yes to write error messages in the log file to an Errors.txt file in the current directory. no to write error messages to standard output.