Provided by: condor_23.4.0+dfsg-1ubuntu4_amd64 
NAME
condor_status - HTCondor Manual
Display status of the HTCondor pool
SYNOPSIS
condor_status [-debug ] [help options ] [query options ] [display options ] [custom
options ] [name ... ]
DESCRIPTION
condor_status is a versatile tool that may be used to monitor and query the HTCondor pool.
The condor_status tool can be used to query resource information, submitter information,
and daemon master information. The specific query sent and the resulting information
display is controlled by the query options supplied. Queries and display formats can also
be customized.
The options that may be supplied to condor_status belong to five groups:
• Help options provide information about the condor_status tool.
• Query options control the content and presentation of status information.
• Display options control the display of the queried information.
• Custom options allow the user to customize query and display information.
• Host options specify specific machines to be queried
At any time, only one help option, one query option and one display option may be
specified. Any number of custom options and host options may be specified.
OPTIONS
-debug Causes debugging information to be sent to stderr, based on the value of the
configuration variable TOOL_DEBUG.
-help (Help option) Display usage information.
-diagnose
(Help option) Print out ClassAd query without performing the query.
-absent
(Query option) Query for and display only absent resources.
-ads filename
(Query option) Read the set of ClassAds in the file specified by filename,
instead of querying the condor_collector.
-annex name
(Query option) Query for and display only resources in the named annex.
-any (Query option) Query all ClassAds and display their type, target type, and name.
-avail (Query option) Query condor_startd ClassAds and identify resources which are
available.
-claimed
(Query option) Query condor_startd ClassAds and print information about claimed
resources.
-cod (Query option) Display only machine ClassAds that have COD claims. Information
displayed includes the claim ID, the owner of the claim, and the state of the
COD claim.
-collector
(Query option) Query condor_collector ClassAds and display attributes.
-defrag
(Query option) Query condor_defrag ClassAds.
-direct hostname
(Query option) Go directly to the given host name to get the ClassAds to
display. By default, returns the condor_startd ClassAd. If -schedd is also
given, return the condor_schedd ClassAd on that host.
-grid (Query option) Query grid resource ClassAds.
-java (Query option) Display only Java-capable resources.
-license
(Query option) Display license attributes.
-master
(Query option) Query condor_master ClassAds and display daemon master
attributes.
-negotiator
(Query option) Query condor_negotiator ClassAds and display attributes.
-pool centralmanagerhostname[:portnumber]
(Query option) Query the specified central manager using an optional port
number. condor_status queries the machine specified by the configuration
variable COLLECTOR_HOST by default.
-run (Query option) Display information about machines currently running jobs.
-schedd
(Query option) Query condor_schedd ClassAds and display attributes.
-server
(Query option) Query condor_startd ClassAds and display resource attributes.
-startd
(Query option) Query condor_startd ClassAds.
-state (Query option) Query condor_startd ClassAds and display resource state
information.
-statistics WhichStatistics
(Query option) Can only be used if the -direct option has been specified.
Identifies which Statistics attributes to include in the ClassAd.
WhichStatistics is specified using the same syntax as defined for
STATISTICS_TO_PUBLISH. A definition is in the HTCondor Administrator's manual
section on configuration (admin-manual/configuration-macros:htcondor-wide
configuration file entries).
-storage
(Query option) Display attributes of machines with network storage resources.
-submitters
(Query option) Query ClassAds sent by submitters and display important submitter
attributes.
-subsystem type
(Query option) If type is one of collector, negotiator, master, schedd, or
startd, then behavior is the same as the query option without the -subsystem
option. For example, -subsystem collector is the same as -collector. A value of
type of CkptServer, Machine, DaemonMaster, or Scheduler targets that type of
ClassAd.
-vm (Query option) Query condor_startd ClassAds, and display only VM-enabled
machines. Information displayed includes the machine name, the virtual machine
software version, the state of machine, the virtual machine memory, and the type
of networking.
-offline
(Query option) Query condor_startd ClassAds, and display, for each machine with
at least one offline universe, which universes are offline for it.
-attributes Attr1[,Attr2 ...]
(Display option) Explicitly list the attributes in a comma separated list which
should be displayed when using the -xml, -json or -long options. Limiting the
number of attributes increases the efficiency of the query.
-expert
(Display option) Display shortened error messages.
-long (Display option) Display entire ClassAds. Implies that totals will not be
displayed.
-limit num
(Query option) At most num results should be displayed.
-sort expr
(Display option) Change the display order to be based on ascending values of an
evaluated expression given by expr. Evaluated expressions of a string type are
in a case insensitive alphabetical order. If multiple -sort arguments appear on
the command line, the primary sort will be on the leftmost one within the
command line, and it is numbered 0. A secondary sort will be based on the second
expression, and it is numbered 1. For informational or debugging purposes, the
ClassAd output to be displayed will appear as if the ClassAd had two additional
attributes. CondorStatusSortKeyExpr<N> is the expression, where <N> is replaced
by the number of the sort. CondorStatusSortKey<N> gives the result of evaluating
the sort expression that is numbered <N>.
-total (Display option) Display totals only.
-xml (Display option) Display entire ClassAds, in XML format. The XML format is fully
defined in the reference manual, obtained from the ClassAds web page, with a
link at http://htcondor.org/classad/classad.html.
-json (Display option) Display entire ClassAds in JSON format.
-constraint const
(Custom option) Add constraint expression.
-compact
(Custom option) Show compact form, with a single line per machine using
information from the partitionable slot. Some information will be incorrect if
the machine has static slots.
-format fmt attr
(Custom option) Display attribute or expression attr in format fmt. To display
the attribute or expression the format must contain a single printf(3)-style
conversion specifier. Attributes must be from the resource ClassAd. Expressions
are ClassAd expressions and may refer to attributes in the resource ClassAd. If
the attribute is not present in a given ClassAd and cannot be parsed as an
expression, then the format option will be silently skipped. %r prints the
unevaluated, or raw values. The conversion specifier must match the type of the
attribute or expression. %s is suitable for strings such as Name, %d for
integers such as LastHeardFrom, and %f for floating point numbers such as
LoadAvg. %v identifies the type of the attribute, and then prints the value in
an appropriate format. %V identifies the type of the attribute, and then prints
the value in an appropriate format as it would appear in the -long format. As an
example, strings used with %V will have quote marks. An incorrect format will
result in undefined behavior. Do not use more than one conversion specifier in a
given format. More than one conversion specifier will result in undefined
behavior. To output multiple attributes repeat the -format option once for each
desired attribute. Like printf(3)-style formats, one may include other text that
will be reproduced directly. A format without any conversion specifiers may be
specified, but an attribute is still required. Include a backslash followed by
an 'n' to specify a line break.
-autoformat[:lhVr,tng] attr1 [attr2 ...] or -af[:lhVr,tng] attr1 [attr2 ...]
(Output option) Display attribute(s) or expression(s) formatted in a default way
according to attribute types. This option takes an arbitrary number of attribute
names as arguments, and prints out their values, with a space between each value
and a newline character after the last value. It is like the -format option
without format strings. This output option does not work in conjunction with the
-run option.
It is assumed that no attribute names begin with a dash character, so that the
next word that begins with dash is the start of the next option. The autoformat
option may be followed by a colon character and formatting qualifiers to deviate
the output formatting from the default:
l label each field,
h print column headings before the first line of output,
V use %V rather than %v for formatting (string values are quoted),
r print "raw", or unevaluated values,
, add a comma character after each field,
t add a tab character before each field instead of the default space character,
n add a newline character after each field,
g add a newline character between ClassAds, and suppress spaces before each
field.
Use -af:h to get tabular values with headings.
Use -af:lrng to get -long equivalent format.
The newline and comma characters may not be used together. The l and h
characters may not be used together.
-print-format file
Read output formatting information from the given custom print format file. see
Print Formats for more information about custom print format files.
-target filename
(Custom option) Where evaluation requires a target ClassAd to evaluate against,
file filename contains the target ClassAd.
-merge filename
(Custom option) Ads will be read from filename, which may be - to indicate
standard in, and compared to the ads selected by the query specified by the
remainder of the command line. Ads will be considered the same if their sort
keys match; sort keys may be specified with [-sort <key>]. This option will
cause up to three tables to print, in the following order, depending on where a
given ad appeared: first, the ads which appeared in the query but not in
filename; second, the ads which appeared in both the query and in filename;
third, the ads which appeared in filename but not in the query.
By default, banners will label each table. If -xml is also given, the same
banners will separate three valid XML documents, one for each table. If -json is
also given, a single JSON object will be produced, with the usual JSON output
for each table labeled as an element in the object.
The -annex option changes this default so that the banners are not printed and
the tables are formatted differently. In this case, the ads in filename are
expected to have different contents from the ads in the query, so many others
will behave strangely.
GENERAL REMARKS
• The default output from condor_status is formatted to be human readable, not script
readable. In an effort to make the output fit within 80 characters, values in some
fields might be truncated. Furthermore, the HTCondor Project can (and does) change the
formatting of this default output as we see fit. Therefore, any script that is
attempting to parse data from condor_status is strongly encouraged to use the -format
option (described above).
• The information obtained from condor_startd and condor_schedd daemons may sometimes
appear to be inconsistent. This is normal since condor_startd and condor_schedd daemons
update the HTCondor manager at different rates, and since there is a delay as
information propagates through the network and the system.
• Note that the ActivityTime in the Idle state is not the amount of time that the machine
has been idle. See the section on condor_startd states in the Administrator's Manual for
more information (Starting Up, Shutting Down and Reconfiguring the System).
• When using condor_status on a pool with SMP machines, you can either provide the host
name, in which case you will get back information about all slots that are represented
on that host, or you can list specific slots by name. See the examples below for
details.
• If you specify host names, without domains, HTCondor will automatically try to resolve
those host names into fully qualified host names for you. This also works when
specifying specific nodes of an SMP machine. In this case, everything after the "@" sign
is treated as a host name and that is what is resolved.
• You can use the -direct option in conjunction with almost any other set of options.
However, at this time, not all daemons will respond to direct queries for its ad(s). The
condor_startd will respond to requests for Startd ads. The condor_schedd will respond to
requests for Schedd and Submitter ads. So the only options currently not supported with
-direct are -master and -collector. Most other options use startd ads for their
information, so they work seamlessly with -direct. The only other restriction on -direct
is that you may only use 1 -direct option at a time. If you want to query information
directly from multiple hosts, you must run condor_status multiple times.
• Unless you use the local host name with -direct, condor_status will still have to
contact a collector to find the address where the specified daemon is listening. So,
using a -pool option in conjunction with -direct just tells condor_status which
collector to query to find the address of the daemon you want. The information actually
displayed will still be retrieved directly from the daemon you specified as the argument
to -direct. Do not use -direct to query the Collector ad, just use -pool and
-collector.
EXAMPLES
Example 1 To view information from all nodes of an SMP machine, use only the host name.
For example, if you had a 4-CPU machine, named vulture.cs.wisc.edu, you might see
$ condor_status vulture
Name OpSys Arch State Activity LoadAv Mem ActvtyTime
slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512 0+01:47:42
slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512 0+01:48:19
slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:05:32
slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512 1+11:05:34
Total Owner Claimed Unclaimed Matched Preempting Backfill
INTEL/LINUX 4 0 2 2 0 0 0
Total 4 0 2 2 0 0 0
Example 2 To view information from a specific nodes of an SMP machine, specify the node
directly. You do this by providing the name of the slot. This has the form slot#@hostname.
For example:
$ condor_status slot3@vulture
Name OpSys Arch State Activity LoadAv Mem ActvtyTime
slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:10:32
Total Owner Claimed Unclaimed Matched Preempting Backfill
INTEL/LINUX 1 0 0 1 0 0 0
Total 1 0 0 1 0 0 0
Example 3 The -compact option gives a one line summary of each machine using information
from the partitionable slot. If the normal output is this
$ condor_status vulture
Name OpSys Arch State Activity LoadAv Mem ActvtyTime
slot1@vulture.cs.w LINUX X86_64 Unclaimed Idle 0.000 679 1+03:18:58
slot1_1@vulture.cs LINUX X86_64 Claimed Busy 1.160 1152 0+03:21:02
slot1_2@vulture.cs LINUX X86_64 Claimed Busy 1.150 2560 0+10:20:50
slot1_3@vulture.cs LINUX X86_64 Claimed Busy 1.160 2816 0+01:32:08
slot1_4@vulture.cs LINUX X86_64 Claimed Busy 0.000 5081 0+00:00:00
Machines Owner Claimed Unclaimed Matched Preempting Drain
X86_64/LINUX 5 0 4 1 0 0 0
Total 5 0 4 1 0 0 0
For the same machine in the same state the -compact option will show this
$ condor_status -compact vulture
Machine Platform Slots Cpus Gpus TotalGb FreCpu FreeGb CpuLoad ST Jobs/Min MaxSlotGb
vulture.cs.wisc.ed x64/CentOS7 4 8 2 12 0 .66 .98 Cb .25 4.96
Machines Owner Claimed Unclaimed Matched Preempting Drain
X86_64/CentOS7 4 0 4 1 0 0 0
Total 4 0 4 1 0 0 0
The Slots column shows that 4 slots have been carved out of the partitionable slot,
leaving 0 cpus and .66 Gigabytes of memory free. Static slots will not be counted in the
Slots column.
The ST column shows the consensus state of the dynamic slots using a two character code.
The first character is the State, the second is the activity. If there is not a consensus
for either the state or activity, then # will be shown. The example shows Cb for
Claimed/Busy since all of the dynamic slots are in that state. If one of the dynamic
slots were Idle, then C# would be shown.
The Jobs/Min shows the recent job start rate for the machine. A large number here is
normal for a machine that just came online, but if this number stays above 1 for more than
a minute, that can be an indication of a machine is acting as a black hole for jobs,
starting them quickly and then failing them just as quickly.
The MaxSlotGb column shows the memory allocated to the largest slot in Gigabytes, If the
memory allocated for the largest slot cannot be determined, * will be displayed. Static
slots are not counted in the MaxSlotGb column.
Constraint option examples
The Unix command to use the constraint option to see all machines with the OpSys of
"LINUX":
$ condor_status -constraint OpSys==\"LINUX\"
Note that quotation marks must be escaped with the backslash characters for most shells.
The Windows command to do the same thing:
> condor_status -constraint " OpSys==""LINUX"" "
Note that quotation marks are used to delimit the single argument which is the expression,
and the quotation marks that identify the string must be escaped by using a set of two
double quote marks without any intervening spaces.
To see all machines that are currently in the Idle state, the Unix command is
$ condor_status -constraint State==\"Idle\"
To see all machines that are bench marked to have a MIPS rating of more than 750, the Unix
command is
$ condor_status -constraint 'Mips>750'
-cod option example
The -cod option displays the status of COD claims within a given HTCondor pool.
Name ID ClaimState TimeInState RemoteUser JobId Keyword
astro.cs.wi COD1 Idle 0+00:00:04 wright
chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
Total Idle Running Suspended Vacating Killing
INTEL/LINUX 3 1 1 1 0 0
Total 3 1 1 1 0 0
-format option example To display the name and memory attributes of each job ClassAd in a
format that is easily parsable by other tools:
$ condor_status -format "%s " Name -format "%d\n" Memory
To do the same with the autoformat option, run
$ condor_status -autoformat Name Memory
EXIT STATUS
condor_status will exit with a status value of 0 (zero) upon success, and it will exit
with the value 1 (one) upon failure.
AUTHOR
HTCondor Team
COPYRIGHT
1990-2024, Center for High Throughput Computing, Computer Sciences Department, University
of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.
Apr 14, 2024 CONDOR_STATUS(1)