/usr/share/doc/condor/html/condor

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<!--Converted with LaTeX2HTML 2008 (1.71)
original version by:  Nikos Drakos, CBLU, University of Leeds
* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>condor_stats</TITLE>
<META NAME="description" CONTENT="condor_stats">
<META NAME="keywords" CONTENT="ref">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">

<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

<LINK REL="STYLESHEET" HREF="ref.css">

<LINK REL="next" HREF="condor_status.html">
<LINK REL="previous" HREF="condor_ssh_to_job.html">
<LINK REL="up" HREF="10_Command_Reference.html">
<LINK REL="next" HREF="condor_status.html">
</HEAD>

<BODY  BGCOLOR=#FFFFFF >

<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html4054"
  HREF="condor_status.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html4048"
  HREF="10_Command_Reference.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html4042"
  HREF="condor_ssh_to_job.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html4050"
  HREF="Contents.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
<A NAME="tex2html4052"
  HREF="Index.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
<BR>
<B> Next:</B> <A NAME="tex2html4055"
  HREF="condor_status.html">condor_status</A>
<B> Up:</B> <A NAME="tex2html4049"
  HREF="10_Command_Reference.html">10. Command Reference Manual</A>
<B> Previous:</B> <A NAME="tex2html4043"
  HREF="condor_ssh_to_job.html">condor_ssh_to_job</A>
 &nbsp; <B>  <A NAME="tex2html4051"
  HREF="Contents.html">Contents</A></B> 
 &nbsp; <B>  <A NAME="tex2html4053"
  HREF="Index.html">Index</A></B> 
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

<UL CLASS="ChildLinks">
<LI><A NAME="tex2html4056"
  HREF="condor_stats.html#SECTION0011441000000000000000">Synopsis</A>
<LI><A NAME="tex2html4057"
  HREF="condor_stats.html#SECTION0011442000000000000000">Description</A>
<LI><A NAME="tex2html4058"
  HREF="condor_stats.html#SECTION0011443000000000000000">Time Range Options</A>
<LI><A NAME="tex2html4059"
  HREF="condor_stats.html#SECTION0011444000000000000000">Query Type Arguments</A>
<LI><A NAME="tex2html4060"
  HREF="condor_stats.html#SECTION0011445000000000000000">Options</A>
<LI><A NAME="tex2html4061"
  HREF="condor_stats.html#SECTION0011446000000000000000">Exit Status</A>
<LI><A NAME="tex2html4062"
  HREF="condor_stats.html#SECTION0011447000000000000000">Author</A>
<LI><A NAME="tex2html4063"
  HREF="condor_stats.html#SECTION0011448000000000000000">Copyright</A>
</UL>
<!--End of Table of Child-Links-->
<HR>

<H1><A NAME="SECTION0011440000000000000000">
<SPAN  CLASS="textit">condor_stats</SPAN></A>
</H1> Display historical information about the Condor pool
  
<P>

<A NAME="man-condor-stats"></A>
<H2><A NAME="SECTION0011441000000000000000">
Synopsis</A>
</H2><SPAN  CLASS="textbf"><SPAN  CLASS="textit">condor_stats</SPAN></SPAN>
[<SPAN  CLASS="textbf">-f  </SPAN><SPAN  CLASS="textit">filename</SPAN>]
[<SPAN  CLASS="textbf">-orgformat</SPAN>]
[<SPAN  CLASS="textbf">-pool  </SPAN><SPAN  CLASS="textit">centralmanagerhostname[:portnumber]</SPAN>]
[<SPAN  CLASS="textbf">time-range</SPAN>]
<SPAN  CLASS="textit">query-type</SPAN>

<P>
<A NAME="74043"></A>
<A NAME="74044"></A>

<P>

