/
Debugging Edxapp
Debugging Edxapp
Relevant Log Files
Log File Location | What's in it? |
---|---|
/edx/var/log/supervisor/lms-stderr.log /edx/var/log/supervisor/cms-stderr.log | Startup error messages and debug output from the running LMS django process |
/edx/var/log/supervisor/supervisord.log | Debug output from the supervisor task manager - If you make changes to the supervisor task definitions, look here. |
/edx/var/log/lms/edx.log /edx/var/log/cms/edx.log | Request logs and errors from the LMS - If you're getting a 500 error on a certain request, look here. |
/edx/var/log/nginx/error.log | Errors from nginx proxy server that front-ends both the LMS and CMS. - Mostly access or configuration related errors. If you're getting a 4xx or 5xx error, look here |
/edx/var/log/nginx/access.log | Access logs for all requests to the server. |
Configuration files
Configuration File Location | What's in it? | Format |
---|---|---|
/edx/app/edxapp/lms.env.json /edx/app/edxapp/cms.env.json | Most configuration parameters for the app. - Feature flags - backend server locations - theme related settings | JSON |
/edx/app/edxapp/lms.auth.json /edx/app/edxapp/cms.auth.json | Authentication parameters for the app - API Keys - Database passwords - occasional settings that are paired with authentication | JSON |
/edx/app/supervisor/conf.d/lms.conf /edx/app/supervisor/conf.d/cms.conf | Supervisor task manager configuration for apps - Environment variables are here - Startup commands for the apps. | supervisor config |
/edx/app/supervisor/pre_supervisor_checks.py | Migration check commands | Python |
Steps
- Look in log files for errors
- Solve the problem
- Profit!
Docker Devstack
Use convenient make commands to view logs for specific IDAs. More details in the readme https://github.com/edx/devstack
To see logs from containers running in detached mode, you can either use "Kitematic" (available from the "Docker for Mac" menu), or by running the following:
make logs
To view the logs of a specific service container run make <service>-logs
. For example, to access the logs for Ecommerce, you can run:
make ecommerce-logs
, multiple selections available,
Related content
Managing Open edX Tips and Tricks
Managing Open edX Tips and Tricks
More like this
Debugging Memory Leaks
Debugging Memory Leaks
Read with this
Common Issues and How to Fix Them
Common Issues and How to Fix Them
More like this
Running Open EdX in Production
Running Open EdX in Production
Read with this
Useful Sandbox Operations
Useful Sandbox Operations
More like this
How to Override Default Configuration Passwords and Verify Exposed Services
How to Override Default Configuration Passwords and Verify Exposed Services
Read with this