1CONDOR_TOP(1)                   HTCondor Manual                  CONDOR_TOP(1)
2
3
4

NAME

6       condor_top - HTCondor Manual
7
8       Display status and runtime statistics of a HTCondor daemon
9
10
11

SYNOPSIS

13       condor_top [-h ]
14
15       condor_top  [-l  ] [-p centralmanagerhostname[:portname]] [-n name] [-d
16       delay] [-c columnset] [-s sortcolumn] [--attrs=<attr1,attr2,...>] [dae‐
17       mon options ]
18
19       condor_top  [-c  columnset] [-s sortcolumn] [--attrs=<attr1,attr2,...>]
20       [classad-filename classad-filename ]
21

DESCRIPTION

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
27       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
33       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
38       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
44       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
49       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
55       The following subprocess stat columns may be displayed (*default):
56
57          Item   *Name of the subprocess
58
59          InstRt *Total runtime between the two ClassAds
60
61          InstAvg
62                 *Mean runtime per execution between the two ClassAds
63
64          TotalRt
65                 Total runtime since daemon start
66
67          TotAvg *Mean runtime per execution since daemon start
68
69          TotMax *Max runtime per execution since daemon start
70
71          TotMin Min runtime per execution since daemon start
72
73          RtPctAvg
74                 *Percent of mean runtime per execution. The ratio of  InstAvg
75                 to TotAvg, expressed as a percentage
76
77          RtPctMax
78                 Percent of max runtime per execution. The ratio of (InstAvg -
79                 TotMin) to (TotMax - TotMin), expressed as a percentage
80
81          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
86          InstCt Executions between the two ClassAds
87
88          InstRate
89                 *Executions per second between the two ClassAds
90
91          TotalCt
92                 Total executions (counts) since daemon start
93
94          AvgRate
95                 *Mean count rate. Executions per second since daemon start
96
97          CtPctAvg
98                 Percent of mean count rate. The ratio of InstRate to AvgRate,
99                 expressed as a percentage.
100

OPTIONS

102          -h     Displays the list of options.
103
104          -l     Puts condor_top in to a live, continually updating mode.
105
106          -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
111          -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
115          -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
120          -c columnset
121                 Display columnset set of columns. Valid columnset s are:  de‐
122                 fault, runtime, count, all.
123
124          -s sortcolumn
125                 Sort table by sortcolumn. Defaults to InstRt.
126
127          -attrs=<attr1,attr2,...>
128                 Comma-delimited list of additional ClassAd attributes to monitor.
129
130
131                 Daemon Options
132
133          -collector
134                 Monitor condor_collector ClassAds. If -n is not set, the con‐
135                 straint "Machine == COLLECTOR_HOST" will be used.
136
137          -negotiator
138                 Monitor condor_negotiator ClassAds. If -n  is  not  set,  the
139                 constraint "Machine == COLLECTOR_HOST" will be used.
140
141          -master
142                 Monitor  condor_master  ClassAds.  If -n is not set, the con‐
143                 straint "Machine == COLLECTOR_HOST" will be used.
144
145          -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
151          -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

AUTHOR

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
165
166
167
168                                 Oct 02, 2023                    CONDOR_TOP(1)
Impressum