Event log
The Event log is the record of who did what in your workspace, when, and in which part of Complaia. When something was edited, the entry also shows which fields changed, with the value before and after. Entries are written automatically. Nobody can edit or delete them, and they are deleted automatically after a fixed time.
Where to find it: System → Event log
When you'll use it
- Someone asks "who changed this order, and when?"
- A number looks wrong and you want to see what happened before it went wrong.
- Something "disappeared" and you want to know whether it was deleted, and by whom.
- You need to show that a named person did an operation.
- You want to see everything one account did, for example after a password reset.
Key concepts
What is recorded
Complaia records changes and sign-ins. Opening a screen and looking at it leaves no entry.
Every entry tells you:
| Part | What it tells you |
|---|---|
| The sentence | What happened, in plain words, for example that a user was created or an order's status changed. |
| Module | The part of Complaia where it happened: Orders, Users, Warehouse, Finance and so on. |
| Action | The kind of event: Created, Updated, Deleted, Login, Logout, Status change, Password change, or the general Action. |
| Who | The person's name and login. Things Complaia did by itself are signed System. |
| When | The time, and the exact date and time in the details. |
| Changes | For an edit, each changed field with its value before and after. An entry about a new record lists the Recorded data. An entry about a deletion lists the State before deletion. |
Severity
Each entry has one of three levels: Info, Warning or Critical. You do not set it. The kind of event decides. For example, deleting a role that people had is Critical. Warning and Critical entries have a coloured label in the list. Info entries have none.
How long entries are kept
| Severity | Kept for |
|---|---|
| Info | 365 days |
| Warning | 365 days |
| Critical | 730 days |
Older entries are deleted automatically. The same rule is stated at the bottom of the list. There is no setting to keep entries longer, and no archive. If you need to prove something for longer, save it outside Complaia before the entry is deleted.
The language of entries
Entries are shown in your interface language. A colleague who works in another language sees the same entry in their language.
Search is the exception. The search box looks through two things:
- the name of the record, for example an order number or a product name;
- the entry text in the system language, not in your language.
This means:
- searching for an order number or a product name works for everyone;
- searching for a word from the sentence works only in the system language.
The screen
At the top is a toolbar. Below it is the list of entries, newest first, grouped by day.
📷 Screenshot to add: the Event log with the toolbar, the Filters panel open, and one entry expanded to show its changes
The toolbar:
| Control | What it does |
|---|---|
| Search box | Shows entries whose text or record name contains what you type. |
| Date range list | All time, Today, Last 7 days, Last 30 days, Year to date or Custom range. Custom range opens the filters panel, where you set the dates. |
| Filters | Opens and closes the filters panel. A number on the button shows how many of its filters are in use. |
| Live | While it is on, new entries appear at the top of the list as they happen, without reloading. With filters set, only new entries that match them are added. Switch it off to stop the list from moving while you read. |
The filters panel:
| Filter | What it narrows the list to |
|---|---|
| Module | One or more parts of Complaia. Each option shows how many entries it has. |
| Action type | One or more kinds of event. |
| Users | One or more people. |
| Severity (level) | Info, Warning or Critical, one or more. |
| Entry type | All entries, or Only field changes, which means entries that show a value before and after. |
| From / To | A date range. |
Filters combine. Each one narrows what the others left. When the panel is closed, the filters in use are shown as small labels under the toolbar. Click the cross on a label to remove that filter, or click Clear filters to remove all of them.
The list. Each day has a heading. Once all entries of that day are loaded, the heading also shows how many there are. Each entry shows:
- the time and the person's initials;
- the sentence;
- the person, the module and the action;
- the number of changed fields, when the entry has values before and after;
- a severity label, when it is not Info.
Click an entry to open it. You see the changed fields first. Below them are the details: Who, Module, Action, Object (the record concerned), Date, IP address and Entry ID. The copy button next to the entry ID copies it, for example for a support ticket.
The list loads 50 entries at a time. More entries load as you scroll down, or when you click Load 50 more entries. A counter shows how many are loaded out of the total.
Common tasks
Find out who changed a record
- Type the record's number or name in the search box: an order number, a product name, a user's name.
- Click Filters. Under Module, choose the part of Complaia the record belongs to.
- Set Entry type to Only field changes.
- Read down the list. Each entry names the person. Click an entry to see the fields they changed, before and after.
Reconstruct a day
- In the date range list, choose Today. For another day, choose Custom range and set From and To to that day.
- Click Filters and choose the Module you are interested in.
- Leave Severity (level) empty at first. The entry that explains a problem is often an ordinary one just before the warning.
See everything one person did
- Click Filters and choose the person under Users.
- Narrow the dates if needed.
You get the same result from Employee activity: the link at the bottom of a person's card opens the Event log filtered to that person.
Check whether something was deleted
- Type the record's name or number in the search box.
- Click Filters. Under Action type, choose Deleted.
If the record was deleted, the entry says who did it and when, and State before deletion shows what it contained. If the list is empty and the date is within the keeping time, the record was probably never saved under that name.
Watch what is happening right now
- Clear the filters, or set only the Module you want to watch.
- Make sure Live is on.
New entries appear at the top as people work.
When it doesn't work
| What you see | Why | What to do |
|---|---|---|
| Event log is not in your menu | Your role does not have the Event log: View permission. | Ask whoever manages roles. |
| No logs with No entry matches the selected filters. | The filters are too narrow, or you searched for a word in a language other than the system language. | Click Clear filters, set the date range to All time and start again. Search for the record's name or number, not for a word from the sentence. |
| You cannot find an entry from more than a year ago | It was deleted. Info and Warning entries are kept for 365 days, Critical entries for 730 days. | Nothing can bring it back. |
| The list stops although there is more | Only 50 entries load at a time. | Scroll down, or click Load 50 more entries. Better: narrow the filters. |
| New entries stopped appearing | Live is off, or your filters exclude them. | Switch Live on, and clear the filters. |
| An entry has no values before and after | The event changed no fields, for example a sign-in. | Set Entry type to Only field changes when you want edits only. |
| The person is shown as System | Complaia did it by itself, for example when it blocked accounts after a plan change left more accounts than seats. | Nothing to fix. |
| You want to correct or remove an entry | Nobody can edit the log. | Correct the record itself. That correction is logged too. |
Permissions
| To do this | You need |
|---|---|
| Open the Event log and read all entries | Event log: View |
| Open a person's entries from Employee activity | Event log: View |
| Edit or delete an entry, or change how long entries are kept | Not possible for anyone |
This permission shows what everybody did in the whole workspace, including people more senior than the person who has it. Give it only to the people who need to investigate problems. Of the roles that come with the workspace, only the Owner and the Administrator have it.
Without it, a person with access to Employee activity still sees the last three actions on each card there, but cannot open the full log.
Related
- Employee activity — who is signed in now, and their most recent actions
- Users — a user's sign-in attempts, successful and failed
- Roles & permissions — where the Event log: View permission is given
- Company details — the system language that search depends on
- Glossary — audit log, in one paragraph
- Support — reporting a problem, with what you found here as evidence