<H2><A NAME="SECTION0011442000000000000000">
Description</A>
</H2>
<SPAN  CLASS="textit">condor_stats</SPAN> displays historic information about a Condor pool.
Based on the type of information requested,
a query is sent to the <SPAN  CLASS="textit">condor_collector</SPAN> daemon,
and the information received is displayed using the standard output.
If the <SPAN  CLASS="textbf">-f</SPAN> option is used,
the information will be written to a file instead of
to standard output.
The <SPAN  CLASS="textbf">-pool</SPAN> option can be used to get information from 
other pools, instead of from the local (default) pool.
The <SPAN  CLASS="textit">condor_stats</SPAN> tool is used to query resource 
information (single or by platform),
submitter and user information,
and checkpoint server 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.

<P>
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 <SPAN  CLASS="textbf">-orgformat</SPAN> 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.

<P>
Note that logging of pool history must be enabled in the <SPAN  CLASS="textit">condor_collector</SPAN>
daemon, otherwise
no information will be available.

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

<P>

<H2><A NAME="SECTION0011443000000000000000">
Time Range Options</A>
</H2>

<P>
<DL>
<DT><STRONG><SPAN  CLASS="textbf">-lastday</SPAN></STRONG></DT>
<DD>Get information for the last day.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-lastweek</SPAN></STRONG></DT>
<DD>Get information for the last week.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-lastmonth</SPAN></STRONG></DT>
<DD>Get information for the last month.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-lasthours </SPAN><SPAN  CLASS="textit">n</SPAN></STRONG></DT>
<DD>Get information for the n last hours.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-from </SPAN><SPAN  CLASS="textit">m d y</SPAN></STRONG></DT>
<DD>Get information for the time since the 
    beginning of the specified date. A start date prior to the Unix epoch 
    causes <SPAN  CLASS="textit">condor_stats</SPAN> to print its usage information and quit.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-to </SPAN><SPAN  CLASS="textit">m d y</SPAN></STRONG></DT>
<DD>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 <SPAN  CLASS="textit">condor_stats</SPAN> to print
    its usage information and quit.
<BR></DD>
</DL>

<P>

<H2><A NAME="SECTION0011444000000000000000">
Query Type Arguments</A>
</H2>

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

<P>
<DL>
<DT><STRONG><SPAN  CLASS="textbf">-resourcequery </SPAN><SPAN  CLASS="textit">hostname</SPAN></STRONG></DT>
<DD>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.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-resourcelist</SPAN></STRONG></DT>
<DD>A query of a single list of resources
    to provide a list of all the machines for which the <SPAN  CLASS="textit">condor_collector</SPAN>
    daemon has historic information within the query's time range.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-resgroupquery </SPAN><SPAN  CLASS="textit">arch/opsys | ``Total''</SPAN></STRONG></DT>
<DD>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 <TT>Arch</TT>,
    and the operating system is defined by the machine ClassAd
    <TT>OpSys</TT>.
    The string ``Total'' ask for information about all platforms.

<P>
The columns displayed are the number of machines that are
    unclaimed, matched, claimed, preempting, owner, shutdown, delete, backfill, and drained state.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-resgrouplist</SPAN></STRONG></DT>
<DD>Queries for a list of 
    all the group names for which the <SPAN  CLASS="textit">condor_collector</SPAN> has
    historic information within the query's time range.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-userquery </SPAN><SPAN  CLASS="textit">email_address/submit_machine</SPAN></STRONG></DT>
<DD>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 
<BR><PRE>
    -userquery jondoe@sample.com/onemachine.sample.com
</PRE>

<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-userlist</SPAN></STRONG></DT>
<DD>Queries for the list of all submitters
    for which the <SPAN  CLASS="textit">condor_collector</SPAN> daemon has historic information 
    within the query's time range.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-usergroupquery </SPAN><SPAN  CLASS="textit">email_address |  ``Total''</SPAN></STRONG></DT>
