Man page - condor_history(1)

Packages contains this manual

Package:  condor
apt-get install condor

Manuals in package:
• condor_job_router_info(1)
• condor_store_cred(1)
• condor_submit_dag(1)
• condor_stats(1)
• condor_top(1)
• gidd_alloc(1)
• condor_rmdir(1)
• condor_qsub(1)
• classad_eval(1)
• condor_install(1)
• condor_ping(1)
• condor_who(1)
• condor_rm(1)
• condor_router_rm(1)
• condor_upgrade_check(1)
• condor_reconfig(1)
• condor_gather_info(1)
• condor_annex(1)
• condor_vacate_job(1)
• get_htcondor(1)
• condor_preen(1)
• condor_master(1)
• condor_tail(1)
• condor_token_request_auto_approve(1)
• condor_restart(1)
• condor_continue(1)
• condor_update_machine_ad(1)
• classads(1)
• condor_evicted_files(1)
• condor_chirp(1)
• condor_q(1)
• condor_qedit(1)
• condor_test_token(1)
• condor_router_history(1)
• condor_history(1)
• condor_procd(1)
• condor_on(1)
• condor_status(1)
• condor_watch_q(1)
• condor_ssl_fingerprint(1)
• condor_token_fetch(1)
• condor_fetchlog(1)
• condor_submit(1)
• condor_token_request_list(1)
• condor_transfer_data(1)
• condor_hold(1)
• condor_wait(1)
• condor_ssh_to_job(1)
• condor_prio(1)
• condor_pool_job_report(1)
• condor_token_request(1)
• condor_config_val(1)
• condor_set_shutdown(1)
• condor_userprio(1)
• condor_adstash(1)
• condor_userlog(1)
• condor_sos(1)
• condor_gpu_discovery(1)
• condor_transform_ads(1)
• condor_findhost(1)
• condor_now(1)
• condor_updates_stats(1)
• condor_version(1)
• htcondor(1)
• condor_vacate(1)
• condor_run(1)
• condor_advertise(1)
• condor_suspend(1)
• procd_ctl(1)
• condor_router_q(1)
• condor_token_request_approve(1)
• condor_check_userlogs(1)
• condor_reschedule(1)
• condor_token_create(1)
• condor_dagman(1)
• condor_power(1)
• condor_drain(1)
• condor_release(1)
• condor_ssh_start(1)
• condor_urlfetch(1)
• condor_remote_cluster(1)
• condor_check_password(1)
• condor_token_list(1)
• condor_off(1)
• condor_configure(1)
Documentations in package:
• condor

Manual

CONDOR_HISTORY

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT STATUS
AUTHOR
COPYRIGHT

---

NAME

condor_history - HTCondor Manual

View log of HTCondor jobs completed to date

SYNOPSIS

condor_history [ -help ]

condor_history [ -name name ] [ -pool centralmanagerhostname[:portnumber] ] [ -backwards ] [ -forwards ] [ -constraint expr ] [ -file filename ] [ -userlog filename ] [ -search path ] [ -dir | -directory ] [ -local ] [ -startd ] [ -epochs ] [ -format formatString AttributeName ] [ -autoformat[:jlhVr,tng] attr1 [attr2 ...] ] [ -l | -long | -xml | -json | -jsonl ] [ -match | -limit number ] [ -attributes attr1[,attr2...] ] [ -print-format file ] [ -wide ] [ -since time_or_jobid ] [ -completedsince time_expr ] [ -scanlimit number ] [ cluster | cluster.process | owner ]

DESCRIPTION

condor_history displays a summary of all HTCondor jobs listed in the specified history files. If no history files are specified with the -file option, the local history file as specified in HTCondor's configuration file ( $(SPOOL) /history by default) is read. The default listing summarizes in reverse 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, given as the job ClassAd attribute RemoteWallClockTime .

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.

OPTIONS

-help

Display usage information and exit.

-name name

Query the named condor_schedd daemon. If used with -startd , query the named condor_startd daemon

