Skip to content
fDeploy Documentation

Audit Log

The audit log (Configuration → Audit Log) records every state-changing action on fDeploy entities — projects, project groups, environments, targets, variables, deployment processes, releases, deployments, users, teams, and server settings. Each entry captures who (username + user id), what (action + entity type + entity name), when (timestamp), where from (IP address), and — for updates — a before/after diff of the changed fields. Only users with the System Administrator role can view the log.

Audit log

Filtering

The log can be filtered by entity type, by username (free-text match), and by date range (Today / Last 7 days / Last 30 days, or a custom start-and-end range). Filters compose — selecting a user and an entity type narrows to that user’s activity against that entity type.

Diff viewer

Expanding an Updated entry opens a side-by-side diff with word-level highlighting — additions in green, removals in red. Only the fields that actually changed are shown, so diffs for small edits stay readable. Created and Deleted entries don’t produce diffs; their raw details are rendered as formatted text instead.

Usernames persist after user deletion

The User field is a captured string, not a foreign key. Deleting a user account does not modify or remove any of their historical audit entries — the original username remains recorded exactly as it was at the time of the action. This is a deliberate choice so that historical accountability survives user lifecycle events.

Archival

To keep the database lean, entries older than 90 days are archived automatically:

  • A background worker runs once every 24 hours.
  • Entries older than 90 days are exported to compressed .jsonl.gz files (one file per day, named like audit-log-archive-2026-04-10.jsonl.gz) and then deleted from the database.
  • Archive files live on the fDeploy Server machine at [InstallDir]/Archives/AuditLog/.

Archives can be downloaded or manually deleted from the View Archives area. Deleting an archive is permanent — once an archive is deleted, those entries are unrecoverable.