Pushrow includes a comprehensive logging system that records all sync operations. Use the logs to monitor activity, verify successful syncs, and troubleshoot any issues.
Accessing Logs
Navigate to Pushrow → Logs to view the sync log. Each log entry includes:
- Type: Export, import, real-time sync, scheduled, or error.
- Job: The associated sync job (if applicable).
- Status: Success or Error.
- Rows Processed: Number of rows handled.
- Errors: Count of any errors during the operation.
- Duration: How long the sync took in seconds.
- Message: A human-readable description of what happened.
- Date: When the operation occurred.
Filtering Logs
Use the filter options to narrow down log entries by:
- Type: Show only exports, imports, or real-time syncs.
- Status: Filter by success or error.
- Date Range: View logs from a specific time period.
Log Retention
Pushrow automatically maintains log retention by keeping the 30 most recent entries per job. A daily cleanup cron job handles this automatically. You can also manually clear all logs using the Clear Logs button.
Common Issues and Solutions
Google Account Not Connected
If you see errors about authentication, go to Pushrow → Settings and verify your Google account is connected. You may need to reconnect if your access token has expired.
No Data Exported
Check that your filters are not too restrictive. Try running a test with broader filters to verify data is available. Also ensure the selected provider’s plugin is active (e.g., WooCommerce for order data).
Scheduled Sync Not Running
WordPress cron requires site visits to trigger. On low-traffic sites, consider setting up a real system cron job or using a service like WP-Cron.com. Installing Action Scheduler (included with WooCommerce) also improves reliability.
API Quota Exceeded
Google Sheets API has usage limits. If you hit quota errors, reduce sync frequency or increase the time between scheduled runs.
Sync Taking Too Long
For large datasets, use the bulk processing feature and consider increasing the chunk size. Ensure your server has adequate memory and execution time limits.
Debug Report
For advanced troubleshooting, Pushrow provides a debug report accessible via REST API at GET /wp-json/pushrow/v1/debug-report. This includes your plugin version, PHP version, WordPress version, active providers, scheduled crons, and recent logs.