CONDOR_FETCHLOG(1)

✨ CONDOR_FETCHLOG ✨

okay bestie, so this is the HTCondor Manual page for condor_fetchlog, and honestly? it's giving "remote-log-retrieval but make it effortless." πŸŽ€


πŸ’– NAME πŸ’–

condor_fetchlog β€” grab a daemon's log file when that log is living on a whole other computer. no ssh-ing in, no drama, no cap. πŸ¦‹


🌸 SYNOPSIS 🌸

condor_fetchlog [-help | -version ]

condor_fetchlog [-pool centralmanagerhostname[:portnumber]] [-master |
-startd | -schedd | -collector | -negotiator | -kbdd ] machine-name
subsystem[.extension]

(yeah the line wrap is a little chaotic, but every single flag up there is real, we're keeping all of them πŸ‘‘)


🫢 DESCRIPTION 🫢

condor_fetchlog slides into the HTCondor running on the machine you named with machine-name, and is like "hey, hand over that log file please." πŸ₯Ί Which log file it gets? That's decided by the subsystem[.extension] argument. Then the log file just... prints to standard output. boom. ✨

the whole point: this command means you never have to remotely log in to a machine just to go fetch a daemon's log file. full convenience, main character energy, literally.

⚠️ security check bestie: for authentication and authorization purposes, this command requires ADMINISTRATOR level of access. so like, you need the clearance. πŸ’…

🧚 how the file name gets built 🧚

the subsystem[.extension] argument is used to construct the log file's name. here's the tea:

  • if you don't give an optional .extension, then the value of the configuration variable named subsystem_LOG defines the log file's name.
  • if you do give the .extension, it gets appended to that value.

the subsystem argument can be any value $(SUBSYSTEM) that has a defined configuration variable of $(SUBSYSTEM)_LOG, or any of these iconic three:

  • NEGOTIATOR_MATCH
  • HISTORY
  • STARTD_HISTORY

and for the optional .extension on the subsystem argument, it's typically one of these three strings:

  1. .old
  2. .slot<X>
  3. .slot<X>.old

inside those strings, <X> gets substituted with the slot number. 🎰

πŸ’‘ one more thing: if you pass a subsystem argument of STARTD_HISTORY, it fetches ALL the condor_startd history β€” by concatenating every instance of the log files that resulted from rotation. all of them. periodt.

πŸ’… OPTIONS πŸ’…

  • -help β€” shows you the usage information πŸ“–
  • -version β€” shows you the version information 🏷️
  • -pool centralmanagerhostname[:portnumber] β€” pick a pool by handing over the central manager's host name, plus an optional port number 🌐
  • -master β€” send the command to the condor_master daemon (this is the default btw πŸ‘‘)
  • -startd β€” send the command to the condor_startd daemon
  • -schedd β€” send the command to the condor_schedd daemon
  • -collector β€” send the command to the condor_collector daemon
  • -kbdd β€” send the command to the condor_kbdd daemon

🌈 EXAMPLES 🌈

wanna get the condor_negotiator daemon's log off a host named head.example.com, from inside the current pool? say less:

$ condor_fetchlog head.example.com NEGOTIATOR

wanna get the condor_startd daemon's log off a host named execute.example.com, also from inside the current pool? also say less:

$ condor_fetchlog execute.example.com STARTD

okay so pivot: that command above asked the condor_master for the condor_startd daemon's log. but what if the condor_master has crashed or is just straight up unresponsive? 😭 then you ask another daemon running on that computer to hand over the log instead. example β€” ask the condor_startd daemon to return the condor_master's log:

$ condor_fetchlog -startd execute.example.com MASTER

⭐ EXIT STATUS ⭐

condor_fetchlog exits with a status value of 0 (zero) when everything slays, and exits with the value 1 (one) when it fails. no in-between, bestie. 🫑


πŸ’œ AUTHOR πŸ’œ

HTCondor Team


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


✨ and that's the whole page! this cutie came out of the HTCondor Manual, dated Oct 16, 2026. go fetch those logs, you absolute legend. πŸ’–πŸ¦‹πŸ’…
πŸ“¦ where this page comes from