condor_userlog - Man Page

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:

FieldDescription
JobThe cluster/process id of the HTCondor job.
HostThe 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 TimeThe time (month/day hour:minute) when the job began running on the host.
Evict TimeThe time (month/day hour:minute) when the job was evicted from the host.
Wall TimeThe time (days+hours:minutes) for which this workstation was allocated to the job.
Good TimeThe 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-checkpoints are presently ignored.
CPU UsageThe CPU time (days+hours:min) which contributed to the completion of this job.

condor_userlog will then display summary statistics per host:

FieldDescription
Host/JobThe IP address or host name for the host.
Wall TimeThe 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 TimeThe time (days+hours:minutes) allocated on this host which contributed to the completion of the jobs specified in the query.
CPU UsageThe CPU time (days+hours:minutes) obtained from this host which contributed to the completion of the jobs specified in the query.
Avg AllocThe average length of an allocation on this host (days+hours:minutes).
Avg LostThe average amount of work lost (days+hours:minutes) when a job was evicted from this host.
GoodputThis 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:

FieldDescription
Host/JobThe cluster/process id of the HTCondor job.
Wall TimeThe total workstation time (days+hours:minutes) allocated to this job.
Good TimeThe total time (days+hours:minutes) allocated to this job which contributed to the job's completion.
CPU UsageThe total CPU time (days+hours:minutes) which contributed to this job's completion.
Avg AllocThe average length of a workstation allocation obtained by this job (days+hours:minutes).
Avg LostThe average amount of work lost (days+hours:minutes) when this job was evicted from a host; self-checkpoints are presently ignored.
GoodputThis 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

Info

Aug 25, 2026 HTCondor Manual