.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CONDOR_STATS" "1" "Apr 01, 2024" "" "HTCondor Manual"
.SH NAME
condor_stats \- HTCondor Manual
.sp
Display historical information about the HTCondor pool
 
 
.SH SYNOPSIS
.sp
\fBcondor_stats\fP [\fB\-f\fP \fIfilename\fP] [\fB\-orgformat\fP ]
[\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP] [\fBtime\-range\fP ]
\fIquery\-type\fP
.SH DESCRIPTION
.sp
\fIcondor_stats\fP displays historic information about an HTCondor pool.
Based on the type of information requested, a query is sent to the
\fIcondor_collector\fP daemon, and the information received is displayed
using the standard output. If the \fB\-f\fP option is used, the information
will be written to a file instead of to standard output. The \fB\-pool\fP
option can be used to get information from other pools, instead of from
the local (default) pool. The \fIcondor_stats\fP 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.
.sp
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 \fB\-orgformat\fP 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.
.sp
Note that logging of pool history must be enabled in the
\fIcondor_collector\fP daemon, otherwise no information will be available.
.sp
One query type is required. If multiple queries are specified, only the
last one takes effect.
.SH TIME RANGE OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-lastday\fP
Get information for the last day.
.TP
\fB\-lastweek\fP
Get information for the last week.
.TP
\fB\-lastmonth\fP
Get information for the last month.
.TP
\fB\-lasthours\fP \fIn\fP
Get information for the n last hours.
.TP
\fB\-from\fP \fIm d y\fP
Get information for the time since the beginning of the specified
date. A start date prior to the Unix epoch causes \fIcondor_stats\fP to
print its usage information and quit.
.TP
\fB\-to\fP \fIm d y\fP
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
\fIcondor_stats\fP to print its usage information and quit.
.UNINDENT
.UNINDENT
.UNINDENT
.SH QUERY TYPE ARGUMENTS
.sp
The query types that do not list all of a category require further
specification as given by an argument.
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-resourcequery\fP \fIhostname\fP
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.
.TP
\fB\-resourcelist\fP
A query of a single list of resources to provide a list of all the
machines for which the \fIcondor_collector\fP daemon has historic
information within the query\(aqs time range.
.TP
\fB\-resgroupquery\fP \fIarch/opsys | \(dqTotal\(dq\fP
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
\fBArch\fP, and the operating system is defined by the machine ClassAd
\fBOpSys\fP\&. The string \(dqTotal\(dq ask for information about all
platforms.
.sp
The columns displayed are the number of machines that are
unclaimed, matched, claimed, preempting, owner, shutdown, delete,
backfill, and drained state.
.TP
\fB\-resgrouplist\fP
Queries for a list of all the group names for which the
\fIcondor_collector\fP has historic information within the query\(aqs time
range.
.TP
\fB\-userquery\fP \fIemail_address/submit_machine\fP
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
.INDENT 7.0
.INDENT 3.5
.sp
.EX
\-userquery jondoe@sample.com/onemachine.sample.com
.EE
.UNINDENT
.UNINDENT
.TP
\fB\-userlist\fP
Queries for the list of all submitters for which the
\fIcondor_collector\fP daemon has historic information within the
query\(aqs time range.
.TP
\fB\-usergroupquery\fP \fIemail_address | \(dqTotal\(dq\fP
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.
.TP
\fB\-usergrouplist\fP
Queries for the list of all users for which the \fIcondor_collector\fP
has historic information within the query\(aqs time range.
.UNINDENT
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-f\fP \fIfilename\fP
Write the information to a file instead of the standard output.
.TP
\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP
Contact the specified central manager instead of the local one.
.TP
\fB\-orgformat\fP
Display the information in an alternate format for timing, which
presents timestamps since the Unix epoch. This argument only affects
the display of \fIresoursequery\fP, \fIresgroupquery\fP, \fIuserquery\fP,
and \fIusergroupquery\fP\&.
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
\fIcondor_stats\fP will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
.SH AUTHOR
HTCondor Team
.SH 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.
.\" Generated by docutils manpage writer.
.