The WooCommerce Subscriptions extension and subscriptions with WooCommerce Payments create a number of WooCommerce logs to record errors and other events. Recording these events can be important, especially when an issue occurs and the cause must be investigated. These logs record histories of different events that can provide clues as to the cause and repercussions of an issue. Below is a list of the logs that the subscription functionality create and modify.
Logs can be found on the dashboard of a site. To view the logs:
- Go to WooCommerce > Status
- Click on the Logs tab
- Choose a log from the drop-down
Log names will begin with the given labels, but will sometimes then have a date and a string of letters and numbers, called a hash, added to them. This is to ensure that each log has a unique name and is not overwritten.
Error Logs
↑ Back to topFailed Status Change Logs
↑ Back to topThis log is labeled wcs-update-status-failures. This log records when there has been an error when updating the status of a subscription.
Example log entry:
Failed Scheduled Action Logs
↑ Back to topThis log is labeled failed-scheduled-actions. This log records when a scheduled action has failed. It will contain information such as the scheduled action’s name and ID, how long it was attempted, and the arguments.
Example log entry:
Failed PayPal IPN Logs
↑ Back to topThis labeled wcs-ipn-failures. This log records fatal errors that occur while a PayPal IPN is being processed when using PayPal with the WooCommerce Subscriptions extension. These error messages will contain info such as a stack trace for where the error occurred.
Example log entry:
PayPal Logs
↑ Back to topThis log is labeled paypal. Subscriptions does not generate this log – it’s created by WooCommerce core – but it adds to it. This log records PayPal Standard IPNs, the actions taken with them, and errors
Example log entry:
Upgrade Logs
↑ Back to topWhen subscriptions code base is upgraded to a new version, for example, from version 2.4.7 to 2.5.0, it records some information about the upgrade process in a variety of logs.
General Upgrade Notes Logs
↑ Back to topThis log records during upgrades and contains:
- Timestamp of when the upgrade occurred
- Version of Subscriptions being updated to
- Old version of Subscriptions updated from
- WooCommerce version during this upgrade
- WooCommerce database version
- Environment info, which includes WordPress version
- Info about active plugins, such as name, author, and version
The information in this log is automatically deleted after eight weeks. This log is labeled wcs-upgrade.
Example log entry:
