pythonnginxflaskuwsgi

Flask application traceback doesn't show up in server log


I'm running my Flask application with uWSGI and nginx. There's a 500 error, but the traceback doesn't appear in the browser or the logs. How do I log the traceback from Flask?

uwsgi --http-socket 127.0.0.1:9000 --wsgi-file /var/webapps/magicws/service.py --module service:app --uid www-data --gid www-data --logto /var/log/magicws/magicapp.log

The uWSGI log only shows the 500 status code, not the traceback. There's also nothing in the nginx log.

[pid: 18343|app: 0|req: 1/1] 127.0.0.1 () {34 vars in 642 bytes} 
[Tue Sep 22 15:50:52 2015] 
GET /getinfo?color=White => generated 291 bytes in 64 msecs (HTTP/1.0 500) 
2 headers in 84 bytes (1 switches on core 0)

Solution

  • Run in development mode by setting the FLASK_ENV environment variable to development. Unhandled errors will show a stack trace in the terminal and the browser instead of a generic 500 error page.

    export FLASK_ENV=development  # use `set` on Windows
    flask run
    

    Prior to Flask 1.0, use FLASK_DEBUG=1 instead.

    If you're still using app.run (no longer recommended in Flask 0.11), pass debug=True.

    if __name__ == '__main__':
        app.run(debug=True)
    

    In production, you don't want to run your app in debug mode. Instead you should log the errors to a file.

    Flask uses the standard Python logging library can be configured to log errors. Insert the the following to have send Flask's log messages to a file.

    import logging
    handler = logging.FileHandler('/path/to/app.log')  # errors logged to this file
    handler.setLevel(logging.ERROR)  # only log errors and above
    app.logger.addHandler(handler)  # attach the handler to the app's logger
    

    Read more about the Python logging module. In particular you may want to change where errors are logged, or change the level to record more than just errors.

    Flask has documentation for configuring logging and handling errors.