logs.md

Logs

Log levels

From 0 to 5 in severity:

• debug - for debugging purposes, only
• info - an informative message
• warn - this may or may not be an issue
• error - this is an issue, but the application can continue running
• fatal - this is and issue, and the application should halt
• unknown - we don't know (?)

A corresponding Rails.logger.level method exists for each of these levels.

Logging important events in the application

When writing to the log, give the developer some "breadcrumbs" to follow. Specify the class name and method name that is writing to the log.

msg = "[#{self.class.name}##{__method__}] something important happened that we should log."
Rails.logger.info(msg)

If you are rescueing, it probably makes sense to log the error, as well.

begin
  # some code that might fail
rescue StandardError => err
  Rails.logger.error("[#{self.class.name}##{__method__}] raised an error.")
  Rails.logger.error(err)
  # handle the error
end

Download Logs from Production

$ scp -p ubuntu@wobbe.workbar.com:~/wobbe/current/log/* ~/path/to/wobbe/logs

Searching Logs

The following command will show you three lines before and three lines after any occurrence of ClassName.

$ cat production.log | grep -B 3 -A 3 "ClassName"