Appearance
Audit Logs
Audit Logs provide a complete, non-editable history of administrative actions and platform events in InsightMaps. Every significant action is recorded with timestamp, user, and details for security monitoring, troubleshooting, and accountability.
Overview
Audit Log Capabilities:
- Complete activity tracking: Every admin action logged
- Advanced filtering: Entity type, action, date range, quick presets
- Detail view: Click any log entry to see full details with before/after values
- Related activity: View other actions on the same entity
- Summary statistics: Real-time counts for total logs, today's activity, errors, and active users
- CSV export: Download filtered logs for external analysis
- URL state sync: Filters persist in the URL for bookmarking and sharing
Access Audit Logs
Location: InsightMaps Console > Audit Logs
How to Open:
- Log in to console.insightmaps.app
- Navigate to Audit Logs in left sidebar
- Audit log table and filters appear
Permission Required: Admin role
Understanding Audit Log Entries
Log Entry Fields
Each audit log entry contains:
| Field | Description | Example |
|---|---|---|
| Timestamp | When the action occurred | Shown as relative time (e.g., "2 hours ago") with full date on hover |
| User | Who performed the action | [email protected] (or "System" for automated actions) |
| Action | What was done | CREATE, UPDATE, DELETE, LOGIN, PUBLISH |
| Entity Type | What was affected | user, category, layer, service, settings |
| Entity ID | Specific item identifier | Numeric ID |
| IP Address | Source IP (desktop view) | 203.45.123.89 |
| Old Values | Previous state (JSON) | Field values before the change |
| New Values | New state (JSON) | Field values after the change |
Entity Types
| Entity Type | Description |
|---|---|
| Auth | Authentication events (login, logout) |
| User | User management actions |
| Category | Category creation, editing, publishing |
| Layer | Layer configuration changes |
| Service | Data source connections and sync |
| Preset View | Saved views and bookmarks |
| Settings | System settings modifications |
Action Types
Authentication:
- LOGIN: Successful user login
- LOGIN_FAILED: Failed login attempt
- LOGOUT: User logout
- SIGNUP: New user registration
- OAUTH_LOGIN: OAuth authentication (Google, GitHub)
Data Management:
- CREATE: New item created
- UPDATE: Configuration changed
- DELETE: Item removed
- PUBLISH: Category or layer published
- UNPUBLISH: Category or layer hidden
- SET_DEFAULT: Default setting changed
Service Operations:
- DISCOVER: Service discovery executed
- SYNC: Service metadata synchronized
- BULK_SYNC: Multiple services synchronized
- IMPORT_LAYERS: Layers imported from file
Bulk Operations:
- BULK_ASSIGN: Bulk layer assignment
- BULK_UPDATE: Bulk configuration changes
- BULK_DELETE: Multiple items deleted
- DELETE_ALL: All items in a category deleted
- DELETE_ACCOUNT: User self-deleted their account
Filtering Audit Logs
Filter by Entity Type
- Click the Entity Type filter dropdown
- Select a type (Auth, User, Category, Layer, Service, Preset View, Settings)
- The log table updates to show only matching entries
- Select "All Types" to clear the filter
Filter by Action
- Click the Action filter dropdown
- Select an action (LOGIN, CREATE, UPDATE, DELETE, PUBLISH, etc.)
- The log table updates to show only matching entries
Filter by Date Range
- Set From Date using the date picker
- Set To Date using the date picker
- Logs are filtered to the specified range
- Clear dates to show all time periods
Quick Filter Presets
Four quick filter buttons are available above the log table:
| Preset | What It Shows |
|---|---|
| Today | Logs from the current date |
| Errors | Failed login attempts (LOGIN_FAILED) |
| Auth | Authentication entity type logs only |
| Deletions | DELETE action logs only |
Each preset is toggleable — clicking again clears the filter. Presets are available on both desktop and mobile.
Combine Filters
Filters can be combined for precise queries:
- "Failed logins today": Entity Type = Auth + Action = LOGIN_FAILED + Preset = Today
- "Layer publishing this month": Entity Type = Layer + Action = PUBLISH + Date Range = this month
- "All bulk operations": Action = BULK_DELETE or BULK_SYNC
Active Filter Indicators
- Active filters appear as dismissible badges below the filter bar
- Click the X on a badge to remove that filter
- "Clear all filters" button removes all active filters
URL State Synchronization
All filter values sync to URL query parameters (entityType, action, fromDate, toDate, page, pageSize). This allows bookmarking filtered views and sharing links with other administrators.
Audit Log Detail View
Clicking the View button on a log entry (or the eye icon on mobile) opens a detail dialog with complete information.
Core Information
- Full action name with color-coded badge
- Entity type and entity ID
- Precise timestamp
- Username and user ID
- IP address
- User agent (browser/device information)
Change Details
The detail view displays changes differently based on the action type:
UPDATE actions (old and new values exist):
- A changes table showing each modified attribute with:
- Attribute name
- Previous value (highlighted in red)
- New value (highlighted in green)
- Change type: added, removed, or modified
CREATE actions (new values only):
- "Created With" section showing the initial field values as formatted JSON
DELETE actions (old values only):
- "Deleted Data" section showing the removed field values as formatted JSON
BULK_SYNC actions:
- Special display with summary cards:
- Total services count
- Succeeded count (green)
- Failed count (red)
- Total layers synced (blue)
- Failed services table with Service ID, Service Name, and error details
Related Activity
Below the change details, the dialog shows up to 5 related log entries for the same entity. Each related entry shows:
- Action badge
- Username
- Relative timestamp
- Click to navigate to that log entry
Summary Statistics
Four summary cards appear at the top of the Audit Logs page (hidden on mobile):
| Card | Description |
|---|---|
| Total Logs | Total count of logs matching current filters |
| Today | Count of logs created today |
| Errors/Deletes | Count of DELETE actions and LOGIN_FAILED events |
| Active Users | Count of unique users in the current page |
Pagination
Page Size
Choose from three page sizes:
- 20 items per page (default)
- 50 items per page
- 100 items per page
Navigation Controls
Desktop:
- First page, Previous, Next, Last page buttons
- "Page X of Y" indicator
- "Showing X-Y of Z" summary text
Mobile:
- Previous and Next buttons
- Summary text showing range and total
Exporting Audit Logs
CSV Export
- Apply desired filters to narrow the results
- Click the Export CSV button (Download icon)
- A CSV file downloads automatically
CSV Filename: audit-logs-[YYYY-MM-DD].csv
CSV Columns: Timestamp, User, Action, Entity Type, Entity ID, IP Address, User Agent, Old Values, New Values
Note: The export includes the current page of filtered results. For large exports, use date range filters to export in monthly batches.
Permission: Export requires admin permissions and is disabled in demo mode.
Log Table Display
Desktop View
A full table with columns:
- Timestamp — Relative time with full date tooltip
- User — Username or "System"
- Action — Color-coded badge (green for create, blue for update, red for delete, violet/amber for auth, cyan for sync)
- Entity — Entity type and ID (clickable to filter by type)
- IP Address — Shown on larger screens, with user agent tooltip
- Details — "View" button (only if the entry has change data)
Mobile View
A card-based layout showing:
- Action badge and timestamp
- User and entity information
- Eye icon to open detail dialog
Troubleshooting
"Audit logs not showing recent events"
Causes:
- Filters too restrictive
- Date range excludes today
- Page not refreshed
Solutions:
- Clear all filters using the "Clear all" button
- Verify date range includes the current date
- Refresh the page
"Cannot export audit logs"
Causes:
- Insufficient permissions
- Demo mode active
Solutions:
- Verify you have admin permissions
- Export is disabled in demo mode
"Missing expected log entry"
Causes:
- Active filters hiding the entry
- Action did not complete successfully
- Viewing a different page
Solutions:
- Clear all filters
- Verify the action actually completed
- Check other pages using pagination
Integration with Other Console Features
Works With
User Management:
- View all actions by a specific user
- Track role changes and account modifications
- Monitor login history
Data Sources:
- Track service discovery and sync operations
- Review layer publishing history
Settings:
- Log all system configuration changes
- Track default basemap and theme changes
Summary
Audit Logs provide accountability and visibility:
- Complete Tracking: Every admin action logged with user, timestamp, and details
- Advanced Filtering: Entity type, action, date range, and quick presets
- Detail View: Full before/after change comparison with related activity
- Summary Statistics: Real-time counts for total logs, today's events, errors, and active users
- CSV Export: Download filtered logs for compliance and analysis
- URL Bookmarking: Filter state persists in the URL for sharing
Key Points:
- Review failed login attempts regularly for security
- Use quick filter presets for common audit tasks
- Export logs periodically for long-term archival
- Click "View" on any entry to see the full change details
- All logs are non-editable and non-deletable for integrity