1condor_stats(1) General Commands Manual condor_stats(1)
2
6 condor_statsDisplay historical information about the HTCondor pool
7
9 condor_stats[-f filename] [-orgformat] [-pool centralmanagerhost‐
10 name[:portnumber]] [time-range] query-type
11
13 condor_statsdisplays historic information about an HTCondor pool. Based
14 on the type of information requested, a query is sent to the con‐
15 dor_collectordaemon, and the information received is displayed using
16 the standard output. If the -foption is used, the information will be
17 written to a file instead of to standard output. The -pooloption can be
18 used to get information from other pools, instead of from the local
19 (default) pool. The condor_statstool is used to query resource informa‐
20 tion (single or by platform), submitter and user information, and
21 checkpoint server information. If a time range is not specified, the
22 default query provides information for the previous 24 hours. Other‐
23 wise, information can be retrieved for other time ranges such as the
24 last specified number of hours, last week, last month, or a specified
25 date range.
26 The information is displayed in columns separated by tabs. The first
28 column always represents the time, as a percentage of the range of the
29 query. Thus the first entry will have a value close to 0.0, while the
30 last will be close to 100.0. If the -orgformatoption is used, the time
31 is displayed as number of seconds since the Unix epoch. The information
32 in the remainder of the columns depends on the query type.
33 Note that logging of pool history must be enabled in the condor_collec‐
35 tordaemon, otherwise no information will be available.
36 One query type is required. If multiple queries are specified, only the
38 last one takes effect.
39
41 -lastday
42 Get information for the last day.
44 -lastweek
48 Get information for the last week.
50 -lastmonth
54 Get information for the last month.
56 -lasthours n
60 Get information for the n last hours.
62 -from m d y
66 Get information for the time since the beginning of the specified
68 date. A start date prior to the Unix epoch causes condor_statsto
69 print its usage information and quit.
70 -to m d y
74 Get information for the time up to the beginning of the specified
76 date, instead of up to now. A finish date in the future causes con‐
77 dor_statsto print its usage information and quit.
78
82 The query types that do not list all of a category require further
83 specification as given by an argument.
84 -resourcequery hostname
86 A single resource query provides information about a single machine.
88 The information also includes the keyboard idle time (in seconds),
89 the load average, and the machine state.
90 -resourcelist
96 A query of a single list of resources to provide a list of all the
98 machines for which the condor_collectordaemon has historic informa‐
99 tion within the query's time range.
100 -resgroupquery arch/opsys | “Total”
106 A query of a specified group to provide information about a group of
108 machines based on their platform (operating system and architec‐
109 ture). The architecture is defined by the machine ClassAd Arch, and
110 the operating system is defined by the machine ClassAd OpSys. The
111 string “Total” ask for information about all platforms.
112 The columns displayed are the number of machines that are unclaimed,
114 matched, claimed, preempting, owner, shutdown, delete, backfill, and
115 drained state.
116 -resgrouplist
122 Queries for a list of all the group names for which the condor_col‐
124 lectorhas historic information within the query's time range.
125 -userquery email_address/submit_machine
131 Query for a specific submitter on a specific machine. The informa‐
133 tion displayed includes the number of running jobs and the number of
134 idle jobs. An example argument appears as
135 -userquery jondoe@sample.com/onemachine.sample.com
137 -userlist
143 Queries for the list of all submitters for which the condor_collec‐
145 tordaemon has historic information within the query's time range.
146 -usergroupquery email_address | “Total”
152 Query for all jobs submitted by the specific user, regardless of the
154 machine they were submitted from, or all jobs. The information dis‐
155 played includes the number of running jobs and the number of idle
156 jobs.
157 -usergrouplist
163 Queries for the list of all users for which the condor_collectorhas
165 historic information within the query's time range.
166 -ckptquery hostname
172 Query about a checkpoint server given its host name. The information
174 displayed includes the number of MiB received, MiB sent, average
175 receive bandwidth (in KiB/sec), and average send bandwidth (in
176 KiB/sec).
177 -ckptlist
183 Query for the entire list of checkpoint servers for which the con‐
185 dor_collectorhas historic information in the query's time range.
186
190 -f filename
191 Write the information to a file instead of the standard output.
193 -pool centralmanagerhostname[:portnumber]
197 Contact the specified central manager instead of the local one.
199 -orgformat
203 Display the information in an alternate format for timing, which
205 presents timestamps since the Unix epoch. This argument only affects
206 the display of resoursequery, resgroupquery, userquery, usergroup‐
207 query, and ckptquery.
208
212 condor_statswill exit with a status value of 0 (zero) upon success, and
213 it will exit with the value 1 (one) upon failure.
214
216 Center for High Throughput Computing, University of Wisconsin-Madison
217
219 Copyright (C) 1990-2019 Center for High Throughput Computing, Computer
220 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
221 Rights Reserved. Licensed under the Apache License, Version 2.0.
222 date condor_stats(1)