Skip to content

Security Audit Trail & System Log Integration ​

Cockpit maintains an immutable audit log of administrative actions, authentication attempts, and system configuration changes. The audit trail provides compliance tracking and supports security diagnostics.


Audited Events ​

The security subsystem logs the following events:

  • Authentication: Successful logins, logouts, password modifications, authentication failures, and account lockouts.
  • Virtual Machine Lifecycle: Provisioning, deletion, power state changes, resource scaling, and live migrations.
  • Resource Configuration: Creating network bridges, formatting storage datastores, and registering physical hosts.
  • Access Control Changes: Creating user accounts, altering group memberships, and assigning scoped permissions.

Log Entry Schema ​

Each audit log entry contains structured metadata to record the context of the event:

  • Timestamp: High-precision UTC timestamp (conforming to ISO 8601) indicating when the event occurred.
  • Subject: The username and origin IP address of the administrator who executed the command.
  • Action: The action identifier (e.g., VM_POWER_OFF, USER_CREATED).
  • Object: The unique identifier (UUID) and name of the target resource (e.g., VM sales-reporting-app).
  • Status: The outcome of the action (success, failure with error details, or blocked due to insufficient permissions).

SIEM and Syslog Forwarding ​

For enterprise compliance and centralized security analysis, Cockpit can forward audit logs in real-time to external Security Information and Event Management (SIEM) systems (such as Splunk or Elasticsearch).

Configuring Syslog Forwarding: ​

  1. Log into the Cockpit console with administrative credentials.
  2. Navigate to Settings > System > Syslog Forwarding.
  3. Select Add Forwarding Target.
  4. Configure the destination properties:
    • Host: The IP address or hostname of the syslog collector.
    • Protocol: Select UDP, TCP, or TLS (TLS is recommended to encrypt log payloads in transit).
    • Port: Typically 514 for standard syslog traffic, or a custom port defined by your security team.
    • Format: Select RFC 5424 (structured syslog format) or JSON format.
  5. Save the configuration to initialize real-time log streaming.