Audit log¶
The audit log is your history book. Every time someone makes a change in the admin system — creating a product, editing a brand, deleting something — the system quietly writes down what happened, who did it, and when. Nobody types these entries by hand. They are recorded automatically and cannot be edited or removed. Think of it as a security camera for the admin area: it just watches and remembers.
You use this page to answer questions like "Who changed the price on this product last Tuesday?" or "When did this brand get deleted?"
How to open it¶
- Sign in to the admin system.
- In the left-hand menu, click Audit log.
- The page opens with the most recent changes at the top. The heading tells you the total number of entries on record.
That is all — there is nothing to switch on. The log is always running.
What you can do here¶
This page is read-only. You cannot change anything from here. You can only look at the history and narrow it down. Here is how.
Read the history of who changed what¶
- Look at the table. Each row is one change that someone made.
- Read it left to right:
- When tells you the date and time.
- Actor tells you the email address of the person who made the change.
- Action tells you the kind of change — for example create, update, or delete.
- Entity tells you what was changed — for example a product or a brand.
- Diff shows the exact details of the change (see the note below).
- Newer changes sit at the top. Scroll down to go further back in time.
What is a 'diff'?
"Diff" is short for difference. It is a small block of text that shows exactly what was altered — the old value and the new value. It is written in a technical format (called JSON) that looks like a list of labels and values inside curly brackets. You do not need to understand every symbol. Just read the words: they tell you which fields changed. If something looks wrong, copy this block into an email to the developers and they will read it for you.
Filter to find a specific change¶
Above the table there is a row of boxes. Fill in one or more, then click Filter. Leaving a box empty means "don't filter by this".
- Entity type — type the kind of thing you are looking for, such as
productorbrand. Use lower-case letters. - Action — type the kind of change, such as
create,update, ordelete. - Actor email contains — type part of a person's email address. You
do not need the whole address; a piece of it is enough. For example,
typing
ninafinds everyone whose email contains "nina". - Click the blue Filter button.
- The table refreshes and shows only the matching rows. To start over, clear the boxes and click Filter again.
The page shows 100 entries at a time
If a search has more than 100 results, only the first 100 appear. Add a filter to narrow things down and find what you need.
Every field explained¶
| Column | Plain-English meaning |
|---|---|
| When | The date and time the change was made, shown in your local time. |
| Actor | The email address of the person who made the change. A dash (-) means the system itself did it, with no human signed in. |
| Action | The type of change: create (something new was added), update (something existing was edited), or delete (something was removed). |
| Entity | What was changed. Shows the type (like product) and a short code that identifies the exact item. |
| Diff | The technical before-and-after detail of the change. Read the words to see which fields moved. |
Common mistakes¶
Watch out for these
- Typing capital letters in the filters. Use lower-case, e.g.
productnotProduct, or you may get no results. - Expecting to see reads, not just writes. The log records changes — creating, editing, deleting. It does not record someone simply looking at a page.
- Trying to edit or delete an entry. You cannot, and that is on purpose. An audit log you could change would be worthless.
- Assuming a dash in the Actor column is a bug. A dash just means the change was made automatically by the system, not by a person.
- Searching with several filters at once and getting nothing. The filters combine — a row must match all of them. Clear a box or two to widen the search.
Still stuck?
If something in the audit log does not make sense, or you spotted a change you cannot explain, email developers@kavelsoftware.se. Include the date and time of the entry and, if you can, copy the Diff block so they can see exactly what happened.