Name
condor_history - View log of Condor jobs completed to date
Synopsis
condor_history [ -help ]
condor_history [ -backwards ] [ -completedsince postgrestimestamp ] [
-constraint expr ] [ -f filename ] [ -format formatString AttributeName
] [ -l | -long | -xml ] [ -match number ] [ -name schedd-name ] [
cluster | cluster.process | owner ]
Description
condor_history displays a summary of all Condor jobs listed in the
specified history files, or in the Quill database, when Quill is
enabled. If no history files are specified (with the -f option) and
Quill is not enabled, the local history file as specified in Condor’s
configuration file ($(SPOOL)/historyby default) is read. The default
listing summarizes (in chronological order) each job on a single line,
and contains the following items:
ID
The cluster/process id of the job.
OWNER
The owner of the job.
SUBMITTED
The month, day, hour, and minute the job was submitted to the queue.
RUN_TIME
Remote wall clock time accumulated by the job to date in days,
hours, minutes, and seconds. See the definition of
RemoteWallClockTimeon page .
ST
Completion status of the job (C = completed and X = removed).
COMPLETED
The time the job was completed.
CMD
The name of the executable.
If a job ID (in the form of cluster_id or cluster_id.proc_id ) or an
owner is provided, output will be restricted to jobs with the specified
IDs and/or submitted by the specified owner. The -constraint option can
be used to display jobs that satisfy a specified boolean expression.
The history file is kept in chronological order, implying that new
entries are appended at the end of the file. As of Condor version
6.7.19, the format of the history file is altered to enable faster
reading of the history file backwards (most recent job first). History
files written with earlier versions of Condor, as well as those that
have entries of both the older and newer format need to be converted to
the new format. See the condor_convert_history manual page on page for
details on converting history files to the new format.
Options
-help
Display usage information and exit.
-backwards
List jobs in reverse chronological order. The job most recently
added to the history file is first.
-completedsince postgrestimestamp
When Quill is enabled, display only job ads that were in the
Completed job state on or after the date and time given by the
postgrestimestamp . The postgrestimestamp follows the syntax as
given for PostgreSQL version 8.0. The behavior of this option is
undefined when Quill is not enabled.
-constraint expr
Display jobs that satisfy the expression.
-f filename
Use the specified file instead of the default history file. When
Quill is enabled, this option will force the query to read from the
history file, and not the database.
-format formatString AttributeName
Display jobs with a custom format. See the condor_q man page -format
option for details.
-l or -long
Display job ads in long format.
-match number
Limit the number of jobs displayed to number .
-name schedd-name
When Quill is enabled, query job ClassAds from the named
condor_schedd daemon, not the default condor_schedd daemon.
-xml
Display job ClassAds in xml format. The xml format is fully defined
at http://www.cs.wisc.edu/condor/classad/refman/.
Examples
To see all historical jobs since April 1, 2005 at 1pm,
%condor_history -completedsince ’04/01/2005 13:00’
Exit Status
condor_history will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.
Author
Condor Team, University of Wisconsin-Madison
Copyright
Copyright (C) 1990-2009 Condor Team, Computer Sciences Department,
University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
Licensed under the Apache License, Version 2.0.
See the Condor Version 7.2.4 Manual or
http://www.condorproject.org/licensefor additional notices. condor-
admin@cs.wisc.edu
date just-man-pages/condor_history(1)