1condor_stats(1)             General Commands Manual            condor_stats(1)
2
3
4

Name

6       condor_statsDisplay historical information about the HTCondor pool
7

Synopsis

9       condor_stats[-f   filename]   [-orgformat]  [-pool  centralmanagerhost‐
10       name[:portnumber]] [time-range] query-type
11

Description

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
27       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
34       Note that logging of pool history must be enabled in the condor_collec‐
35       tordaemon, otherwise no information will be available.
36
37       One query type is required. If multiple queries are specified, only the
38       last one takes effect.
39

Time Range Options

41       -lastday
42
43          Get information for the last day.
44
45
46
47       -lastweek
48
49          Get information for the last week.
50
51
52
53       -lastmonth
54
55          Get information for the last month.
56
57
58
59       -lasthours n
60
61          Get information for the n last hours.
62
63
64
65       -from m d y
66
67          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
71
72
73       -to m d y
74
75          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
79
80

Query Type Arguments

82       The  query  types  that  do  not list all of a category require further
83       specification as given by an argument.
84
85       -resourcequery hostname
86
87          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
91
92
93
94
95       -resourcelist
96
97          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
101
102
103
104
105       -resgroupquery arch/opsys | “Total”
106
107          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
113          The columns displayed are the number of machines that are unclaimed,
114          matched, claimed, preempting, owner, shutdown, delete, backfill, and
115          drained state.
116
117
118
119
120
121       -resgrouplist
122
123          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
126
127
128
129
130       -userquery email_address/submit_machine
131
132          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
136           -userquery jondoe@sample.com/onemachine.sample.com
137
138
139
140
141
142       -userlist
143
144          Queries  for the list of all submitters for which the condor_collec‐
145          tordaemon has historic information within the query's time range.
146
147
148
149
150
151       -usergroupquery email_address | “Total”
152
153          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
158
159
160
161
162       -usergrouplist
163
164          Queries  for the list of all users for which the condor_collectorhas
165          historic information within the query's time range.
166
167
168
169
170
171       -ckptquery hostname
172
173          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
178
179
180
181
182       -ckptlist
183
184          Query  for  the entire list of checkpoint servers for which the con‐
185          dor_collectorhas historic information in the query's time range.
186
187
188

Options

190       -f filename
191
192          Write the information to a file instead of the standard output.
193
194
195
196       -pool centralmanagerhostname[:portnumber]
197
198          Contact the specified central manager instead of the local one.
199
200
201
202       -orgformat
203
204          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
209
210

Exit Status

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

Author

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
223
224
225                                     date                      condor_stats(1)
Impressum