1just-man-pages/condor_userlogG(e1n)eral Commands Majnuusatl-man-pages/condor_userlog(1)
2
3
4
6 condor_userlog Display and summarize job statistics from job log files.
7
9 condor_userlog [ -help ] [ -total | -raw ] [ -debug ] [ -evict ] [ -j
10 cluster | cluster.proc ] [ -all ] [ -hostname ] logfile ...
11
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
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
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
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
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)