lsacct - report accounting statistics on completed RES tasks in the LSF system
lsacct [ -h ] [ -V ] [ -l ] [ -f logfile ] [ -u userlist | -u all ] [ -m machinelist ] [ -C time0, time1 ] [ -S time0, time1 ] [ pid ... ]
The lsacct command displays statistics on completed tasks run through the LSF RES server. When each remote task completes, the RES logs task statistics in the task log file (see lsf.acct(5) ) by RES. lsacct generates reports from these logs; it does not report on tasks that are still in progress.
By default, lsacct produces a summary of the statistics for all jobs selected. The statistics generated are described in the SUMMARY section below. The lsacct -l option displays individual statistics for each job, as well as the summary for all jobs. The additional fields are described in the PER-JOB STATISTICS section.
The other options specify the tasks you are interested in, such as tasks belonging to certain users, tasks executed on certain hosts, tasks with specific pids, or tasks that began or completed execution within specified time intervals.
Only those tasks that satisfy all the optional specifications are considered. If no tasks are specified, all tasks belonging to the user invoking lsacct are considered.
The RES on each host writes its own accounting log file. These files can be merged using the lsacctmrg(1) command to generate statistics for the entire LSF cluster.
All times are reported in seconds; all sizes are reported in kilobytes.
-h Print command usage to stderr and exit.
-V Print LSF release version to stderr and exit.
-l Also display individual statistics about each selected job, as described in the PER-JOB STATISTICS section. The default is to display only the statistics described in the SUMMARY section.
-f logfile
Specify the file name of the task log file to be analyzed. The default
is to use the task log file currently used by the RES, either
LSF_RES_ACCTDIR/lsf.acct.<hostname> or /tmp/lsf.acct.<hostname> (see
lsf.acct(5)
). The lsacct -f option is useful for analyzing old log
files or merged files created by the lsacctmrg(1)
command.
-C time0, time1
Consider only those tasks that completed or exited within the time
interval time0, time1 (see TIME FORMAT). The default is to consider
all logged tasks.
-S time0, time1
Consider only those tasks that began executing within the time interval
time0, time1 (see TIME FORMAT). The default is to consider all
logged tasks.
-m machinelist
Consider only those tasks executed on the hosts whose names are given
in machinelist. If two or more host names are given, then they must
be separated by spaces and enclosed by (") or ('). The default is to
consider all hosts used by LSF.
-u userlist | -u all
Consider only those tasks belonging to the users whose login names
and/or user IDs are given in userlist, or by all users (if the
reserved user name all is specified). If two or more user names
and/or IDs are given, then they must be separated by spaces and
enclosed by (") or ('). A mixture of user names and IDs can be used
in the list. The default is to consider only the tasks belonging to
the user invoking lsacct.
pid ...
Consider only those tasks specified by pid .... This option overrides
all other options except -h, -V, -l and -f. The default is to consider
all the tasks satisfying other options.
The fields described in this section are always displayed. The total, average, maximum and minimum resource usage statistics apply to all specified tasks.
The SUMMARY set includes the following statistics fields:
Total number of tasks (including total number of tasks completed successfully and total number of exited tasks)
Time range of started tasks
The started times of the first and the last task selected
Time range of ended tasks
The completion or exit times of the first and last task selected
Resource usage of tasks selected (see getrusage (2)):
CPU time
Total cpu time consumed by the task
Page faults
The number of page faults
Swaps
The number of times the process was swapped out
Blocks in
The number of blocks input
Blocks out
The number of blocks output
Messages sent
The number of System V IPC messages sent
Messages rcvd
The number of IPC messages received
Voluntary cont sw
The number of voluntary context switches
Involuntary con sw
The number of involuntary context switches
Turnaround
The elapsed time from task execution to task completion
The following detailed information on individual tasks is displayed only if the -l option is given.
Starting time
The time the task started
User and Host Name
The user name and the name of the host from which the job was submitted,
in the format username@host
PID The UNIX process ID of the task
Execution host
The host where the command was run
Command line
The complete command line that was executed
CWD The current work directory of the task
Completion time
The time that the task completed
Exit status
The UNIX exit status of the task
Accounting Information
The resource use statistics for the task; individual fields are
described in the SUMMARY section
The format of time in the options -C and -S is the same as in bhist(1) .
See bhist(1) for details.
lsf.acct(5) lsacctmrg(1) , res(8) , bhist(1) ,