---
name: "condor_userlog"
section: "1"
platform: "linux"
package: "condor"
version: "23.9.6+dfsg-2.1+b10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_userlog"
---

# condor\_userlog(1)

HTCondor Manual Display and summarize job statistics from job log files.

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