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

Name

6       condor_topDisplay status and runtime statistics of a HTCondor daemon
7

Synopsis

9       condor_top[-h]
10
11       condor_top[-l]  [-p  centralmanagerhostname[:portname]]  [-n  name] [-d
12       delay] [-c columnset] [-s  sortcolumn]  [  --  attrs=<attr1,attr2,...>]
13       [daemon options]
14
15       condor_top[-c  columnset] [-s sortcolumn] [ -- attrs=<attr1,attr2,...>]
16       [classad-filename classad-filename]
17

Description

19       condor_topdisplays the status (e.g. memory usage and duty cycle)  of  a
20       HTCondor  daemon and calculates and displays runtime statistics for the
21       daemon's subprocesses.
22
23       When no arguments are specified, condor_topdisplays the status for  the
24       primary daemon based on the role of the current machine by scanning the
25       DAEMON_LISTconfiguration setting. If multiple daemons are listed,  con‐
26       dor_topwill  monitor  one  of  (in decreasing priority): condor_schedd,
27       condor_startd, condor_collector, condor_negotiator, condor_master.
28
29       If the condor_collectorreturns multiple ClassAds for the chosen  daemon
30       type,  condor_topwill  display  stats  from the first ClassAd returned.
31       Results can be constrained by passing the NAMEof a specific daemon with
32       -n.
33
34       The  default delayis STATISTICS_WINDOW_QUANTUM, which is 4 minutes (240
35       seconds) in a default HTCondor configuration. Setting the delay smaller
36       can  be  helpful  for finding spikes of activity, but setting the delay
37       too small will lead to poor measurements of the duty cycle and  of  the
38       runtime statistics.
39
40       condor_topcan  run in a top-like &ldquo;live&rdquo; mode by passing -l.
41       The live mode is similar to the *nix top command, with  stats  updating
42       every  delayseconds.  Redirecting stdout will disable live mode even if
43       -lis set. To exit condor_topwhile in live mode, issue Ctrl-C.
44
45       condor_topcan be passed two files containing  ClassAds  from  the  same
46       HTCondor  daemon, in which case the condor_collectorwill not be queried
47       but rather the statistics will be computed  and  displayed  immediately
48       from  the  two ClassAds. Only -c, -s, and -attrs options are considered
49       when passing ClassAds via files.
50
51       The following subprocess stat columns may be displayed (*default):
52
53       Item
54
55          *Name of the subprocess
56
57
58
59       InstRt
60
61          *Total runtime between the two ClassAds
62
63
64
65       InstAvg
66
67          *Mean runtime per execution between the two ClassAds
68
69
70
71       TotalRt
72
73          Total runtime since daemon start
74
75
76
77       TotAvg
78
79          *Mean runtime per execution since daemon start
80
81
82
83       TotMax
84
85          *Max runtime per execution since daemon start
86
87
88
89       TotMin
90
91          Min runtime per execution since daemon start
92
93
94
95       RtPctAvg
96
97          *Percent of mean runtime per execution.  The  ratio  of  InstAvg  to
98          TotAvg, expressed as a percentage
99
100
101
102       RtPctMax
103
104          Percent  of  max runtime per execution. The ratio of (InstAvg - Tot‐
105          Min) to (TotMax - TotMin), expressed as a percentage
106
107
108
109       RtSigmas
110
111          Standard deviations from mean  runtime.  The  ratio  of  (InstAvg  -
112          TotAvg)  to  the  standard  deviation in runtime per execution since
113          daemon start
114
115
116
117       InstCt
118
119          Executions between the two ClassAds
120
121
122
123       InstRate
124
125          *Executions per second between the two ClassAds
126
127
128
129       TotalCt
130
131          Total executions (counts) since daemon start
132
133
134
135       AvgRate
136
137          *Mean count rate. Executions per second since daemon start
138
139
140
141       CtPctAvg
142
143          Percent of mean count  rate.  The  ratio  of  InstRate  to  AvgRate,
144          expressed as a percentage.
145
146
147

Options

149       -h
150
151          Displays the list of options.
152
153
154
155       -l
156
157          Puts condor_topin to a live, continually updating mode.
158
159
160
161       -p centralmanagerhostname[:portname]
162
163          Query  the daemon via the specified central manager. If omitted, the
164          value of the configuration variable COLLECTOR_HOSTis used.
165
166
167
168       -n name
169
170          Query the daemon named name. If omitted, the value used will  depend
171          on the type of daemon queried (see Daemon Options).
172
173
174
175       -d delay
176
177          Specifies  the  delaybetween ClassAd updates, in integer seconds. If
178          omitted, the value of  the  configuration  variable  STATISTICS_WIN‐
179          DOW_QUANTUMis used.
180
181
182
183       -c columnset
184
185          Display columnsetset of columns. Valid columnsets are: default, run‐
186          time, count, all.
187
188
189
190       -s sortcolumn
191
192          Sort table by sortcolumn. Defaults to InstRt.
193
194
195
196       --attrs=<attr1,attr2,...>
197
198          Comma-delimited list of additional ClassAd attributes to monitor.
199
200          Daemon Options
201
202
203
204       --collector
205
206          Monitor condor_collectorClassAds. If -n is not set,  the  constraint
207          &ldquo;Machine == COLLECTOR_HOST&rdquo; will be used.
208
209
210
211       --negotiator
212
213          Monitor  condor_negotiatorClassAds. If -n is not set, the constraint
214          &ldquo;Machine == COLLECTOR_HOST&rdquo; will be used.
215
216
217
218       --master
219
220          Monitor condor_masterClassAds. If -n  is  not  set,  the  constraint
221          &ldquo;Machine == COLLECTOR_HOST&rdquo; will be used.
222
223
224
225       --schedd
226
227          Monitor  condor_scheddClassAds.  If  -n  is  not set, the constraint
228          &ldquo;Machine == FULL_HOSTNAME&rdquo; will be tried, otherwise  the
229          first condor_scheddClassAd returned from the condor_collectorwill be
230          used.
231
232
233
234       --startd
235
236          Monitor condor_startdClassAds. If -n  is  not  set,  the  constraint
237          &ldquo;Machine  == FULL_HOSTNAME&rdquo; will be tried, otherwise the
238          first condor_startdClassAd returned from the condor_collectorwill be
239          used.
240
241
242
243
244

Author

246       Center for High Throughput Computing, University of Wisconsin-Madison
247
249       Copyright  (C) 1990-2019 Center for High Throughput Computing, Computer
250       Sciences Department, University of Wisconsin-Madison, Madison, WI.  All
251       Rights Reserved. Licensed under the Apache License, Version 2.0.
252
253
254
255                                     date                        condor_top(1)
Impressum