Event History Viewer: How It Works¶
Audience: end users. See also: Event History Viewer (Backend) and Adding Event History to Pages for technical details.
What Is the Event History Viewer?¶
The Event History Viewer lets you see a complete timeline of every change made to an item in the system. Think of it as a detailed audit log that shows:
- What changed - The type of action taken
- When it changed - Timestamp of each change
- Who made the change - The user responsible
- The details - The actual data that was modified
Where to Find It¶
The Event History is available on most detail pages in Foundry. Look for the "Event History" button in the page header:
| Page | What You'll See |
|---|---|
| Fixtures | All changes to match details, lineups, scores |
| Competitions | Competition setup and configuration changes |
| Teams | Team name, branding, and roster changes |
| Participants | Player profile and stats updates |
| Seasons | Season configuration changes |
| Venues | Venue details and updates |
| Users | Account and permission changes |
How It Works¶
flowchart LR
A["Click 'Event History'<br/>button"] --> B["Side panel<br/>slides open"]
B --> C["Events load<br/>from system"]
C --> D["Browse and<br/>search events"]
D --> E["Click event<br/>for details"]Step 1: Open the Panel¶
Click the Event History button on any detail page. A panel slides in from the right side of the screen.
Step 2: Browse Events¶
Events are listed with the most recent at the top. Each entry shows: - Event Type - What kind of change occurred (e.g., "LineupSet", "ScoreUpdated") - Version - The sequence number of the change - Timestamp - When the change happened - User - Who made the change
Step 3: Search and Filter¶
Use the search box to find specific events by: - Event type name - User name - Version number - Any text in the event data
Step 4: View Details¶
Click any event to open a detailed view showing: - Full event metadata (ID, timestamp, version) - All data fields that were changed - Raw JSON data (for technical users)
Key Features¶
| Feature | Description |
|---|---|
| Search | Filter events by typing any keyword |
| Download | Export the full event history as a JSON file |
| Refresh | Reload to see the latest events |
| Navigation | Use Previous/Next buttons to move between events |
| Copy IDs | Click to copy event or aggregate IDs to clipboard |
Common Use Cases¶
Debugging Issues¶
"Why does this fixture show the wrong score?" - Open Event History on the fixture - Look for score-related events - See what value was set and when
Auditing Changes¶
"Who changed the team lineup before the match?" - Open Event History on the fixture - Search for "Lineup" events - Check the user and timestamp
Understanding Data Flow¶
"How did this player's stats get updated?" - Open Event History on the participant - Review the sequence of events - See the progression of changes
What the Events Tell You¶
Events follow a naming pattern that describes what happened:
| Event Name Pattern | Meaning |
|---|---|
...Created |
A new item was added |
...Updated |
An existing item was modified |
...Set |
A value was assigned |
...Removed |
Something was deleted |
...Started |
A process began |
...Completed |
A process finished |
Examples:
- CricketLineupSetEvent - A cricket lineup was saved
- ScoreUpdatedEvent - A match score was changed
- ParticipantCreatedEvent - A new player was added
Tips¶
- Start with recent events - The panel shows newest first, so recent changes are at the top
- Use search - Don't scroll through hundreds of events; search for what you need
- Check the user - If something looks wrong, the user field tells you who made the change
- Download for analysis - Export to JSON if you need to investigate offline or share with support
Questions?¶
If you find unexpected events or need help interpreting the history, contact the Support team.