Reading the Sync Logs
Review synchronisation history and diagnose issues using BuddyActivity's detailed log output.
Every time BuddyActivity runs a sync — whether automatic or manual — it writes a detailed log entry. The Sync Logs are your primary tool for understanding what happened, diagnosing failures, and verifying that activities were created as expected.
Viewing the Sync Logs
- Go to BuddyActivity → Sync Logs.
- The logs are listed in reverse-chronological order — most recent at the top.
- Click on a log entry to expand it and see the full details for that sync run.
Log Levels
| Level | Meaning |
|---|---|
info | A normal, expected event — sync started, row processed successfully, sync completed. |
warning | Something unexpected happened but the sync continued — e.g., a row was skipped due to a missing optional field. |
error | A row failed to process. The error message explains why. The sync continues with remaining rows. |
critical | A fatal error stopped the entire sync — e.g., authentication failure, Google Sheets API unreachable. |
What to Look For
A healthy sync log will show:
- A "Sync started" info message at the top.
- One "Processed row [ID]" info message per row that was handled.
- A "Sync completed" info message at the end with a count of rows processed, skipped, and failed.
If you see error messages, expand the log entry to read the full error. Common errors are covered in the Troubleshooting Failed Jobs article.
Log Retention
By default, BuddyActivity keeps the last 30 days of sync logs. Older logs are automatically purged to keep the database tidy. You can change the retention period in BuddyActivity → Settings → Log Retention.
Exporting Logs
You can export the sync logs as a CSV file from BuddyActivity → Sync Logs → Export. This is useful for sharing logs with support or keeping an offline audit trail.