1CONDOR_USERLOG(1)               HTCondor Manual              CONDOR_USERLOG(1)
2
3
4

NAME

6       condor_userlog - HTCondor Manual
7
8       Display and summarize job statistics from job log files.
9
10

SYNOPSIS

12       condor_userlog  [-help ] [-total | -raw ] [-debug ] [-evict ] [-j clus‐
13       ter | cluster.proc] [-all ] [-hostname ] logfile ...
14

DESCRIPTION

16       condor_userlog parses the information in job  log  files  and  displays
17       summaries  for  each  workstation  allocation and for each job. See the
18       condor_submit manual page for instructions for specifying that HTCondor
19       write a log file for your jobs.
20
21       If  -total is not specified, condor_userlog will first display a record
22       for each workstation allocation, which includes the following  informa‐
23       tion:
24
25          Job    The cluster/process id of the HTCondor job.
26
27          Host   The host where the job ran. By default, the host's IP address
28                 is displayed. If -hostname is specified, the host  name  will
29                 be displayed instead.
30
31          Start Time
32                 The  time  (month/day hour:minute) when the job began running
33                 on the host.
34
35          Evict Time
36                 The time (month/day hour:minute) when  the  job  was  evicted
37                 from the host.
38
39          Wall Time
40                 The  time (days+hours:minutes) for which this workstation was
41                 allocated to the job.
42
43          Good Time
44                 The allocated time (days+hours:min) which contributed to  the
45                 completion of this job.  If the job exited during the alloca‐
46                 tion, then this value will equal "Wall Time."  Otherwise,  it
47                 will 0+00:00; self-checkpoint are presently ignored.
48
49          CPU Usage
50                 The  CPU  time (days+hours:min) which contributed to the com‐
51                 pletion of this job.
52
53       condor_userlog will then display summary statistics per host:
54
55          Host/Job
56                 The IP address or host name for the host.
57
58          Wall Time
59                 The workstation time (days+hours:minutes) allocated  by  this
60                 host to the jobs specified in the query. By default, all jobs
61                 in the log are included in the query.
62
63          Good Time
64                 The time (days+hours:minutes) allocated on  this  host  which
65                 contributed  to  the  completion of the jobs specified in the
66                 query.
67
68          CPU Usage
69                 The CPU time (days+hours:minutes)  obtained  from  this  host
70                 which  contributed to the completion of the jobs specified in
71                 the query.
72
73          Avg Alloc
74                 The  average  length  of   an   allocation   on   this   host
75                 (days+hours:minutes).
76
77          Avg Lost
78                 The  average  amount of work lost (days+hours:minutes) when a
79                 job was evicted from this host.
80
81          Goodput
82                 This percentage is computed as  Good  Time  divided  by  Wall
83                 Time.
84
85          Util.  This  percentage  is  computed  as  CPU Usage divided by Good
86                 Time.
87
88       condor_userlog will then display summary statistics per job:
89
90          Host/Job
91                 The cluster/process id of the HTCondor job.
92
93          Wall Time
94                 The total workstation time (days+hours:minutes) allocated  to
95                 this job.
96
97          Good Time
98                 The  total  time  (days+hours:minutes)  allocated to this job
99                 which contributed to the job's completion.
100
101          CPU Usage
102                 The total CPU time (days+hours:minutes) which contributed  to
103                 this job's completion.
104
105          Avg Alloc
106                 The  average  length  of a workstation allocation obtained by
107                 this job in minutes (days+hours:minutes).
108
109          Avg Lost
110                 The average amount of  work  lost  (days+hours:minutes)  when
111                 this  job was evicted from a host; self-checkpoints are pres‐
112                 ently ignored.
113
114          Goodput
115                 This percentage is computed as  Good  Time  divided  by  Wall
116                 Time.
117
118          Util.  This  percentage  is  computed  as  CPU Usage divided by Good
119                 Time.
120
121       Finally, condor_userlog will display a summary for all hosts and jobs.
122

OPTIONS

124          -help  Get a brief description of the supported options
125
126          -total Only display job totals
127
128          -raw   Display raw data only
129
130          -debug Debug mode
131
132          -j     Select a specific cluster or cluster.proc
133
134          -evict Select only allocations which ended due to eviction
135
136          -all   Select all clusters and all allocations
137
138          -hostname
139                 Display host name instead of IP address
140

GENERAL REMARKS

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

EXIT STATUS

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

AUTHOR

152       HTCondor Team
153

155       1990-2023, Center for High Throughput Computing, Computer Sciences  De‐
156       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
157       under the Apache License, Version 2.0.
158
159
160
161
162                                 Oct 02, 2023                CONDOR_USERLOG(1)
Impressum