How to use activity logs to track sync operations
Monitor every sync cycle with activity logs. See what was inserted, updated, or removed, filter by automation or date, diagnose errors, and audit team changes
2sync's activity logs give you a complete record of every sync operation across all your automations. You can see exactly what was inserted, updated, removed, or unsynced, along with timestamps and error details. This guide covers how to read logs, filter them, and use them for troubleshooting.
What do activity logs show?
Every time a sync cycle runs, 2sync records what happened. The activity log displays:
| Log data | Description |
|---|---|
| Timestamp | Exact date and time of the sync operation |
| Automation | Which automation ran |
| Items inserted | New items created in Notion or the provider |
| Items updated | Existing items modified |
| Items removed | Items deleted or archived |
| Items unsynced | Items disconnected due to filter changes |
| Affected pages | Which Notion pages and provider items changed |
| Errors | Detailed error messages when something fails |
Each log entry links to the specific Notion pages and provider items that were affected, so you can verify changes directly.
How to access activity logs
- Go to app.2sync.com
- Click Activity in the sidebar
- Browse your sync history
The log shows the most recent operations first, with a summary of items affected per cycle.
How to filter activity logs
By automation
Select a specific automation from the dropdown to see only its sync history. Useful when troubleshooting a single automation.
By date range
Set start and end dates to narrow down to a specific time period. Helpful when investigating an issue that started on a known date.
Show or hide sensitive information
Toggle sensitive data visibility to control whether email addresses, event titles, and other personal information appear in the logs.
When sharing screenshots of activity logs with support, hide sensitive information first to protect your privacy.
Clear all logs
Use the clear option to remove all log entries. This does not affect your synced data, only the log history.
Clearing logs is irreversible. Export or screenshot important log entries before clearing.
When should you check activity logs?
Troubleshooting sync issues
If items aren't appearing where expected, the activity log shows whether the sync cycle ran, what it processed, and any errors encountered. Check the error details for specific failure reasons. See Sync problems for common issues and solutions.
Verifying data flow
After setting up a new automation or changing filters, review the next few sync cycles in the log. Confirm that the expected items are being inserted, updated, or ignored.
Auditing changes
For teams sharing a Notion database, activity logs provide an audit trail. See who synced what and when, which is valuable for tracking down unexpected changes. This is especially useful with shared connections.
After filter changes
When you modify filters on an existing automation, check the logs to see how many items were unsynced or newly included. This confirms your filters are working as intended.
Combine activity logs with Sync item statuses for a complete picture. Activity logs show what happened during each cycle. Sync Status on each Notion page shows the current state of that item (Synced, Ignored, or Removed).
How to read error entries
Error entries in the log include:
- Error type: Connection failure, permission issue, rate limit, or data conflict
- Affected item: Which specific item failed to sync
- Error message: Technical details explaining the failure
- Suggested action: In most cases, a hint about how to resolve the issue
Common errors and their meanings:
| Error | Meaning | Action |
|---|---|---|
| Connection expired | OAuth token needs renewal | Reconnect the affected account. See Connection issues |
| Permission denied | 2sync lost access to a database | Re-grant access in Notion |
| Rate limited | Too many API requests | Wait for the next sync cycle. See Rate limits |
| Conflict | Item modified in both places simultaneously | Check the item and resolve manually. See Conflict resolution |
What are the best practices?
- Check logs after every configuration change to verify expected behavior. New filters, field mapping changes, and sync direction updates all show their effects in the logs immediately.
- Use date range filters to focus on relevant time periods when troubleshooting. Searching through weeks of logs wastes time.
- Review error patterns: Repeated errors often indicate a configuration issue rather than a one-time glitch; for example, a recurring "Permission denied" means the Notion access was revoked, not just a temporary hiccup.
- Hide sensitive information before sharing logs with others or with 2sync support.
- Don't clear logs unless necessary: Historical data helps diagnose recurring problems. Once cleared, it cannot be recovered.
- Map Sync Status to a Notion property for item-level visibility. See Sync item statuses.
What should I do next?
- Troubleshoot common sync problems
- Fix connection issues
- Understand sync item statuses
- Learn how conflict resolution works
- Review rate limits and retries
Related
- Sync problems for common sync issues and solutions
- Connection issues for fixing expired or broken connections
- Sync item statuses for monitoring item-level sync states in Notion
- Conflict resolution for how 2sync handles simultaneous edits
- Rate limits and retries for API rate limits and retry behavior
- Filters for controlling what syncs with conditions
- Shared connections for team member access for shared automations
- Error codes for the complete error reference
FAQ
How long are activity logs retained?
Activity logs are retained as long as your account is active. You can clear them manually at any time, but there is no automatic expiration.
Do activity logs count against my sync limits?
No. Activity logs are a monitoring feature and do not consume automation slots or affect sync frequency.
Can I export activity logs?
Currently, activity logs are viewable in the 2sync dashboard. Screenshot or copy the information you need for external records.
Why does the log show zero items processed?
A sync cycle with zero items means nothing changed since the last cycle. This is normal and indicates your data is already in sync.
Can team members see each other's activity logs?
Each user sees logs for their own automations. Shared connections may show activity from automations created by team members using your connection.
What does 'unsynced' mean in the activity log?
Unsynced items are Notion pages or provider items that were previously linked to an automation but no longer match its filters. They remain in place but are no longer managed by the automation.
How do I share activity logs with 2sync support?
Toggle off sensitive information in the activity log, then take a screenshot or copy the relevant entries. This protects your privacy while giving support the details they need.
Can I get notified when an error occurs?
Activity logs are currently available in the dashboard only. Check the logs periodically or after configuration changes. Map Sync Status to your Notion database to see item-level issues without opening the dashboard.
Can I sync Todoist's activity log to Notion?
There is no direct way to pull Todoist's activity log into Notion. However, you can map the Completed At field to a Date property in Notion, which lets you track when tasks were finished and build your own stats.