1CONDOR_TOP(1) HTCondor Manual CONDOR_TOP(1)
2
6 condor_top - HTCondor Manual
7 Display status and runtime statistics of a HTCondor daemon
9
13 condor_top [-h ]
14 condor_top [-l ] [-p centralmanagerhostname[:portname]] [-n name] [-d
16 delay] [-c columnset] [-s sortcolumn] [--attrs=<attr1,attr2,...>] [dae‐
17 mon options ]
18 condor_top [-c columnset] [-s sortcolumn] [--attrs=<attr1,attr2,...>]
20 [classad-filename classad-filename ]
21
23 condor_top displays the status (e.g. memory usage and duty cycle) of a
24 HTCondor daemon and calculates and displays runtime statistics for the
25 daemon's subprocesses.
26 When no arguments are specified, condor_top displays the status for the
28 primary daemon based on the role of the current machine by scanning the
29 DAEMON_LIST configuration setting. If multiple daemons are listed, con‐
30 dor_top will monitor one of (in decreasing priority): condor_schedd,
31 condor_startd, condor_collector, condor_negotiator, condor_master.
32 If the condor_collector returns multiple ClassAds for the chosen daemon
34 type, condor_top will display stats from the first ClassAd returned.
35 Results can be constrained by passing the NAME of a specific daemon
36 with -n.
37 The default delay is STATISTICS_WINDOW_QUANTUM, which is 4 minutes (240
39 seconds) in a default HTCondor configuration. Setting the delay smaller
40 can be helpful for finding spikes of activity, but setting the delay
41 too small will lead to poor measurements of the duty cycle and of the
42 runtime statistics.
43 condor_top can run in a top-like "live" mode by passing -l. The live
45 mode is similar to the *nix top command, with stats updating every de‐
46 lay seconds. Redirecting stdout will disable live mode even if -l is
47 set. To exit condor_top while in live mode, issue Ctrl-C.
48 condor_top can be passed two files containing ClassAds from the same
50 HTCondor daemon, in which case the condor_collector will not be queried
51 but rather the statistics will be computed and displayed immediately
52 from the two ClassAds. Only -c, -s, and -attrs options are considered
53 when passing ClassAds via files.
54 The following subprocess stat columns may be displayed (*default):
56 Item *Name of the subprocess
58 InstRt *Total runtime between the two ClassAds
60 InstAvg
62 *Mean runtime per execution between the two ClassAds
63 TotalRt
65 Total runtime since daemon start
66 TotAvg *Mean runtime per execution since daemon start
68 TotMax *Max runtime per execution since daemon start
70 TotMin Min runtime per execution since daemon start
72 RtPctAvg
74 *Percent of mean runtime per execution. The ratio of InstAvg
75 to TotAvg, expressed as a percentage
76 RtPctMax
78 Percent of max runtime per execution. The ratio of (InstAvg -
79 TotMin) to (TotMax - TotMin), expressed as a percentage
80 RtSigmas
82 Standard deviations from mean runtime. The ratio of (InstAvg
83 - TotAvg) to the standard deviation in runtime per execution
84 since daemon start
85 InstCt Executions between the two ClassAds
87 InstRate
89 *Executions per second between the two ClassAds
90 TotalCt
92 Total executions (counts) since daemon start
93 AvgRate
95 *Mean count rate. Executions per second since daemon start
96 CtPctAvg
98 Percent of mean count rate. The ratio of InstRate to AvgRate,
99 expressed as a percentage.
100
102 -h Displays the list of options.
103 -l Puts condor_top in to a live, continually updating mode.
105 -p centralmanagerhostname[:portname]
107 Query the daemon via the specified central manager. If omit‐
108 ted, the value of the configuration variable COLLECTOR_HOST
109 is used.
110 -n name
112 Query the daemon named name. If omitted, the value used will
113 depend on the type of daemon queried (see Daemon Options).
114 -d delay
116 Specifies the delay between ClassAd updates, in integer sec‐
117 onds. If omitted, the value of the configuration variable
118 STATISTICS_WINDOW_QUANTUM is used.
119 -c columnset
121 Display columnset set of columns. Valid columnset s are: de‐
122 fault, runtime, count, all.
123 -s sortcolumn
125 Sort table by sortcolumn. Defaults to InstRt.
126 -attrs=<attr1,attr2,...>
128 Comma-delimited list of additional ClassAd attributes to monitor.
129 Daemon Options
132 -collector
134 Monitor condor_collector ClassAds. If -n is not set, the con‐
135 straint "Machine == COLLECTOR_HOST" will be used.
136 -negotiator
138 Monitor condor_negotiator ClassAds. If -n is not set, the
139 constraint "Machine == COLLECTOR_HOST" will be used.
140 -master
142 Monitor condor_master ClassAds. If -n is not set, the con‐
143 straint "Machine == COLLECTOR_HOST" will be used.
144 -schedd
146 Monitor condor_schedd ClassAds. If -n is not set, the con‐
147 straint "Machine == FULL_HOSTNAME" will be tried, otherwise
148 the first condor_schedd ClassAd returned from the condor_col‐
149 lector will be used.
150 -startd
152 Monitor condor_startd ClassAds. If -n is not set, the con‐
153 straint "Machine == FULL_HOSTNAME" will be tried, otherwise
154 the first condor_startd ClassAd returned from the condor_col‐
155 lector will be used.
156
158 HTCondor Team
159
161 1990-2023, Center for High Throughput Computing, Computer Sciences De‐
162 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
163 under the Apache License, Version 2.0.
164 Oct 02, 2023 CONDOR_TOP(1)