Home / server / Questions / 183589
In Process
sorin
Asked: 2010-09-23 05:38:47 +0800 CST

How do I activate launchd logging on OS X?

  • 772

How do I activate launchd logging on OS X 10.6?

I added a new daemon that is not starting properly (status is 1).

I want to debug the problem but I was not able to find launchd logs, they are not in /var/log/launchd.log.

mac-osx launchd launchctl

3 Answers

  1. Assuming you're trying to log your process rather than launchd itself, if you include the following lines in the launchd plist file:

    <key>StandardOutPath</key>
<string>/path/to/logfile.log</string>
<key>StandardErrorPath</key>
<string>/path/to/another_logfile.log</string>

    and reload the process, any logging or printing that you have internal to your script will be captured in one of those two files whenever it is run. though rotating the files appears to be up to you. as you might expect, if you use the same file in both instances, it will log both error and stdout to the same place.

    See: Debugging launchd Jobs section at Creating Launch Daemons and Agents.

    • 33

  2. I found the solution

     sudo launchctl log level debug

    and after this

     tail -f /var/log/system.log
    • 31

  3. On OS X 10.11 (El Capitan), you can use sudo launchctl debug <service-target> --stdout --stderr to enable one-off logging, if you don't want to take the filesystem option suggested by @peter.

    Lots of stuff is different in the current implementation of launchctl, and the <service-target> is kind of weird. For example, suppose I have a local service that I configure at ~/Library/LaunchAgents/dev.localmon.plist, which has the "label" dev.localmon. Its <service-target> is gui/$UID/dev.localmon, where $UID is your user ID, which, since you're running this at the CLI, your shell will interpolate for you.

    So supposing my dev.localmon service was crashing on startup (it was), I could call the following to have launchctl pipe the process's stdout and stderr into my shell the next time (and only the next time) the service starts:

    sudo launchctl debug gui/$UID/dev.localmon --stdout --stderr

    Since that hangs with the open-and-ready TTYs, go to another terminal and run:

    launchctl start dev.localmon
# start is a legacy command and doesn't use the fancy new service-target notation

    Then, back in the first terminal, you should see the output. (Oddly, it doesn't close when the service process dies, so you'll have to Ctrl-C.)

    Btw, once you fix your config file with whatever PATH or environment was breaking the service before, you still have to use the old launchctl unload ~/Library/LaunchAgents/dev.localmon.plist && launchctl load ~/Library/LaunchAgents/dev.localmon.plist two-step since the documentation's purported uncache subcommand has the following effect:

    Command is not yet implemented.

    Yay for Apple's post-Jobs release strategy: "Move fast and break things"

    • 23