History


Files.com maintains a comprehensive audit log of who, what, when, where and how your files are modified. This makes it easy to see exactly who is reading, changing, or deleting your files. Users who are logged in to the site and have the appropriate permissions will be able to see the logs and history. Note that by default the history page will show results for the last 7 days.

What is Logged

To access the history, type "History" in the search bar at the top of each page, and then click the matching result. The table below explains the information included in each history log entry. Some of the columns are optional and not displayed by default. You can click on the Columns button to change the display.

COLUMN NAMEDETAILS
DateThe date and time the action occurred, displayed in the time zone of the current user.
UserThe user who performed the action.
ActionThe specific action that was taken (ex: Login, Login failure, File created, File updated etc.,).
DescriptionThe description of the action that was taken, and the file or folder or the user the action was taken on.
File PathFull path of the file in case the action taken was on a file.
Folder PathFull path of the folder in case the action taken was on a file or folder.
Copy/Move SourceFull path of the folder in case the action taken was a Move or Copy.
Copy/Move DestinationFull path of the folder in case the action taken was a Move or Copy.
Failure TypeDetails of the failure in case there was a failure with the action and the reason is known.
IPThe IP address that the user connected from when performing this action.
InterfaceThe interface through which the user performed the action (Web, API, AS2, Email, Desktop, Mobile, Office, Remote, SCIM, FTP, SFTP, WebDAV, Robot).

Actions

Files.com logs all actions related to the creation, deletion, and update of Users, Groups, Files, API keys, and Permissions. We also logs Login activity, such as successful logins and failed logins to your site.

For files and folders, we log additional actions such as below.

Files and Folders Actions typeDetails
ReadDownloads and file previews.
CreatedUploads, creation of new folders, or files.
UpdatedChanges made to the content of files, including the overwriting of existing files.
DeletedDeletes, including automatic expiry of files.
CopiedFile copy operations.
MovedFile move operations, including file or folder renames.

Filters

You can apply filters to narrow down your log view. For example, you can filter the logs to display only certain actions performed by a specific user on a particular date. Additionally, you can limit the results to a specific IP address. The available filter options include Start Date and End Date, Action, User, Folder Path, File Path, IP, and Interface.

Folder History

To view the history for a particular folder, you can either filter the History logs by Folder Path or navigate directly to that folder from All Files and click the File history button. Here, you will see a record of each action that has been taken within this folder since its creation.

File History

To view the history for a single file, you can either filter the History logs by File Path or, from the file browser, click on the ellipsis (...) button in the Actions column and select History. Here, you will see a record of each action that has been performed on this file since it was uploaded.

User History

To view the complete activity log for an individual user, you can either filter the History logs by User or navigate to User Accounts, select the user, edit their settings, and then choose the History tab. Here, you will see a record of each action taken by this user from the time their account was created.

Exporting History

You can export the audit logs by clicking Export button on the History page or you can export the same logs directly from your File browser by clicking Export history.

Exporting User Activity History

You can download the activity log history for a specific user or for all the users on your site.

To download the activity log for a specific user, navigate to User Accounts, select the user, edit their settings, and then choose the History tab. Click the Export button.

Exporting User Login History

To download the user login activity log for all the users on your site, go to the users page by typing "Manage Users" in the search box at the top of every page, and then clicking on the first result. Click the Export login history button to start the download. Select a starting and ending date range and the file format for the exported history.

All types of exported history files have fields for When, Who, What, IP, and Interface information. These fields can be searched and filtered in your spreadsheet application.

Interface as Robot in Logs

If you see a history entry with Interface listed as Robot, that means that the file action was performed by to an Automation or File Expiration behavior (folder setting) configured on your Site.

Duplicate Entries in Logs

You may notice multiple simultaneous log entries for files being created or read that appear to be duplicates. These are caused by certain third party clients which make multiple requests for the same file, usually to implement concurrency or retries. We plan to eventually improve our history logging to automatically merge such duplicate entries that occur within a 10 minute period, but we haven't released that capability yet.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.

Start My Free Trial

©2024 Files.com. All right reserved

FILES.COM

  • Start My Free Trial
  • Pricing
  • Docs
  • API and SDKs
  • Contact

CONTACT & SUPPORT

support@files.com

(800) 286-8372

Monday–Friday

9am–8pm Eastern