-pool centralmanagerhostname[:portnumber]

Use the centralmanagerhostname as the central manager to locate condor_schedd daemons. The default is the COLLECTOR_HOST , as specified in the configuration.

-backwards

List jobs in reverse chronological order. The job most recently added to the history file is first. This is the default ordering.

-forwards

List jobs in chronological order. The job most recently added to the history file is last. At least 4 characters must be given to distinguish this option from the -file and -format options.

-constraint expr

Display jobs that satisfy the expression.

-since jobid or expr

Stop scanning when the given jobid is found or when the expression becomes true.

-completedsince time_expr

Scan until the first job that completed on or before the given unix timestamp. The argument can be any expression that evaluates to a unix timestamp. This option is equivalent to -since 'CompletionDate<=time_expr' .

-scanlimit Number

Stop scanning when the given number of ads have been read.

-limit Number

Limit the number of jobs displayed to Number . Same option as -match .

-match Number

Limit the number of jobs displayed to Number . Same option as -limit .

-local

Read from local history files even if there is a SCHEDD_HOST configured.

-startd

Read from Startd history files rather than Schedd history files. If used with the -name option, query is sent as a command to the given Startd which must be version 9.0 or later.

-epochs[:d]

Read per job run instance recording also known as job epochs instead of default history file. The -epochs option may be followed by a colon character for extra functionality:

d Delete job epoch files after finished reading. This option only deletes epoch files store within JOB_EPOCH_HISTORY_DIR , and can not be used with -match , -limit , or -scanlimit .

-file filename

Use the specified file instead of the default history file.

-userlog filename

Display jobs, with job information coming from a job event log, instead of from the default history file. A job event log does not contain all of the job information, so some fields in the normal output of condor_history will be blank.

-search path

Use the specified path to filename and all matching condor time rotated files filename.YYYYMMDDTHHMMSS instead of the default history file. If used with -dir option then condor_history will use the provided path as the directory to search for specific pattern matching history files.

-dir or -directory

Search for files in a sources alternate directory configuration knob to read from instead of default history file. Note: only applies to -epochs .

-format formatString AttributeName

Display jobs with a custom format. See the condor_q man page -format option for details.

-autoformat[:jlhVr,tng] attr1 [attr2 ...] or -af[:jlhVr,tng] attr1
[attr2 ...]

(output option) Display attribute(s) or expression(s) formatted in a default way according to attribute types. This option takes an arbitrary number of attribute names as arguments, and prints out their values, with a space between each value and a newline character after the last value. It is like the -format option without format strings.

It is assumed that no attribute names begin with a dash character, so that the next word that begins with dash is the start of the next option. The autoformat option may be followed by a colon character and formatting qualifiers to deviate the output formatting from the default:

j print the job ID as the first field,

l label each field,

h print column headings before the first line of output,

V use %V rather than %v for formatting (string values are quoted),

r print "raw", or unevaluated values,

, add a comma character after each field,

t add a tab character before each field instead of the default space character,

n add a newline character after each field,

g add a newline character between ClassAds, and suppress spaces before each field.

Use -af:h to get tabular values with headings.

Use -af:lrng to get -long equivalent format.

The newline and comma characters may not be used together. The l and h characters may not be used together.

-print-format file

Read output formatting information from the given custom print format file. see Print Formats for more information about custom print format files.

-l or -long

Display job ClassAds in long format.

-attributes attrs

Display only the given attributes when the -long o ption is used.

	-xml		Display job ClassAds in XML format. The XML format is fully defined in the reference manual, obtained from the ClassAds web page, with a link at - http://htcondor.org/classad/classad.html .
	-json		Display job ClassAds in JSON format.
	-jsonl		Display job ClassAds in JSON-Lines format: one job ad per line.

-wide[:number]

Restrict output to the given column width. Default width is 80 columns, if -wide is used without the optional number argument, the width of the output is not restricted.

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

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.

---