Last updated 26th March 2021
Logs for various tasks on an application container are available in the
/var/log directory. They can be accessed on the normal shell after logging in with
Alternatively, they may also be accessed remotely using the
webpaas log command. The CLI lets you specify which log file to access (the name of the file below minus the
.log extension, as well as view the entire file in a pager, only the most recent lines, and so forth.
webpaas log --help for complete documentation.
A number of different log files are available depending on the application container in use.
Although the files in
/var/log are writable, they should not be written to directly. Only write to it via standard logging mechanisms, such as your application's logging facility. If your application has its own logging mechanism that should be written to a dedicated logs mount in your application.
All log files are trimmed to 100 MB automatically. But if you need to have complete logs, you can set up cron which will upload them to third-party storage. Contextual Code made a simple and well-described example how to achieve it.
This is the raw access log for the nginx instance running on the application container. That is, it does not include any requests that return a redirect or cache hit from the router.
Any log messages generated by the application will be sent to this file. That includes language errors such as PHP Errors, Warnings, and Notices, as well as uncaught exceptions.
The cron log contains the output of all recent cron executions. If there is no cron hook specified in the container configuration then this file will be absent. It also will not exist until the first time cron has run.
The deploy log contains the output of the most recent run of the
deploy hook for the container. If there is no
deploy hook then this file will be absent.
All DNS queries made by processes in the container (the application, crons, etc.) will be sent to this file.
nginx startup log messages will be recorded in this file. It is rarely needed except when debugging possible nginx configuration errors. This file is not currently available using the
webpaas log command.
nginx-level errors that occur once nginx has fully started will be recorded here. This will include HTTP 500 errors for missing directories, file types that are excluded based on the
.platform.app.yaml file, etc.
On a PHP container, the php.access.log contains a record of all requests to the PHP service.
The post_deploy log contains the output of the most recent run of the
post_deploy hook for the container. If there is no
post_deploy hook then this file will be absent.
Did you find this guide useful?
Please feel free to give any suggestions in order to improve this documentation.
Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.
Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.
Thank you. Your feedback has been received.