Audit Logs

Every compliance-relevant action in Privacy Labs is written to an immutable audit log. Each entry is SHA-256 hashed, making any after-the-fact modification detectable. The log cannot be edited or selectively deleted through the dashboard.

Navigate to: Admin Dashboard > Data & Audit

Log Categories

Every entry belongs to one of five categories. You can filter by category from the dashboard.

CategoryEvents covered
AUTHENTICATIONUser login, logout, failed login attempts, password changes, session creation and revocation.
DATA_ACCESSEvery read or write to consent records, DSR requests, grievances, and data discovery scan results.
SECURITYSecurity alerts triggered, sessions revoked, suspicious IP activity, threat and violation events.
SYSTEMBanner settings updated, cookie categories modified, integration changes, scan triggered, webhook configured.
COMPLIANCEDSR status changes, escalations, privacy policy published, breach incident created or progressed, RoPA changes.

Severity Levels

LOW

Routine events with no risk. Example: user logs in successfully.

MEDIUM

Notable events worth monitoring. Example: banner settings changed.

HIGH

Events requiring attention. Example: failed login attempts, SLA-breached DSR.

CRITICAL

Immediate action required. Example: breach incident detected, critical unencrypted PII found.

Log Entry Format

FieldDescription
timestampISO 8601 timestamp.
actionEvent type string. Example: CONSENT_GIVEN, DSR_CREATED, BANNER_UPDATED.
userIdInternal ID of the user or system actor that performed the action.
userEmailEmail of the actor.
categoryAUTHENTICATION, DATA_ACCESS, SECURITY, SYSTEM, or COMPLIANCE.
severityLOW, MEDIUM, HIGH, or CRITICAL.
successBoolean. Whether the action succeeded or failed.
detailsAdditional context as a key-value map. Example: old/new values for config changes, request type for DSR events.
userAgentBrowser or SDK user-agent string, when available.
IP address is not stored in audit log entries (unreliable with VPN/proxies). User identity is tracked via userId and userEmail.

Filtering Logs

The audit log viewer auto-refreshes every 10 seconds. Filter to narrow down entries:

Date range Category Severity Search (action / email / details)

Default view shows the last 7 days. Use a custom date range for historical audits.

Exporting Logs

Export from the audit log viewer with your active filters applied. Two formats:

CSV

Spreadsheet-compatible. Useful for sharing with legal counsel, auditors, or loading into external tools. File is named audit-export-YYYY-MM-DD.csv.

JSON

Machine-readable. Suitable for SIEM ingestion or programmatic processing. File is named audit-export-YYYY-MM-DD.json.

Export is available to ADMIN and DPO roles only. AUDITOR role can view logs in the dashboard but cannot export.

Log Retention

Tamper-proof, configurable retention

Each entry is SHA-256 hashed at write time. The hash makes any modification to a log record detectable. Entries cannot be edited or deleted individually through the dashboard. The overall retention window (how long logs are kept before being purged) is configured in your organisation settings.

Sharing with Auditors

Grant external auditors read-only access via the AUDITOR role:

  • Invite the auditor from Admin Dashboard > Team & Settings > Team Management
  • Assign them the AUDITOR role
  • AUDITOR sees a read-only view of logs, compliance reports, and DSR history
  • Remove the user or change their role to revoke access