This page describes:
- Home directory
- System logger: syslog
- Rotate your logs with logrotate
- Mongrel logs
- Environment log file
- Nginx logs
- Nginx configuration
- Monit log
- Monit configuration
- Passenger 3 log
- Unicorn log
- Chef recipe logs
Use the following substitutions for illustration:
A user home directory is created for you:
If you look closely, this is actually a symlink to the persistent /data device. Therefore, you can safely store items in the home directory. You will see that your home directory symlinks to:
System logger: syslog
syslog you find system messages, monit restart calls, cron job notifications and various other useful bits of information.
Rotate your logs with logrotate
By default, all parts of the stack are under
logrotate to properly rotate and gzip old logs. The individual configuration files are found here:
Each configuration file can contain the following directives:
- daily/weekly/monthly/yearly: Frequency at which log files are rotated.
- rotate [n]: Log files are rotated n times before being removed or mailed to the address specified in a mail directive. If count is 0, old versions are removed rather than rotated.
- missingok: If the log file is missing, go on to the next one without issuing an error message.
Refer to Logrotate for more information.
If you have mongrels, your logs exist here:
Environment log file
If you need access to the
production.log you can find it here:
We configure nginx to split access and error into two files:
Nginx configuration is symlinked from
/etc/nginx to ensure that it persists when the instance is shutdown.
A configuration for your application is automatically generated and you will find it here:
Monit log information is sent to the system logger. See System logger: syslog above.
Monit configuration files are located here:
If you are running a mongrel instance, you should see your monit and mongrel configurations here:
When adding additional services under
monit, we recommend you create a new file ending in
.monitrc according to the same naming convention. For example:
If you’d like to edit the master monit configuration, you can do so here:
Passenger 3 and 4 send log information to:
Passenger 5 sends log information to:
Unicorn sends log information to three log files in the
Chef recipe logs
If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.