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-2016 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.

                                                   April 2018                                  condor_userlog(1)