NAME

       condor_userlog - HTCondor Manual

       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_submit manual page for instructions for specifying that
       HTCondor write a log file for your jobs.

       If -total is not specified, condor_userlog will 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 -hostname is
                 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."  Otherwise, it will
                 0+00:00; self-checkpoint are presently ignored.

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

       condor_userlog will 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.

          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_userlog will 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;
                 self-checkpoints are presently ignored.

          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_userlog will 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_userlog  will exit with a status value of 0 (zero) upon success, and it will exit with the value 1
       (one) upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024, Center for High Throughput Computing, Computer Sciences Department, University  of  Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Aug 06, 2025                                 CONDOR_USERLOG(1)