Project Audit Log

The Audit Log tab (/project/library/:id/audit-log) maintains an immutable, chronological ledger of every mutation, creation, update, and deletion within the project workspace.

Project Audit Log table showing event timestamps, actor emails, merged event types, resource IDs, and payload inspector

1. Audit Trail Architecture

Every state change in Omnismith—from entity field updates and schema modifications to role assignments—generates an immutable audit event captured in an append-only audit ledger:

Actor Attribution: Tracks whether changes were initiated by a specific user email (e.g. [email protected]) or an internal automated system process.
Microsecond Precision: Precise timestamps logging when events occurred.
Resource Identification: Direct UUID links to the modified template, attribute, entity, dashboard, or user.

2. Searching & Filtering Audit Events

The audit control bar provides granular search and filtering tools:

Keyword Search: Search across actor emails, resource UUIDs, and event names.
Date Range Picker: Restrict audit records to specific date intervals (e.g., Last 7 Days, Custom Range).
Resource Categories: Filter by resource type (e.g. Entity, Template, Attribute, Dashboard, Automation, Role, Project).
Action Types: Filter by event verb (e.g. Created, Updated, Deleted, Assigned, Revoked).

3. Payload Inspector Drawer

Clicking Inspect Payload on any audit log entry opens a full JSON payload inspector modal, displaying:

Before & After Values: Field-level diffs showing exactly what values changed.
IP Address & User Agent: Network origin of the API request.
Contextual Metadata: Request ID, tenant UUID, and client headers.

{
  "event_type": "entity.updated",
  "resource_id": "019d028b-f521-76ca-90d0-af0a975f6b93",
  "author_email": "[email protected]",
  "changes": {
    "cpu_usage": {
      "previous": 42.5,
      "current": 89.1
    },
    "operational_status": {
      "previous": "Healthy",
      "current": "Degraded"
    }
  }
}