How to Audit User Actions and Login Logs

Intro

As a super-admin, you have full visibility into every significant user action and login attempt across your clubs. The Audit Logs page gives you a searchable, time-stamped record of who did what and when. This guide walks you through accessing, filtering, and navigating the logs so you can quickly investigate issues, track changes, and ensure accountability.

Prerequisites

• A super-admin account (role super-admin; this feature is not available to other roles).
• Access to the BallersBook platform.
• At least one recorded action or login event generated by users in your clubs.

Step-by-Step

1. Log in to your BallersBook account with a super-admin user.
2. Open the main navigation sidebar and click Admin to expand the super‑admin menu.
3. Click Audit Logs to open the log browser. (If you don’t see this option, your account may not have super‑admin privileges.)
4. The page displays a table of log entries. Each row shows the Timestamp, User, Action, Target, Club, and IP Address.
5. To search for a specific user or action, locate the Search field at the top of the table. Type a user’s email, partial name, or action keyword (e.g., login, session.create, drill.delete) and press Enter or click the Search icon. The table filters in real time.
6. To narrow results by date range, use the From and To date pickers above the search bar. Select a start and end date, then click Apply Filter.
7. Browse through multiple pages of logs using the Previous and Next buttons at the bottom of the table. The page number and total pages are displayed between the buttons.
8. Click any Timestamp link to open a detailed view of that log entry. A modal appears showing the full payload, including request metadata and any error messages.
9. To export the current filtered log list as a CSV, click the Export CSV button in the top‑right corner of the page. The file downloads automatically.

💡 Tip: Use the action keyword filter to quickly find all changes made by a specific operation, such as finance.invoice.paid or player.move.group.

Tips & Pitfalls

• Logs older than 90 days are automatically archived. Use the Archive link in the sidebar to access historical logs (restored to the audit database).
• Avoid over‑broad searches. Use specific keywords or date ranges to keep results manageable.
• If you see an action from a user who no longer belongs to your club, it may have been performed before their membership ended. Check the timestamp.
• The export CSV includes all visible columns; if you have applied a search filter, only the filtered results are exported.

Summary

With the Audit Logs page, you can quickly search, filter, and paginate through thousands of user actions and login events. Use the search bar for keyword lookups, date pickers for time‑based views, and the export button to save reports. Regularly reviewing logs helps you monitor unusual activity and maintain a secure platform. Next, explore the Global Preferences section to adjust audit retention settings.