Logging on fortrabbit

You are developing your App and see the "white screen of death". You are getting a 5xx error and don't know why. You write debug logs and need them to trace a problem.

Live log access

Use the SSH logging SSH remote command in the terminal to get a live streams of all the logs for your Apps:

# All sources tailed together:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail

# Only Apache access logs:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:apache_access
# incoming requests with response status, time-stamp, additional headers & first line of request

# Only Apache error log:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:apache_error
# helpful to debug `.htaccess` files and alike

# Only Object Storage access log:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:objects_access
# See requests when and from whom

# Only PHP error logs:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:web_php_error
# contains whatever your App writes on `error_log()`

# Only web standard error output:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:web_stderr
# contains everything written by your App to `STDERR`


# Only Cron Job or Nonstop Job output:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:worker
# Worker must be enabled

# --------------- PRO TIPS ---------------

# Use the mono flag to force monochrome output, if your console displays colors incorrectly:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail {{app-name}} mono

# Use multiple source:name parameters at once:
$ ssh {{ssh-user}}@log.{{region}}.frbit.com tail source:web_stderr source:web_php_error

Historic log file access

You can also access your log files, including older logs via SSH or SFTP. They are usually stored in the folder logs, right above the htdocs folder. The log folder contains up to eight files, by type of log and time:

$ ls -1 ../logs

# Apache access logs (current and historic)
apache_access.log
apache_access.log.1.gz

# Optional cron logs (current and historic)
cron.log
cron.log.1.gz

# PHP error logs (`error_log`) (current and historic)
php_error.log
php_error.log.1.gz

# PHP STDERR output (current and historic)
stderr.log
stderr.log.1.gz

The .log file contains the latest logs, the .gz (gzipped) file contains older logs for each type. Not each log might actually be available, the files shown are symlinks. The Apache logs are containing IP addresses (Remote_Addr).

Log files in your CMS/framework

Mind that your CMS or framework might store logs in a different location. The basic concepts here will still apply, but the location and file name of the logs might be different. You might also can turn on more verbose logging output. See specific guides here:

• Craft CMS logging
• Laravel logging