1just-man-pages/condor_userlogG(e1n)eral Commands Majnuusatl-man-pages/condor_userlog(1)
2
3
4

Name

6       condor_userlog Display and summarize job statistics from job log files.
7

Synopsis

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

Description

13       condor_userlog parses the information in job  log  files  and  displays
14       summaries  for  each  workstation  allocation and for each job. See the
15       condor_submit manual page for instructions for specifying that HTCondor
16       write a log file for your jobs.
17
18       If  -total is not specified, condor_userlog will 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 -hostname is specified, the host  name  will  be  dis‐
32          played 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  checkpoint,
62          then  the  value equals the work saved in the checkpoint during this
63          allocation. If the job did not exit or perform a  checkpoint  during
64          this  allocation,  the  value  will  be  0+00:00.  This value can be
65          greater than 0 and less than ``Wall Time'' if the  application  com‐
66          pleted  a  periodic  checkpoint  during the allocation but failed to
67          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_userlog will 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_userlog will 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_userlog will 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_userlog will 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-2018 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     just-man-pages/condor_userlog(1)
Impressum