1condor_status(1) General Commands Manual condor_status(1)
2
6 condor_statusDisplay status of the HTCondor pool
7
9 condor_status[-debug] [help options] [query options] [display options]
10 [custom options] [name ...]
11
13 condor_statusis a versatile tool that may be used to monitor and query
14 the HTCondor pool. The condor_statustool can be used to query resource
15 information, submitter information, checkpoint server information, and
16 daemon master information. The specific query sent and the resulting
17 information display is controlled by the query options supplied.
18 Queries and display formats can also be customized.
19 The options that may be supplied to condor_statusbelong to five groups:
21 * Help optionsprovide information about the condor_statustool.
23 * Query optionscontrol the content and presentation of status infor‐
25 mation.
26 * Display optionscontrol the display of the queried information.
28 * Custom optionsallow the user to customize query and display infor‐
30 mation.
31 * Host optionsspecify specific machines to be queried
33 At any time, only one help option, one query optionand one display
35 optionmay be specified. Any number of custom optionsand host optionsmay
36 be specified.
37
39 -debug
40 Causes debugging information to be sent to stderr, based on the
42 value of the configuration variable TOOL_DEBUG.
43 -help
47 (Help option) Display usage information.
49 -diagnose
53 (Help option) Print out ClassAd query without performing the query.
55 -absent
59 (Query option) Query for and display only absent resources.
61 -ads filename
65 (Query option) Read the set of ClassAds in the file specified by
67 filename, instead of querying the condor_collector.
68 -annex name
72 (Query option) Query for and display only resources in the named
74 annex.
75 -any
79 (Query option) Query all ClassAds and display their type, target
81 type, and name.
82 -avail
86 (Query option) Query condor_startdClassAds and identify resources
88 which are available.
89 -ckptsrvr
93 (Query option) Query condor_ckpt_serverClassAds and display check‐
95 point server attributes.
96 -claimed
100 (Query option) Query condor_startdClassAds and print information
102 about claimed resources.
103 -cod
107 (Query option) Display only machine ClassAds that have COD claims.
109 Information displayed includes the claim ID, the owner of the claim,
110 and the state of the COD claim.
111 -collector
115 (Query option) Query condor_collectorClassAds and display
117 attributes.
118 -defrag
122 (Query option) Query condor_defragClassAds.
124 -direct hostname
128 (Query option) Go directly to the given host name to get the Clas‐
130 sAds to display. By default, returns the condor_startdClassAd. If
131 -scheddis also given, return the condor_scheddClassAd on that host.
132 -java
136 (Query option) Display only Java-capable resources.
138 -license
142 (Query option) Display license attributes.
144 -master
148 (Query option) Query condor_masterClassAds and display daemon master
150 attributes.
151 -negotiator
155 (Query option) Query condor_negotiatorClassAds and display
157 attributes.
158 -pool centralmanagerhostname[:portnumber]
162 (Query option) Query the specified central manager using an optional
164 port number. condor_statusqueries the machine specified by the con‐
165 figuration variable COLLECTOR_HOSTby default.
166 -run
170 (Query option) Display information about machines currently running
172 jobs.
173 -schedd
177 (Query option) Query condor_scheddClassAds and display attributes.
179 -server
183 (Query option) Query condor_startdClassAds and display resource
185 attributes.
186 -startd
190 (Query option) Query condor_startdClassAds.
192 -state
196 (Query option) Query condor_startdClassAds and display resource
198 state information.
199 -statistics WhichStatistics
203 (Query option) Can only be used if the -directoption has been speci‐
205 fied. Identifies which Statistics attributes to include in the Clas‐
206 sAd. WhichStatisticsis specified using the same syntax as defined
207 for STATISTICS_TO_PUBLISH. A definition is in the HTCondor Adminis‐
208 trator's manual section on configuration (section ).
209 -storage
213 (Query option) Display attributes of machines with network storage
215 resources.
216 -submitters
220 (Query option) Query ClassAds sent by submitters and display impor‐
222 tant submitter attributes.
223 -subsystem type
227 (Query option) If typeis one of collector, negotiator, master,
229 schedd, or startd, then behavior is the same as the query option
230 without the -subsystemoption. For example, -subsystem collectoris
231 the same as -collector. A value of typeof CkptServer, Machine, Dae‐
232 monMaster, or Schedulertargets that type of ClassAd.
233 -vm
237 (Query option) Query condor_startdClassAds, and display only VM-
239 enabled machines. Information displayed includes the machine name,
240 the virtual machine software version, the state of machine, the vir‐
241 tual machine memory, and the type of networking.
242 -offline
246 (Query option) Query condor_startdClassAds, and display, for each
248 machine with at least one offline universe, which universes are off‐
249 line for it.
250 -attributes Attr1[,Attr2 ...]
254 (Display option) Explicitly list the attributes in a comma separated
256 list which should be displayed when using the -xml, -jsonor -longop‐
257 tions. Limiting the number of attributes increases the efficiency of
258 the query.
259 -expert
263 (Display option) Display shortened error messages.
265 -long
269 (Display option) Display entire ClassAds. Implies that totals will
271 not be displayed.
272 -limitnum
276 (Query option) At most numresults should be displayed.
278 -sort expr
282 (Display option) Change the display order to be based on ascending
284 values of an evaluated expression given by expr. Evaluated expres‐
285 sions of a string type are in a case insensitive alphabetical order.
286 If multiple -sortarguments appear on the command line, the primary
287 sort will be on the leftmost one within the command line, and it is
288 numbered 0. A secondary sort will be based on the second expression,
289 and it is numbered 1. For informational or debugging purposes, the
290 ClassAd output to be displayed will appear as if the ClassAd had two
291 additional attributes. CondorStatusSortKeyExpr<N>is the expression,
292 where <N>is replaced by the number of the sort. CondorStatus‐
293 SortKey<N>gives the result of evaluating the sort expression that is
294 numbered <N>.
295 -total
299 (Display option) Display totals only.
301 -xml
305 (Display option) Display entire ClassAds, in XML format. The XML
307 format is fully defined in the reference manual, obtained from the
308 ClassAds web page, with a link at http://htcondor.org/classad/clas‐
309 sad.html.
310 -json
314 (Display option) Display entire ClassAds in JSON format.
316 -constraint const
320 (Custom option) Add constraint expression.
322 -compact
326 (Custom option) Show compact form, rolling up slots into a single
328 line.
329 -format fmt attr
333 (Custom option) Display attribute or expression attrin format fmt.
335 To display the attribute or expression the format must contain a
336 single printf(3)-style conversion specifier. Attributes must be from
337 the resource ClassAd. Expressions are ClassAd expressions and may
338 refer to attributes in the resource ClassAd. If the attribute is not
339 present in a given ClassAd and cannot be parsed as an expression,
340 then the format option will be silently skipped. %r prints the
341 unevaluated, or raw values. The conversion specifier must match the
342 type of the attribute or expression. %s is suitable for strings such
343 as Name, %d for integers such as LastHeardFrom, and %f for floating
344 point numbers such as LoadAvg. %v identifies the type of the
345 attribute, and then prints the value in an appropriate format. %V
346 identifies the type of the attribute, and then prints the value in
347 an appropriate format as it would appear in the -longformat. As an
348 example, strings used with %V will have quote marks. An incorrect
349 format will result in undefined behavior. Do not use more than one
350 conversion specifier in a given format. More than one conversion
351 specifier will result in undefined behavior. To output multiple
352 attributes repeat the -formatoption once for each desired attribute.
353 Like printf(3)-style formats, one may include other text that will
354 be reproduced directly. A format without any conversion specifiers
355 may be specified, but an attribute is still required. Include a
356 backslash followed by an `n' to specify a line break.
357 -autoformat[:lhVr,tng] attr1 [attr2 ...]or -af[:lhVr,tng] attr1 [attr2
363 ...]
364 (Output option) Display attribute(s) or expression(s) formatted in a
366 default way according to attribute types. This option takes an arbi‐
367 trary number of attribute names as arguments, and prints out their
368 values, with a space between each value and a newline character
369 after the last value. It is like the -formatoption without format
370 strings. This output option does notwork in conjunction with the
371 -runoption.
372 It is assumed that no attribute names begin with a dash character,
374 so that the next word that begins with dash is the start of the next
375 option. The autoformatoption may be followed by a colon character
376 and formatting qualifiers to deviate the output formatting from the
377 default:
378 llabel each field,
380 hprint column headings before the first line of output,
382 Vuse %V rather than %v for formatting (string values are quoted),
384 rprint "raw", or unevaluated values,
386 ,add a comma character after each field,
388 tadd a tab character before each field instead of the default space
390 character,
391 nadd a newline character after each field,
393 gadd a newline character between ClassAds, and suppress spaces
395 before each field.
396 Use -af:hto get tabular values with headings.
398 Use -af:lrngto get -long equivalent format.
400 The newline and comma characters may notbe used together. The land
402 hcharacters may notbe used together.
403 -target filename
407 (Custom option) Where evaluation requires a target ClassAd to evalu‐
409 ate against, file filenamecontains the target ClassAd.
410 -merge filename
414 (Custom option) Ads will be read from filename, which may be -to
416 indicate standard in, and compared to the ads selected by the query
417 specified by the remainder of the command line. Ads will be consid‐
418 ered the same if their sort keys match; sort keys may be specified
419 with [-sort <key>]. This option will cause up to three tables to
420 print, in the following order, depending on where a given ad
421 appeared: first, the ads which appeared in the query but not in
422 filename; second, the ads which appeared in both the query and in
423 filename; third, the ads which appeared in filenamebut not in the
424 query.
425 By default, banners will label each table. If -xmlis also given, the
427 same banners will separate three valid XML documents, one for each
428 table. If -jsonis also given, a single JSON object will be produced,
429 with the usual JSON output for each table labeled as an element in
430 the object.
431 The -annexoption changes this default so that the banners are not
433 printed and the tables are formatted differently. In this case, the
434 ads in filenameare expected to have different contents from the ads
435 in the query, so many others will behave strangely.
436
440 * The default output from condor_statusis formatted to be human
441 readable, not script readable. In an effort to make the output fit
442 within 80 characters, values in some fields might be truncated. Fur‐
443 thermore, the HTCondor Project can (and does) change the formatting
444 of this default output as we see fit. Therefore, any script that is
445 attempting to parse data from condor_statusis strongly encouraged to
446 use the -formatoption (described above).
447 * The information obtained from condor_startdand condor_schedddae‐
451 mons may sometimes appear to be inconsistent. This is normal since
452 condor_startdand condor_schedddaemons update the HTCondor manager at
453 different rates, and since there is a delay as information propa‐
454 gates through the network and the system.
455 * Note that the ActivityTimein the Idlestate is notthe amount of
459 time that the machine has been idle. See the section on con‐
460 dor_startdstates in the Administrator's Manualfor more information
461 (section ).
462 * When using condor_statuson a pool with SMP machines, you can
466 either provide the host name, in which case you will get back infor‐
467 mation about all slots that are represented on that host, or you can
468 list specific slots by name. See the examples below for details.
469 * If you specify host names, without domains, HTCondor will automat‐
473 ically try to resolve those host names into fully qualified host
474 names for you. This also works when specifying specific nodes of an
475 SMP machine. In this case, everything after the “@” sign
476 is treated as a host name and that is what is resolved.
477 * You can use the -directoption in conjunction with almost any other
481 set of options. However, at this time, the only daemon that will
482 allow direct queries for its ad(s) is the condor_startd. So, the
483 only options currently not supported with -directare -scheddand
484 -master. Most other options use startd ads for their information, so
485 they work seamlessly with -direct. The only other restriction on
486 -directis that you may only use 1 -directoption at a time. If you
487 want to query information directly from multiple hosts, you must run
488 condor_statusmultiple times.
489 * Unless you use the local host name with -direct, condor_statuswill
493 still have to contact a collector to find the address where the
494 specified daemon is listening. So, using a -pooloption in conjunc‐
495 tion with -directjust tells condor_statuswhich collector to query to
496 find the address of the daemon you want. The information actually
497 displayed will still be retrieved directly from the daemon you spec‐
498 ified as the argument to -direct.
499
503 Example 1To view information from all nodes of an SMP machine, use only
504 the host name. For example, if you had a 4-CPU machine, named vul‐
505 ture.cs.wisc.edu, you might see
506 % condor_status vulture
508 Name OpSys Arch State Activity LoadAv Mem
510 ActvtyTime
511 slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512
513 0+01:47:42
514 slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512
515 0+01:48:19
516 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
517 1+11:05:32
518 slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512
519 1+11:05:34
520 Total Owner Claimed Unclaimed Matched Preempting
522 Backfill
523 INTEL/LINUX 4 0 2 2 0 0
525 0
526 Total 4 0 2 2 0 0
528 0
529 Example 2To view information from a specific nodes of an SMP machine,
531 specify the node directly. You do this by providing the name of the
532 slot. This has the form slot#@hostname. For example:
533 % condor_status slot3@vulture
535 Name OpSys Arch State Activity LoadAv Mem
537 ActvtyTime
538 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512
540 1+11:10:32
541 Total Owner Claimed Unclaimed Matched Preempting
543 Backfill
544 INTEL/LINUX 1 0 0 1 0 0
546 0
547 Total 1 0 0 1 0 0
549 0
550 Constraint option examples
552 The Unix command to use the constraint option to see all machines with
554 the OpSysof "LINUX":
555 % condor_status -constraint OpSys==\"LINUX\"
557 Note that quotation marks must be escaped with the backslash characters
559 for most shells.
560 The Windows command to do the same thing:
562 >condor_status -constraint " OpSys==""LINUX"" "
564 Note that quotation marks are used to delimit the single argument which
566 is the expression, and the quotation marks that identify the string
567 must be escaped by using a set of two double quote marks without any
568 intervening spaces.
569 To see all machines that are currently in the Idle state, the Unix com‐
571 mand is
572 % condor_status -constraint State==\"Idle\"
574 To see all machines that are bench marked to have a MIPS rating of more
576 than 750, the Unix command is
577 % condor_status -constraint 'Mips>750'
579 -cod option example
581 The -codoption displays the status of COD claims within a given HTCon‐
583 dor pool.
584 Name ID ClaimState TimeInState RemoteUser JobId Keyword
586 astro.cs.wi COD1 Idle 0+00:00:04 wright
587 chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
588 chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
589 Total Idle Running Suspended Vacating Killing
591 INTEL/LINUX 3 1 1 1 0 0
592 Total 3 1 1 1 0 0
593 -format option exampleTo display the name and memory attributes of each
595 job ClassAd in a format that is easily parsable by other tools:
596 % condor_status -format "%s " Name -format "%d\n" Memory
598 To do the same with the autoformatoption, run
600 % condor_status -autoformat Name Memory
602
604 condor_statuswill exit with a status value of 0 (zero) upon success,
605 and it will exit with the value 1 (one) upon failure.
606
608 Center for High Throughput Computing, University of Wisconsin-Madison
609
611 Copyright (C) 1990-2019 Center for High Throughput Computing, Computer
612 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
613 Rights Reserved. Licensed under the Apache License, Version 2.0.
614 date condor_status(1)