1condor_userlog(1)           General Commands Manual          condor_userlog(1)
2
3
4

Name

6       condor_userlogDisplay and summarize job statistics from job log files.
7

Synopsis

9       condor_userlog[-help]  [-total  | -raw] [-debug] [-evict] [-j cluster |
10       cluster.proc] [-all] [-hostname] logfile ...
11

Description

13       condor_userlogparses the information in job log files and displays sum‐
14       maries  for  each workstation allocation and for each job. See the con‐
15       dor_submitmanual page for instructions  for  specifying  that  HTCondor
16       write a log file for your jobs.
17
18       If  -totalis  not  specified, condor_userlogwill first display a record
19       for each workstation allocation, which includes the following  informa‐
20       tion:
21
22       Job
23
24          The cluster/process id of the HTCondor job.
25
26
27
28       Host
29
30          The  host  where  the  job ran. By default, the host's IP address is
31          displayed. If -hostnameis specified, the host name will be displayed
32          instead.
33
34
35
36       Start Time
37
38          The  time  (month/day hour:minute) when the job began running on the
39          host.
40
41
42
43       Evict Time
44
45          The time (month/day hour:minute) when the job was evicted  from  the
46          host.
47
48
49
50       Wall Time
51
52          The  time  (days+hours:minutes) for which this workstation was allo‐
53          cated to the job.
54
55
56
57       Good Time
58
59          The allocated time (days+hours:min) which contributed to the comple‐
60          tion of this job. If the job exited during the allocation, then this
61          value will equal “Wall Time.” If  the  job  performed  a
62          checkpoint,  then  the value equals the work saved in the checkpoint
63          during this allocation. If the job did not exit or perform a  check‐
64          point  during this allocation, the value will be 0+00:00. This value
65          can be greater than 0 and less than “Wall Time”  if  the
66          application  completed  a  periodic checkpoint during the allocation
67          but failed to checkpoint when evicted.
68
69
70
71       CPU Usage
72
73          The CPU time (days+hours:min) which contributed to the completion of
74          this job.
75
76
77
78       condor_userlogwill then display summary statistics per host:
79
80       Host/Job
81
82          The IP address or host name for the host.
83
84
85
86       Wall Time
87
88          The  workstation time (days+hours:minutes) allocated by this host to
89          the jobs specified in the query. By default, all jobs in the log are
90          included in the query.
91
92
93
94       Good Time
95
96          The  time (days+hours:minutes) allocated on this host which contrib‐
97          uted to the completion of the jobs specified in the query.
98
99
100
101       CPU Usage
102
103          The CPU time (days+hours:minutes) obtained from this host which con‐
104          tributed to the completion of the jobs specified in the query.
105
106
107
108       Avg Alloc
109
110          The  average  length  of an allocation on this host (days+hours:min‐
111          utes).
112
113
114
115       Avg Lost
116
117          The average amount of work lost (days+hours:minutes) when a job  was
118          evicted from this host without successfully performing a checkpoint.
119
120
121
122       Goodput
123
124          This percentage is computed as Good Time divided by Wall Time.
125
126
127
128       Util.
129
130          This percentage is computed as CPU Usage divided by Good Time.
131
132
133
134       condor_userlogwill then display summary statistics per job:
135
136       Host/Job
137
138          The cluster/process id of the HTCondor job.
139
140
141
142       Wall Time
143
144          The  total  workstation  time (days+hours:minutes) allocated to this
145          job.
146
147
148
149       Good Time
150
151          The total time (days+hours:minutes) allocated to this job which con‐
152          tributed to the job's completion.
153
154
155
156       CPU Usage
157
158          The  total  CPU  time (days+hours:minutes) which contributed to this
159          job's completion.
160
161
162
163       Avg Alloc
164
165          The average length of a workstation allocation obtained by this  job
166          in minutes (days+hours:minutes).
167
168
169
170       Avg Lost
171
172          The  average  amount of work lost (days+hours:minutes) when this job
173          was evicted from a host without  successfully  performing  a  check‐
174          point.
175
176
177
178       Goodput
179
180          This percentage is computed as Good Time divided by Wall Time.
181
182
183
184       Util.
185
186          This percentage is computed as CPU Usage divided by Good Time.
187
188
189
190       Finally, condor_userlogwill display a summary for all hosts and jobs.
191

Options

193       -help
194
195          Get a brief description of the supported options
196
197
198
199       -total
200
201          Only display job totals
202
203
204
205       -raw
206
207          Display raw data only
208
209
210
211       -debug
212
213          Debug mode
214
215
216
217       -j
218
219          Select a specific cluster or cluster.proc
220
221
222
223       -evict
224
225          Select only allocations which ended due to eviction
226
227
228
229       -all
230
231          Select all clusters and all allocations
232
233
234
235       -hostname
236
237          Display host name instead of IP address
238
239
240

General Remarks

242       Since the HTCondor job log file format does not contain a year field in
243       the timestamp, all entries are assumed to occur in  the  current  year.
244       Allocations  which  begin  in  one  year  and  end  in the next will be
245       silently ignored.
246

Exit Status

248       condor_userlogwill exit with a status value of 0 (zero)  upon  success,
249       and it will exit with the value 1 (one) upon failure.
250

Author

252       Center for High Throughput Computing, University of Wisconsin-Madison
253

255       Copyright  (C) 1990-2019 Center for High Throughput Computing, Computer
256       Sciences Department, University of Wisconsin-Madison, Madison, WI.  All
257       Rights Reserved. Licensed under the Apache License, Version 2.0.
258
259
260
261                                     date                    condor_userlog(1)
Impressum