Audit Trail

Security event logging and compliance tracking.

Audit Trail Logs The Audit Trail interface showing security-relevant events and user actions.

Overview

Audit Trail records security-relevant events in your Simuzo installation, providing an audit log for compliance and troubleshooting.

Accessing Audit Trail

Navigate to Audit Trail in the Admin Panel.

Event Types

Audit Trail records:

CategoryEvents
AuthenticationLogin, logout, failed login attempts
User ManagementUser created, modified, deleted
Resource LimitsLimits changed, enabled, disabled
SettingsConfiguration changes
SystemService start/stop, errors

Filtering Logs

Filter by Tab

Search

Use the search box to find specific events or terms.

Time Range

View logs from different time periods based on your retention settings.

Log Format

Each log entry contains:

FieldDescription
TimestampWhen the event occurred
UserUsername that performed the action
TypeEvent category
DetailsAdditional event information
IP AddressSource IP of the request

Configuration

Configure Audit Trail in Settings → General:

Enable/Disable

Toggle Enable Audit Trail to turn logging on or off.

Retention Period

SettingDefaultRange
Retention Days77-365 days

Service Management

# Check service status
systemctl status simuzo-audit

# Start service
systemctl start simuzo-audit

# Stop service
systemctl stop simuzo-audit

# Restart service
systemctl restart simuzo-audit

Log Storage

Audit logs are stored at:

/var/simuzo/logs/audit.jsonl

Format is JSON Lines (one JSON object per line).

Disk Space Higher retention periods require more disk space. Monitor your log directory to ensure adequate storage.

Troubleshooting

Logs Not Being Recorded

  1. Check audit is enabled in Settings
  2. Verify service is running: systemctl status simuzo-audit
  3. Check log file permissions
  4. Review log file: tail /var/simuzo/logs/audit.jsonl

Service Won't Start

  1. Check configuration: /var/simuzo/conf/audit.conf
  2. Check disk space: df -h
  3. Review logs: journalctl -u simuzo-audit

Compliance

Audit Trail helps meet compliance requirements for:

Regular Review Periodically review audit logs to identify suspicious activity or policy violations.

Related Topics