<DD>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.  
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-usergrouplist</SPAN></STRONG></DT>
<DD>Queries for the list of all users
     for which the <SPAN  CLASS="textit">condor_collector</SPAN> has historic information within
     the query's time range.
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-ckptquery </SPAN><SPAN  CLASS="textit">hostname</SPAN></STRONG></DT>
<DD>Query about a checkpoint 
     server given its host name.
     The information displayed includes the
     number of Mbytes received, Mbytes sent, average receive bandwidth
     (in Kbytes/sec), and average send bandwidth (in Kbytes/sec).
    
<BR>
<P>
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-ckptlist</SPAN></STRONG></DT>
<DD>Query for the entire list of checkpoint
    servers for which the <SPAN  CLASS="textit">condor_collector</SPAN> has historic information in
    the query's time range.
<BR></DD>
</DL>

<P>

<H2><A NAME="SECTION0011445000000000000000">
Options</A>
</H2>
  
<P>
  <DL>
<DT><STRONG><SPAN  CLASS="textbf">-f </SPAN><SPAN  CLASS="textit">filename</SPAN></STRONG></DT>
<DD>Write the information to a file
    instead of the standard output.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-pool </SPAN><SPAN  CLASS="textit">centralmanagerhostname[:portnumber]</SPAN></STRONG></DT>
<DD>Contact the specified central manager instead of the local one.
<BR>    
</DD>
<DT><STRONG><SPAN  CLASS="textbf">-orgformat</SPAN></STRONG></DT>
<DD>Display the information in
    an alternate format for timing, which presents timestamps since
    the Unix epoch.  This argument only affects the display of
    <SPAN  CLASS="textit">resoursequery</SPAN>,
    <SPAN  CLASS="textit">resgroupquery</SPAN>,
    <SPAN  CLASS="textit">userquery</SPAN>,
    <SPAN  CLASS="textit">usergroupquery</SPAN>, and
    <SPAN  CLASS="textit">ckptquery</SPAN>.
    
<BR>  
</DD>
</DL>
  
<P>

<P>

<H2><A NAME="SECTION0011446000000000000000">
Exit Status</A>
</H2>

<P>
<SPAN  CLASS="textit">condor_stats</SPAN> will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.

<P>

<H2><A NAME="SECTION0011447000000000000000">
Author</A>
</H2> Condor Team, University of Wisconsin-Madison
  
<H2><A NAME="SECTION0011448000000000000000">
Copyright</A>
</H2> 
  Copyright &#169; 1990-2012 Condor Team, Computer Sciences Department, 
  University of Wisconsin-Madison, Madison, WI.  All Rights Reserved.  
	Licensed under the Apache License, Version 2.0.

<P>
See the <SPAN  CLASS="textit">Condor Version 7.8.2 Manual</SPAN> or
	<A NAME="tex2html409"
  HREF="http://www.condorproject.org/license">http://www.condorproject.org/license</A>
for
  additional notices. 


<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html4054"
  HREF="condor_status.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html4048"
  HREF="10_Command_Reference.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html4042"
  HREF="condor_ssh_to_job.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html4050"
  HREF="Contents.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
<A NAME="tex2html4052"
  HREF="Index.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
<BR>
<B> Next:</B> <A NAME="tex2html4055"
  HREF="condor_status.html">condor_status</A>
<B> Up:</B> <A NAME="tex2html4049"
  HREF="10_Command_Reference.html">10. Command Reference Manual</A>
<B> Previous:</B> <A NAME="tex2html4043"
  HREF="condor_ssh_to_job.html">condor_ssh_to_job</A>
 &nbsp; <B>  <A NAME="tex2html4051"
  HREF="Contents.html">Contents</A></B> 
 &nbsp; <B>  <A NAME="tex2html4053"
  HREF="Index.html">Index</A></B> </DIV>
<!--End of Navigation Panel-->
<ADDRESS>
condor-admin@cs.wisc.edu
</ADDRESS>
</BODY>
</HTML>
condor-doc 7.8.2~dfsg.1-1+deb7u3 / usr / share / doc / condor / html / condor_stats.html.bak
