Name

       condor_userlog Display - and summarize job statistics from job log files.

Synopsis

       condor_userlog  [-help]  [-total  |  -raw]  [-debug]  [-evict] [-j cluster | cluster.proc]
       [-all] [-hostname] logfile ...

Description

       condor_userlog parses the information in job log files and  displays  summaries  for  each
       workstation allocation and for each job. See the condor_submitmanual page for instructions
       for specifying that HTCondor write a log file for your jobs.

       If -totalis not specified, condor_userlogwill first display a record for each  workstation
       allocation, which includes the following information:

       Job

          The cluster/process id of the HTCondor job.

       Host

          The  host  where  the  job  ran.  By  default,  the  host's IP address is displayed. If
          -hostnameis specified, the host name will be displayed instead.

       Start Time

          The time (month/day hour:minute) when the job began running on the host.

       Evict Time

          The time (month/day hour:minute) when the job was evicted from the host.

       Wall Time

          The time (days+hours:minutes) for which this workstation was allocated to the job.

       Good Time

          The allocated time (days+hours:min) which contributed to the completion of this job. If
          the  job exited during the allocation, then this value will equal ``Wall Time.'' If the
          job performed a checkpoint, then the value equals the  work  saved  in  the  checkpoint
          during  this  allocation.  If  the job did not exit or perform a checkpoint during this
          allocation, the value will be 0+00:00. This value can be greater than 0 and  less  than
          ``Wall  Time'' if the application completed a periodic checkpoint during the allocation
          but failed to checkpoint when evicted.

       CPU Usage

          The CPU time (days+hours:min) which contributed to the completion of this job.

       condor_userlogwill then display summary statistics per host:

       Host/Job

          The IP address or host name for the host.

       Wall Time

          The workstation time (days+hours:minutes) allocated by this host to the jobs  specified
          in the query. By default, all jobs in the log are included in the query.

       Good Time

          The  time  (days+hours:minutes)  allocated  on  this  host  which  contributed  to  the
          completion of the jobs specified in the query.

       CPU Usage

          The CPU time (days+hours:minutes) obtained from this  host  which  contributed  to  the
          completion of the jobs specified in the query.

       Avg Alloc

          The average length of an allocation on this host (days+hours:minutes).

       Avg Lost

          The  average  amount of work lost (days+hours:minutes) when a job was evicted from this
          host without successfully performing a checkpoint.

       Goodput

          This percentage is computed as Good Time divided by Wall Time.

       Util.

          This percentage is computed as CPU Usage divided by Good Time.

       condor_userlogwill then display summary statistics per job:

       Host/Job

          The cluster/process id of the HTCondor job.

       Wall Time

          The total workstation time (days+hours:minutes) allocated to this job.

       Good Time

          The total time (days+hours:minutes) allocated to this  job  which  contributed  to  the
          job's completion.

       CPU Usage

          The total CPU time (days+hours:minutes) which contributed to this job's completion.

       Avg Alloc

          The  average  length  of  a  workstation  allocation  obtained  by  this job in minutes
          (days+hours:minutes).

       Avg Lost

          The average amount of work lost (days+hours:minutes) when this job was evicted  from  a
          host without successfully performing a checkpoint.

       Goodput

          This percentage is computed as Good Time divided by Wall Time.

       Util.

          This percentage is computed as CPU Usage divided by Good Time.

       Finally, condor_userlogwill display a summary for all hosts and jobs.

Options

       -help

          Get a brief description of the supported options

       -total

          Only display job totals

       -raw

          Display raw data only

       -debug

          Debug mode

       -j

          Select a specific cluster or cluster.proc

       -evict

          Select only allocations which ended due to eviction

       -all

          Select all clusters and all allocations

       -hostname

          Display host name instead of IP address

General Remarks

       Since the HTCondor job log file format does not contain a year field in the timestamp, all
       entries are assumed to occur in the current year. Allocations which begin in one year  and
       end in the next will be silently ignored.

Exit Status

       condor_userlogwill  exit  with  a  status value of 0 (zero) upon success, and it will exit
       with the value 1 (one) upon failure.

Author

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2013  Center  for  High  Throughput  Computing,   Computer   Sciences
       Department,  University  of  Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
       under the Apache License, Version 2.0.

                                           January 2014                         condor_userlog(1)