What the Activity Log records, and how long it keeps it
The Activity Log records actions people take in your Laramin, their sign-ins and sign-outs, and the sessions open right now. Learn what each entry holds, what isn't recorded, who can read it, how long it's kept, and how it differs from the security log and Activities.
- Applies to
- Activity Log 1.2 and later
- Who can do this
- Platform owner, Administrator
On this page
In short
The Activity Log is an automatic record of what happens in your Laramin. You read it when you need to know who did something, and when. It has three lists:
- User Activities: actions people took, such as creating, changing or deleting a record.
- Login Activities: each sign-in, and the sign-out that ended it.
- Visitor Activities: the sessions open right now, for signed-in people and for guests.
Nobody writes these entries by hand, and people can't edit them. They hold personal data, such as IP addresses, so only give access to people who need it.
How it works
What an entry holds
Each entry in User Activities and Login Activities records:
- when it happened (Recorded On, or Login),
- who did it (User). An action with nobody signed in, such as a scheduled task, shows System,
- what happened, in a sentence (Activity), and the kind of action (Event), such as Create, Update, Delete, Login or Logout,
- a Status: Success, Error, Warning, Info or Others,
- the record it was about, as its type and number, for example
User #42, - the changes, when the screen passes them, for example
Status: Draft → Active, - the request: the person's IP Address, the full page address (URL) and the page they came from (Referrer), the Request Method, and their browser, its version, the operating system (Platform), the device and the User Agent,
- the Workspace context and Team context they were working in. The names are stored as they were at the time, so renaming a workspace later doesn't change old entries.
When someone is signed in as another person, the entry is recorded under the person they're signed in as, and the operator's name is added in Raw Data.
What's recorded
Laramin records the actions that each screen chooses to record. With Core and the usual modules, that includes:
- sign-ins with a password, with two-factor authentication, or through a social sign-in, and sign-outs,
- creating, changing, restoring and deleting users, and deleting them for good,
- signing in as another user, and when that ends,
- trusting and revoking devices, blocked IP addresses, and expired or revoked API tokens,
- changes recorded by the modules you install, such as Menu Manager saving a sidebar, or Roles & Permissions changing a role.
What isn't recorded
- Failed sign-ins. They go to the security log instead.
- Settings changes made in the Settings hub.
- Changes on screens that don't record them. Not every list records what you create, change or delete on it. Many of Laramin's own lists, such as Currency in Master Settings, record nothing when you add, edit or delete a record, one at a time or in bulk. Lists whose module records its own changes do.
- Pages people look at. Only the last page of each open session shows, in Visitor Activities.
- Deleting entries and ending sessions from these lists.
Personal data, and what's hidden
Entries store the values a screen passes as they were, including names, email addresses and phone numbers. Laramin replaces the value of any field that looks like a secret with ******** before it stores the entry: passwords, tokens, secrets, API keys, client IDs, private keys, card numbers, CVV codes and similar.
Visitor Activities holds a session's IP address, user agent and last page, for guests as well as for signed-in people.
How long entries are kept
| List | Kept for |
|---|---|
| User Activities and Login Activities | 365 days by default. Laramin deletes older entries once a week. You can change the number of days. See Delete entries and choose how long they're kept. |
| Visitor Activities | About as long as the session. A session ends when its owner signs out, or after it's been idle for the session lifetime, 60 minutes by default. Laramin clears ended sessions from time to time. |
Entries also stay in any database backup made while they existed.
Careful: When a person's account is deleted and anonymized, their entries stay in the Activity Log until they're older than the retention period. Their old name can still appear in the Activity sentence, for example "Ravi Kumar Logged in.", with their IP addresses and devices. The data download people can request doesn't include their entries either. To remove them sooner, delete them by hand. See Delete entries and choose how long they're kept.
Who can read it
The lists are in the Platform Administration sidebar, under Activity Logs. Each list has its own permissions:
| List | View | Delete one | Delete several | Export |
|---|---|---|---|---|
| User Activities | feature. | feature. | feature. | feature. |
| Login Activities | feature. | feature. | feature. | feature. |
| Visitor Activities | feature. | feature. | feature. | feature. |
Terminate Session (feature.) signs a person out of another device. In Visitor Activities, the delete permissions end guests' sessions, and ending a signed-in person's session needs Terminate Session. Super admins have every permission. Nobody else does until a role gives it to them. See Give someone a role.
The lists aren't limited to the workspace you're working in. Anyone who can view a list sees entries from every workspace.
Some screens in other modules show a record's history from the Activity Log, such as a role's History tab in Roles & Permissions. Those need View User Activity (feature.).
How it relates to
| Activity Log | Security log | Activities module | |
|---|---|---|---|
| What it holds | Actions people took, sign-ins and sign-outs, open sessions. | Failed sign-ins, IP addresses blocked automatically, monitoring alerts, untrusted host names. | Calls, meetings and notes people chose to write down, on tasks. |
| Written by | Laramin, automatically. | Laramin, automatically. | People. |
| Where you read it | Activity Logs in the sidebar. | A file you download from Security settings. | Activities › History, and a task's Activity tab. |
| Kept for | 365 days by default. | 90 days. | Until someone deletes it. |
See Security settings for the security log and Tasks, queues and activity history explained for Activities.
Next steps
Thanks. That helps us decide what to write next.
Thanks for telling us what was missing.
You already answered for this article today. Thanks.
We got a lot of answers from your network just now. Try again in a few minutes.
We couldn't send that. Check your connection and try again.
Links in this article
Printed from help.bsscn.com. The online article may have changed since.