Downloading Logs

App Engine maintains a log of messages that your application emits using the `logging` module from the Python standard library, as well as other messages printed to the standard error stream. App Engine also records each request in the log. Each log severity level has a fixed buffer size that controls the amount of log information you can access. Normally, you use logging features more at lower log levels; thus, the time window is smaller for log events at these levels. Each request logged is assigned a request ID, a globally unique identifier based on the request's start time.

To browse your app's logs of the last 90 days, you can also use the Logs page in the Cloud Platform Console.

Requesting the logs

If you wish to perform more detailed analysis of your application's logs, you can download the log data to a file on your computer. The appcfg.py request_logs command is available through the original App Engine SDK for Python.

To download logs to a file named mylogs.txt, use the following command:

appcfg.py request_logs [DIRECTORY_PATH] mylogs.txt

To view all of the options for this command, run:

appcfg.py help request_logs

By default, the command downloads log messages from the current calendar day, which starts at midnight Pacific Time. The default log severity level is INFO, which also includes logs for all higher levels but omits DEBUG level messages. The command overwrites the local log file. You can adjust the number of days, the minimum log level, and whether to overwrite or append to the local log file using command-line options.

You can limit the log messages that are downloaded to just those emitted during request on a given domain name using the --vhost=... option. You can use this to download the logs for your live app using a Google Apps domain or http://your_app_id.appspot.com, excluding log messages emitted by versions you are testing on URLs such as http://2.latest.your_app_id.appspot.com. Or you can use it to download just the log messages for a given test domain.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

App Engine standard environment for Python