Audit Trail
The Audit Trail is a record of meaningful actions taken inside OTS Signs — sign-ins, uploads, permission changes, role grants, settings changes, and so on. It’s the answer to “who did this and when?”.
Where to find it: sidebar → Admin group → Audit Trail.
What gets recorded
Section titled “What gets recorded”The audit trail captures application-level events. Each entry has:
- Time — when it happened (your local time zone in the table).
- Actor — who did it.
- Action — what category of event it was (see below).
- Resource — what was acted on (for example, a layout, a user, a folder permission).
- IP Address — where the request came from.
Common action categories include:
| Category | Examples |
|---|---|
| login | Successful and failed sign-ins. |
| upload | Media upload completed or failed. |
| media | Media item deleted. |
| folder_permission | Folder access granted or revoked. |
| user | User created, updated, deactivated. |
| role | Role granted to or revoked from a user or group. |
| settings | A customer-wide setting changed. |
The action column uses color-coded badges so you can spot patterns at a glance — blue for sign-ins, green for content uploads, purple for permission changes, amber for role changes, and so on.
Filters
Section titled “Filters”A filter bar sits above the table:
| Filter | What it does |
|---|---|
| From | Show only entries from this date and time onward. |
| To | Show only entries up to this date and time. |
| Actor | Search by actor name. Updates as you type. |
| Action | Pick a specific action (for example, role.granted) or leave at “All actions”. |
Filters apply immediately and can be combined. Pagination resets to the first page whenever you change a filter.
Pagination
Section titled “Pagination”Entries are returned 50 at a time. Use the Previous and Next buttons at the bottom of the page to move through the results. The total entry count and current page position are shown next to the pagination controls.
Exporting
Section titled “Exporting”Use the Export CSV button at the top of the page (next to the filters) to download the current filtered result set — up to 10,000 rows — as a CSV file. The file is named with today’s date so multiple exports don’t overwrite each other.
The export includes time, actor, action, item, item ID, and IP address. It does not include extra system details attached to each entry.
How long entries are kept
Section titled “How long entries are kept”Entries are kept for as long as the Audit log retention setting in Access Management → Settings allows. The default is 365 days; the minimum is 30. Once an entry passes the retention window, it is removed automatically and can’t be recovered. Export anything you need to keep for longer.
Common tasks
Section titled “Common tasks””Who deleted this layout?”
Section titled “”Who deleted this layout?””Filter by action media.deleted (or the layout-related action) and search for the layout name in the actor column or scan the resource column for the matching ID.
”Has anyone been granted Admin in the last week?”
Section titled “”Has anyone been granted Admin in the last week?””Set From to seven days ago, leave To blank, and set Action to role.granted. Look for entries where the resource is the Admin role.
”I think someone is signing in from an unusual location”
Section titled “”I think someone is signing in from an unusual location””Filter on login.success for the user in question and look at the IP Address column over a few days. Anomalies tend to stand out.
”I need a record for compliance”
Section titled “”I need a record for compliance””Set the date range you need, leave other filters at their defaults, and click Export CSV. Store the file with your other compliance records — the in-app audit log will eventually age out.
See also
Section titled “See also”- Access Management — where the retention setting lives.
- Reports — for content-playback statistics rather than user actions.