View Bench Logs
Frappe Cloud allows you to view logs for your bench directly from the dashboard. These logs help you monitor running processes, investigate errors, and troubleshoot issues with your applications and background jobs.
Note
Bench logs are available from the Bench dashboard and are useful for diagnosing issues related to the bench and its running processes.
Access Bench Logs
- Open your Bench dashboard.
- Select the bench whose logs you want to inspect.
- Click View Logs.
- Browse the available log files to monitor activity or troubleshoot issues.
Common Log Files
The following log files are commonly used for debugging:
- web.log – Contains the standard output (STDOUT) generated by the web process.
- web.err.log – Contains error messages (STDERR) generated by the web process.
- worker.log – Records the standard output of background worker processes.
- worker.err.log – Records errors generated by background worker processes.
These logs are usually the first place to investigate when debugging application errors, failed requests, or background job failures.
Additional Process Logs
Each process running on the bench has its own log file inside the logs directory. These correspond to the processes managed by Supervisor and can be helpful when troubleshooting specific services running on the bench.
Site-Specific Logs
If you need to troubleshoot logs for an individual site rather than the entire bench, use the site-specific logging features available in Frappe Framework.
Best Practice
When troubleshooting issues, start by checking web.err.log for request-related errors and worker.err.log for background job failures. These logs usually provide the most useful information for identifying the root cause.
