1condor_top(1) General Commands Manual condor_top(1)
2
6 condor_topDisplay status and runtime statistics of a HTCondor daemon
7
9 condor_top[-h]
10 condor_top[-l] [-p centralmanagerhostname[:portname]] [-n name] [-d
12 delay] [-c columnset] [-s sortcolumn] [ -- attrs=<attr1,attr2,...>]
13 [daemon options]
14 condor_top[-c columnset] [-s sortcolumn] [ -- attrs=<attr1,attr2,...>]
16 [classad-filename classad-filename]
17
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 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 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 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 condor_topcan run in a top-like “live” 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 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 con‐
49 sidered when passing ClassAds via files.
50 The following subprocess stat columns may be displayed (*default):
52 Item
54 *Name of the subprocess
56 InstRt
60 *Total runtime between the two ClassAds
62 InstAvg
66 *Mean runtime per execution between the two ClassAds
68 TotalRt
72 Total runtime since daemon start
74 TotAvg
78 *Mean runtime per execution since daemon start
80 TotMax
84 *Max runtime per execution since daemon start
86 TotMin
90 Min runtime per execution since daemon start
92 RtPctAvg
96 *Percent of mean runtime per execution. The ratio of InstAvg to
98 TotAvg, expressed as a percentage
99 RtPctMax
103 Percent of max runtime per execution. The ratio of (InstAvg - Tot‐
105 Min) to (TotMax - TotMin), expressed as a percentage
106 RtSigmas
110 Standard deviations from mean runtime. The ratio of (InstAvg -
112 TotAvg) to the standard deviation in runtime per execution since
113 daemon start
114 InstCt
118 Executions between the two ClassAds
120 InstRate
124 *Executions per second between the two ClassAds
126 TotalCt
130 Total executions (counts) since daemon start
132 AvgRate
136 *Mean count rate. Executions per second since daemon start
138 CtPctAvg
142 Percent of mean count rate. The ratio of InstRate to AvgRate,
144 expressed as a percentage.
145
149 -h
150 Displays the list of options.
152 -l
156 Puts condor_topin to a live, continually updating mode.
158 -p centralmanagerhostname[:portname]
162 Query the daemon via the specified central manager. If omitted, the
164 value of the configuration variable COLLECTOR_HOSTis used.
165 -n name
169 Query the daemon named name. If omitted, the value used will depend
171 on the type of daemon queried (see Daemon Options).
172 -d delay
176 Specifies the delaybetween ClassAd updates, in integer seconds. If
178 omitted, the value of the configuration variable STATISTICS_WIN‐
179 DOW_QUANTUMis used.
180 -c columnset
184 Display columnsetset of columns. Valid columnsets are: default, run‐
186 time, count, all.
187 -s sortcolumn
191 Sort table by sortcolumn. Defaults to InstRt.
193 —attrs=<attr1,attr2,...>
197 Comma-delimited list of additional ClassAd attributes to monitor.
199 Daemon Options
201 —collector
205 Monitor condor_collectorClassAds. If -n is not set, the constraint
207 “Machine == COLLECTOR_HOST” will be used.
208 —negotiator
212 Monitor condor_negotiatorClassAds. If -n is not set, the constraint
214 “Machine == COLLECTOR_HOST” will be used.
215 —master
219 Monitor condor_masterClassAds. If -n is not set, the constraint
221 “Machine == COLLECTOR_HOST” will be used.
222 —schedd
226 Monitor condor_scheddClassAds. If -n is not set, the constraint
228 “Machine == FULL_HOSTNAME” will be tried, otherwise the
229 first condor_scheddClassAd returned from the condor_collectorwill be
230 used.
231 —startd
235 Monitor condor_startdClassAds. If -n is not set, the constraint
237 “Machine == FULL_HOSTNAME” will be tried, otherwise the
238 first condor_startdClassAd returned from the condor_collectorwill be
239 used.
240
246 Center for High Throughput Computing, University of Wiscon‐
247 sin–Madison
248
250 Copyright © 1990-2019 Center for High Throughput Computing, Computer
251 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
252 Rights Reserved. Licensed under the Apache License, Version 2.0.
253 date condor_top(1)