Purpose
Beyond the audit trail of actions performed in the Logsign user interface, Logsign also records what happens at the operating-system level on the Logsign host itself: account and privilege changes, edits to sensitive configuration files, package installations, interactive commands, and system power state changes. These records are produced by the Logsign maintenance service from the host's own auditd trail and are indexed as Logsign Audit events.
This article lists those events so they can be searched, reported on and alarmed on.
Where these logs appear
The records arrive under the Logsign Audit source (EventSource Prefix ID 4016), with Event.Type set to Audit and Event.Category set to host-audit. You can list them with:
DataType:"system" AND Event.Category:"host-audit"
Each event also carries a numeric Event.VendorID from the table below, and an Event.SystemID formed by prefixing that VendorID with the source prefix (for example VendorID 202623 becomes SystemID 4016202623).
Fields
| Source.UserName | The login user accountable for the action (the audit login UID), not the effective account it ran as. |
| Source.EffectiveUser | Written only when the action ran as a different account than the login user (for example a user escalating to root through sudo). In that case the event note also ends with "(as root)". |
| Source.Command | The executed command line, for command events. Values that look like passwords, tokens or API keys are redacted before indexing. |
| Source.Path | The file the action touched, for configuration-change events. |
| Source.KeyName | The audit rule key that matched, for events produced by a keyed audit rule. |
| Destination.UserName / Destination.GroupName | The user or group the action was performed on, for identity events. |
| Time.Generated | Taken from the audit record itself, not from the moment the event was forwarded. |
Event list
| Event.VendorID | Event.Action | EventMap (Context / Type / SubType) | Severity | Description |
| 202601 | user add | Identity / User / Add | notice | An OS user account was created on the host. |
| 202602 | user delete | Identity / User / Delete | warning | An OS user account was deleted on the host. |
| 202603 | user grant | Identity / User / Grant | warning | An OS user was granted privilege or added to a privileged group. |
| 202604 | group add | Identity / Group / Add | notice | A user was added to an OS group. |
| 202605 | password change | Identity / Password / Change | warning | An OS user password or lock state was changed. |
| 202606 | group create | Identity / Group / Create | notice | An OS group was created on the host. |
| 202607 | group delete | Identity / Group / Delete | warning | An OS group was deleted on the host. |
| 202608 | sudoers change | System / Configuration / Update | warning | The sudoers privilege configuration was modified. |
| 202609 | cron change | System / Configuration / Update | warning | A cron or scheduled task configuration was modified. |
| 202610 | systemd change | System / Configuration / Update | warning | A systemd unit was created or modified. |
| 202611 | sshd config change | System / Configuration / Update | warning | The SSH server configuration was modified. |
| 202612 | network change | System / Configuration / Update | warning | A host network configuration file was modified. |
| 202613 | audit config change | System / Configuration / Update | warning | The auditd configuration was modified. |
| 202614 | time change | System / Configuration / Update | warning | The system time or timezone configuration was modified. |
| 202615 | command executed | System / Command / Info | information | An interactive command was executed on the host. |
| 202616 | kernel module | System / Configuration / Change | warning | A kernel module was loaded or unloaded, or its configuration changed. |
| 202617 | pam change | System / Configuration / Update | warning | A PAM authentication configuration file was modified. |
| 202618 | library path change | System / Configuration / Update | warning | A dynamic linker path or preload configuration was modified. |
| 202619 | shell init change | System / Configuration / Update | notice | A shell init or environment configuration was modified. |
| 202620 | ssh key change | System / Configuration / Update | warning | A root SSH key or authorized_keys file was modified. |
| 202621 | mount config change | System / Configuration / Update | warning | The filesystem mount table (fstab) was modified. |
| 202622 | package change | System / Application / Install | warning | A software package was installed, removed or upgraded. |
| 202623 | system boot | System / State / Start | information | The host completed system boot. |
| 202624 | system shutdown | System / State / Shutdown | notice | The host was powered off cleanly. |
| 202625 | system reboot | System / State / Reboot | notice | The host was restarted cleanly. |
| 202626 | unexpected shutdown | System / State / Error | critical | The host started without a recorded shutdown: power loss, hard reset or crash. |
How boot, shutdown and reboot are decided
The operating system records a shutdown entry when a clean stop begins and a boot entry early in the next start. Logsign reads both and turns them into the events above:
- A recorded clean stop becomes either system reboot or system shutdown, decided from the shutdown target the system logged at that moment (a restart target produces a reboot event, a power-off or halt target produces a shutdown event).
- Every start produces a system boot event.
- A start with no clean stop recorded since the previous start produces an unexpected shutdown event, marked critical. This is what a power loss, a hard reset or a crash looks like from the host's point of view.
Because a shutdown can only be reported once the machine is running again, the shutdown and reboot events are emitted after the next boot. They still carry the real time of the shutdown in Time.Generated, so the ordering on a timeline is correct.
Notes and Limits
- The very first boot Logsign observes on a host never raises an unexpected shutdown; there is no earlier state to compare it against.
- Login-time and MOTD helper processes are excluded from the command executed events, so the command history reflects what an operator actually typed rather than what runs automatically on every SSH login.
- These events describe the Logsign host's own operating system. Operating-system auditing of your other servers is a separate integration; see the Linux logging model articles.
- Alarms are not shipped for these events by default. To be notified, create an alert on the VendorID or EventMap values above and attach an action rule to it, as described in the system notification articles.