NAME

       condor_stats - HTCondor Manual

       Display historical information about the HTCondor pool

SYNOPSIS

       condor_stats  [-f  filename]  [-orgformat  ]  [-pool  centralmanagerhostname[:portnumber]]
       [time-range ] query-type

DESCRIPTION

       condor_stats displays historic information about an HTCondor pool.  Based on the  type  of
       information requested, a query is sent to the condor_collector daemon, and the information
       received is displayed using the standard output. If the -f option is used, the information
       will  be  written to a file instead of to standard output. The -pool option can be used to
       get information  from  other  pools,  instead  of  from  the  local  (default)  pool.  The
       condor_stats tool is used to query resource information (single or by platform), submitter
       and user information. If a time  range  is  not  specified,  the  default  query  provides
       information  for  the previous 24 hours. Otherwise, information can be retrieved for other
       time ranges such as the last specified number of  hours,  last  week,  last  month,  or  a
       specified date range.

       The  information  is  displayed  in  columns  separated  by  tabs. The first column always
       represents the time, as a percentage of the range of the query. Thus the first entry  will
       have a value close to 0.0, while the last will be close to 100.0. If the -orgformat option
       is used, the time is displayed as number of seconds since the Unix epoch. The  information
       in the remainder of the columns depends on the query type.

       Note  that  logging  of  pool  history  must  be  enabled  in the condor_collector daemon,
       otherwise no information will be available.

       One query type is required. If multiple queries are specified, only  the  last  one  takes
       effect.

TIME RANGE OPTIONS

          -lastday
                 Get information for the last day.

          -lastweek
                 Get information for the last week.

          -lastmonth
                 Get information for the last month.

          -lasthours n
                 Get information for the n last hours.

          -from m d y
                 Get  information for the time since the beginning of the specified date. A start
                 date prior to the Unix epoch causes condor_stats to print its usage  information
                 and quit.

          -to m d y
                 Get  information for the time up to the beginning of the specified date, instead
                 of up to now. A finish date in the future causes condor_stats to print its usage
                 information and quit.

QUERY TYPE ARGUMENTS

       The  query types that do not list all of a category require further specification as given
       by an argument.

          -resourcequery hostname
                 A single resource query  provides  information  about  a  single  machine.   The
                 information also includes the keyboard idle time (in seconds), the load average,
                 and the machine state.

          -resourcelist
                 A query of a single list of resources to provide a list of all the machines  for
                 which  the  condor_collector  daemon has historic information within the query's
                 time range.

          -resgroupquery arch/opsys | "Total"
                 A query of a specified group to provide information about a  group  of  machines
                 based on their platform (operating system and architecture). The architecture is
                 defined by the machine ClassAd Arch, and the operating system is defined by  the
                 machine  ClassAd  OpSys.  The  string  "Total"  ask  for  information  about all
                 platforms.

                 The columns displayed are the number of machines that  are  unclaimed,  matched,
                 claimed, preempting, owner, shutdown, delete, backfill, and drained state.

          -resgrouplist
                 Queries  for  a  list  of all the group names for which the condor_collector has
                 historic information within the query's time range.

          -userquery email_address/submit_machine
                 Query for a specific submitter on a specific machine. The information  displayed
                 includes  the  number  of  running  jobs and the number of idle jobs. An example
                 argument appears as

                     -userquery jondoe@sample.com/onemachine.sample.com

          -userlist
                 Queries for the list of all submitters for which the condor_collector daemon has
                 historic information within the query's time range.

          -usergroupquery email_address | "Total"
                 Query  for  all  jobs  submitted by the specific user, regardless of the machine
                 they were submitted from, or all jobs. The information  displayed  includes  the
                 number of running jobs and the number of idle jobs.

          -usergrouplist
                 Queries  for  the  list of all users for which the condor_collector has historic
                 information within the query's time range.

OPTIONS

          -f filename
                 Write the information to a file instead of the standard output.

          -pool centralmanagerhostname[:portnumber]
                 Contact the specified central manager instead of the local one.

          -orgformat
                 Display the information in  an  alternate  format  for  timing,  which  presents
                 timestamps  since  the  Unix  epoch.  This  argument only affects the display of
                 resoursequery, resgroupquery, userquery, and usergroupquery.

EXIT STATUS

       condor_stats will exit with a status value of 0 (zero) upon success, and it will exit with
       the value 1 (one) upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024,  Center for High Throughput Computing, Computer Sciences Department, University
       of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                           Apr 14, 2024                           CONDOR_STATS(1)