> For the complete documentation index, see [llms.txt](https://mango-5m.gitbook.io/mango5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mango-5m.gitbook.io/mango5m-docs/resources/mango-admin/features/audit-log.md).

# Audit Log

Every staff action, who did it and to whom.

One line per action, colour-coded by category, filterable by category or by person, and searchable. Click a line to copy it.

| Category                  | Covers                                                                                   |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| Bans / Kicks / Moderation | Removals and lifted bans                                                                 |
| Reports                   | Opened, closed, reopened, people added                                                   |
| Player                    | Heal, freeze, inventory, money                                                           |
| Teleport                  | Go to and bring                                                                          |
| World                     | Weather and time                                                                         |
| Server                    | Resources started, stopped, restarted                                                    |
| Staff                     | Roles created, changed, assigned                                                         |
| Honeypots                 | Every decoy that was tripped, with its evidence                                          |
| Entities                  | Spawn limits warned on and blocked                                                       |
| Watchdog                  | Every stop, restart and recovery of the panel, and what the guard held while it was down |
| Join / leave              | Sessions, if `logSessions`                                                               |
| Kills / deaths            | If `logDeaths`                                                                           |

## Keeping it

{% code title="shared/config/dashboard.lua" %}

```lua
Config.Audit = {
    persistent    = false,   -- false: memory only, starts fresh each restart
    retentionDays = 14,
    maxEntries    = 5000,
    logSessions   = true,
    logDeaths     = true,
}
```

{% endcode %}

## Lines the panel did not witness

Some lines carry a **WATCHDOG** tag. Those happened while the panel was stopped: the guard saw them, held them, and handed them over when the panel came back. The timestamp on them is **when it happened**, not when it arrived — so without the tag the record would quietly claim the panel saw something it was not running for.

The tag travels with the copied line too, since those get pasted into tickets where a chip does not.

{% hint style="success" %}
**The log survives a restart of the panel** even with `persistent = false`. The watchdog keeps a rolling copy and gives it back, merged and deduplicated. See [While the Panel Is Down](/mango5m-docs/resources/mango-admin/resource-protection/while-the-panel-is-down.md).
{% endhint %}