Audit Log
Overview
Section titled “Overview”The Audit Log records every administrative action taken in the system—creating, updating, deleting, importing, exporting, and assigning resources. Use it for compliance, debugging, and accountability.
Log Table
Section titled “Log Table”Each entry shows:
| Column | Description |
|---|---|
| Timestamp | When the action occurred (displayed in your local timezone) |
| User | Email of the user who performed the action, or “System” for automated actions |
| Action | What was done (color-coded badge) |
| Entity Type | What type of resource was affected |
| Entity | Name or ID of the specific resource |
| Details | Eye icon to view full change details |
Action Colors
Section titled “Action Colors”| Action | Color | Description |
|---|---|---|
| Create | Green | A new resource was created |
| Update | Blue | An existing resource was modified |
| Delete | Red | A resource was removed |
| Import | Purple | Data was imported |
| Export | Orange | Data was exported |
| Assign | Cyan | A resource was assigned to a user |
| Unassign | Yellow | A resource was unassigned from a user |
Filtering
Section titled “Filtering”| Filter | Options |
|---|---|
| Search | User email, entity name, action, or entity type |
| Action | Filter by specific action type |
| Entity Type | Filter by resource type (voter, cut_list, user, template, settings, etc.) |
The page displays the most recent 500 entries. Use filters to find specific actions.
Viewing Details
Section titled “Viewing Details”Click the eye icon on any entry to see the full change record:
- Previous Values - What the resource looked like before the change
- New Values - What the resource looks like after the change
- Additional Details - Extra context about the action
Values are displayed as formatted JSON for easy comparison.
Common Use Cases
Section titled “Common Use Cases”Investigating Issues
Section titled “Investigating Issues”If a voter record looks wrong, search the audit log for that voter’s name to see all changes and who made them.
Monitoring Team Activity
Section titled “Monitoring Team Activity”Filter by action type “delete” to review any deletions, or by “export” to track data exports for security.
Compliance
Section titled “Compliance”The audit log provides a complete trail of who did what and when—essential for campaign compliance and data governance.
Best Practices
Section titled “Best Practices”- Review the audit log weekly for unexpected activity
- Investigate any bulk deletions or exports by unfamiliar users
- Use the log to verify that data imports completed correctly
- Reference audit entries when troubleshooting data discrepancies