1CONDOR_HISTORY(1) HTCondor Manual CONDOR_HISTORY(1)
2
6 condor_history - HTCondor Manual
7 View log of HTCondor jobs completed to date
9
13 condor_history [-help ]
14 condor_history [-name name] [-pool centralmanagerhostname[:portnumber]]
16 [-backwards] [-forwards] [-constraint expr] [-file filename] [-userlog
17 filename] [-search path] [-dir | -directory] [-local] [-startd]
18 [-epochs] [-format formatString AttributeName] [-autoformat[:jlhVr,tng]
19 attr1 [attr2 ...]] [-l | -long | -xml | -json | -jsonl] [-match |
20 -limit number] [-attributes attr1[,attr2...]] [-print-format file ]
21 [-wide] [-since time_or_jobid ] [-completedsince time_expr] [-scanlimit
22 number] [cluster | cluster.process | owner]
23
25 condor_history displays a summary of all HTCondor jobs listed in the
26 specified history files. If no history files are specified with the
27 -file option, the local history file as specified in HTCondor's config‐
28 uration file ($(SPOOL)/history by default) is read. The default listing
29 summarizes in reverse chronological order each job on a single line,
30 and contains the following items:
31 ID The cluster/process id of the job.
33 OWNER The owner of the job.
35 SUBMITTED
37 The month, day, hour, and minute the job was submitted to the
38 queue.
39 RUN_TIME
41 Remote wall clock time accumulated by the job to date in
42 days, hours, minutes, and seconds, given as the job ClassAd
43 attribute RemoteWallClockTime.
44 ST Completion status of the job (C = completed and X = removed).
46 COMPLETED
48 The time the job was completed.
49 CMD The name of the executable.
51 If a job ID (in the form of cluster_id or cluster_id.proc_id) or an
53 owner is provided, output will be restricted to jobs with the specified
54 IDs and/or submitted by the specified owner. The -constraint option can
55 be used to display jobs that satisfy a specified boolean expression.
56
58 -help Display usage information and exit.
59 -name name
61 Query the named condor_schedd daemon. If used with -startd,
62 query the named condor_startd daemon
63 -pool centralmanagerhostname[:portnumber]
65 Use the centralmanagerhostname as the central manager to lo‐
66 cate condor_schedd daemons. The default is the COLLEC‐
67 TOR_HOST, as specified in the configuration.
68 -backwards
70 List jobs in reverse chronological order. The job most re‐
71 cently added to the history file is first. This is the de‐
72 fault ordering.
73 -forwards
75 List jobs in chronological order. The job most recently added
76 to the history file is last. At least 4 characters must be
77 given to distinguish this option from the -file and -format
78 options.
79 -constraint expr
81 Display jobs that satisfy the expression.
82 -since jobid or expr
84 Stop scanning when the given jobid is found or when the ex‐
85 pression becomes true.
86 -completedsince time_expr
88 Scan until the first job that completed on or before the
89 given unix timestamp. The argument can be any expression
90 that evaluates to a unix timestamp. This option is equiva‐
91 lent to -since 'CompletionDate<=time_expr'.
92 -scanlimit Number
94 Stop scanning when the given number of ads have been read.
95 -limit Number
97 Limit the number of jobs displayed to Number. Same option as
98 -match.
99 -match Number
101 Limit the number of jobs displayed to Number. Same option as
102 -limit.
103 -local Read from local history files even if there is a SCHEDD_HOST
105 configured.
106 -startd
108 Read from Startd history files rather than Schedd history
109 files. If used with the -name option, query is sent as a
110 command to the given Startd which must be version 9.0 or
111 later.
112 -epochs[:d]
114 Read per job run instance recording also known as job epochs
115 instead of default history file. The -epochs option may be
116 followed by a colon character for extra functionality:
117 d Delete job epoch files after finished reading. This option
119 only deletes epoch files store within JOB_EPOCH_HISTORY_DIR,
120 and can not be used with -match, -limit, or -scanlimit.
121 -file filename
123 Use the specified file instead of the default history file.
124 -userlog filename
126 Display jobs, with job information coming from a job event
127 log, instead of from the default history file. A job event
128 log does not contain all of the job information, so some
129 fields in the normal output of condor_history will be blank.
130 -search path
132 Use the specified path to filename and all matching condor
133 time rotated files filename.YYYYMMDDTHHMMSS instead of the
134 default history file. If used with -dir option then con‐
135 dor_history will use the provided path as the directory to
136 search for specific pattern matching history files.
137 -dir or -directory
139 Search for files in a sources alternate directory configura‐
140 tion knob to read from instead of default history file. Note:
141 only applies to -epochs.
142 -format formatString AttributeName
144 Display jobs with a custom format. See the condor_q man page
145 -format option for details.
146 -autoformat[:jlhVr,tng] attr1 [attr2 ...] or -af[:jlhVr,tng] attr1
148 [attr2 ...]
149 (output option) Display attribute(s) or expression(s) format‐
150 ted in a default way according to attribute types. This op‐
151 tion takes an arbitrary number of attribute names as argu‐
152 ments, and prints out their values, with a space between each
153 value and a newline character after the last value. It is
154 like the -format option without format strings.
155 It is assumed that no attribute names begin with a dash char‐
157 acter, so that the next word that begins with dash is the
158 start of the next option. The autoformat option may be fol‐
159 lowed by a colon character and formatting qualifiers to devi‐
160 ate the output formatting from the default:
161 j print the job ID as the first field,
163 l label each field,
165 h print column headings before the first line of output,
167 V use %V rather than %v for formatting (string values are
169 quoted),
170 r print "raw", or unevaluated values,
172 , add a comma character after each field,
174 t add a tab character before each field instead of the de‐
176 fault space character,
177 n add a newline character after each field,
179 g add a newline character between ClassAds, and suppress spa‐
181 ces before each field.
182 Use -af:h to get tabular values with headings.
184 Use -af:lrng to get -long equivalent format.
186 The newline and comma characters may not be used together.
188 The l and h characters may not be used together.
189 -print-format file
191 Read output formatting information from the given custom
192 print format file. see Print Formats for more information
193 about custom print format files.
194 -l or -long
196 Display job ClassAds in long format.
197 -attributes attrs
199 Display only the given attributes when the -long o ption is
200 used.
201 -xml Display job ClassAds in XML format. The XML format is fully
203 defined in the reference manual, obtained from the ClassAds
204 web page, with a link at
205 http://htcondor.org/classad/classad.html.
206 -json Display job ClassAds in JSON format.
208 -jsonl Display job ClassAds in JSON-Lines format: one job ad per
210 line.
211 -wide[:number]
213 Restrict output to the given column width. Default width is
214 80 columns, if -wide is used without the optional number ar‐
215 gument, the width of the output is not restricted.
216
218 condor_history will exit with a status value of 0 (zero) upon success,
219 and it will exit with the value 1 (one) upon failure.
220
222 HTCondor Team
223
225 1990-2023, Center for High Throughput Computing, Computer Sciences De‐
226 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
227 under the Apache License, Version 2.0.
228 Oct 02, 2023 CONDOR_HISTORY(1)