If I setup
cron jobs incorrectly they appear to silently fail. Where should I look for an error log to understand what went wrong?
As others have pointed out,
cron will email you the output of any program it runs (if there is any output). So, if you don't get any output, there are basically three possibilities:
crondcould not even start a shell for running the program or sending email
crondhad troubles mailing the output, or the mail was lost.
- the program did not produce any output (including error messages)
Case 1. is very unlikely, but something should have been written in the cron logs. Cron has an own reserved syslog facility, so you should have a look into
/etc/syslog.conf (or the equivalent file in your distro) to see where messages of facility
cron are sent. Popular destinations include
In case 2., you should inspect the mailer daemon logs: messages from the Cron daemon usually appear as from
root@yourhost. You can use a
MAILTO=... line in the crontab file to have cron send email to a specific address, which should make it easier to grep the mailer daemon logs. For instance:
MAILTOfirstname.lastname@example.org 00 15 * * * echo "Just testing if crond sends email"
In case 3., you can test if the program was actually run by appending another command whose effect you can easily check: for instance,
00 15 * * * /a/command; touch /tmp/a_command_has_run
so you can check if
crond has actually run something by looking at
the mtime of
You can always explicitly send the job output to a log file:
0 8 * * * /usr/local/bin/myjob > /var/log/myjob.log 2>&1
Keep in mind that this will supercede the mail behaviour that has been mentioned before, because crond iself won't receive any output from the job. If you want to keep that behaviour you should look into tee(1).
If you aren't seeing the mails, you might be spamming root@yourcompany with the errors which can be quite annoying to the people who use that account for monitoring. Try sending the output to Syslog instead:
*/5 * * * * yourcronjob 2>&1 | /usr/bin/logger -t yourtag
Then, wait for the cronjob to run and look for the error in /var/log/messages (or /var/log/user.log on some systems).
This works great for errors messages which are only 1-2 lines long, such as "yourcronjob: command not found". It also makes use of your existing syslog infrastructure (Logrotation, central syslogging, Splunk, etc.) It also reduces email spam to root.
It may not be a good solution if your cronjob generates hundreds of lines of output.
You should get email from
crond when the job either fails to run or when the job returns a nonzero exit code. Try typing:
at the command prompt.
mailx(1) is the basic mail reading program on most every Unixlike system. It is very primitive by modern standards, but you can pretty much count on it to always be available. Other, better mail agents may be available, but there are enough of them that you never know which one is installed on some random machine you happen to be using.
Note that unless you have configured your system as an Internet email server, this mail subsystem is used only within the machine. You can send email to and receive from other users on the machine, but you may not be able to send email out to the world, and email from the outer world certainly won't be able to come to your machine.
The default cron configuration will send you a mail with the output of your program. If this fails, you could try wrapping your failing program in a shell script that ensures that the program does not fail, and you could further log the output.
This is a configurable setting on some cron implementations.
I stumbled across this thread a few years ago experiencing the same problems and just recently came across a solution to the above mentioned cases by Ricardo. The lack of an email is hard to detect (as you mentioned) and you certainly don't want to spam your root@yourcompany email. If interested check out deadmanssnitch.com.. This tool seems to solve the aforementioned cases. Seems pretty simple to use— just add the bit of code the tool gives you to your cronjob. If your job fails to run at a specified internal, you will be alerted. If you job starts running again you'll also be alerted.
Another useful trick is to see what scripts are actually executed.
This is done with
run-parts -v --test /etc/cron.hourly/
If your script does not show up it will not be executed.
This btw only works for the scripts installed in the
/etc/cron.hourly directory. It does not show you items that are set
vixie-cron, so I don't know if this applies to everything. But I have a
dead.letter file that contains all the output of the job.
/root/ folder I have
crons.cron which I set as my crontab by running
dead.letter will be created in
/root/ as well.
I just Google'd
dead.letter, and it's an undeliverable mail. It has nothing to do with cron apparently. If you don't have mail set up correctly (like me), you'll have the file.