Files.com supports extensive logging to track user activity, file activity, site-level administrative actions, remote server activity, automation run logs, and more. These logs can be accessed using our CLI app.

Settings Changes

Retrieve the settings changes log using the following command option:

files-cli settings-changes list

User Activity

To retrieve the information in the user activity history log, use the following commands.

First, use this command to list the users and capture the USER-ID of the user that you want to target:

files-cli users list

Then, use this command to retrieve the log information of the specified user (making sure to replace <USER-ID> with the numeric ID returned from the prior command above):

files-cli histories list-for-user --user-id <USER-ID>

Folder Activity

To retrieve the folder activity history log, use the following command option:

files-cli histories list-for-folder --path path/to/folder

FTP Logs

To retrieve the FTP logs, use the following command:

files-cli ftp-action-logs list

SFTP Logs

To retrieve the SFTP logs, use the following command:

files-cli sftp-action-logs list

AS2 Logs

To retrieve the information in the AS2 Transmissions logs, use the following commands.

Use this command to list the Incoming AS2 transmissions:

files-cli as2-incoming-messages list

Use this command to list the Outgoing AS2 transmissions:

files-cli as2-outgoing-messages list

External Events

To retrieve the information in the external events log, use the following command.

files-cli external-events list

Webhook Logs

To retrieve the information in the webhook activity log, use the following commands.

First, use this command to create the log export, and capture the ID of the export:

files-cli action-notification-exports create --start-at "2022-07-01T08:00:00Z" --end-at "2022-07-08T17:30:00Z"

Then, use this command to access the Webhook Activity log of the specified export (making sure to replace <ID> with the correct ID returned from the prior command above):

files-cli action-notification-export-results list --action-notification-export-id <ID>

Automation Run Logs

To retrieve the information in the automation activity log, use the following commands.

First, use this command to list the automations, and capture the ID of the automation that you want to target:

files-cli automations list

Then, use this command to access the Automation Activity log of the specified automation (making sure to replace <ID> with the correct ID returned from the prior command above):

files-cli automation-runs list --automation-id <ID>

If you need the detailed information for each step of the automation, then use the STATUS_MESSAGES_URL that was returned in the above command, and retrieve the details from it using a web browser or a GET web request.

Share Links Usage

To retrieve the information in the share link usage log, use the following commands.

First, use this command to list the Share Links (bundles) and capture the ID of the Share Link (bundle) that you want to target:

files-cli bundles list

Then, use this command to access the Share Link (bundle) access log of the specified Share Link (making sure to replace <ID> with the correct ID returned from the prior command above):

files-cli bundle-downloads list --bundle-id <ID>

Inbox Usage

To retrieve the information in the inbox usage log, use the following commands.

First, use this command to list the Inboxes (folder behavior of the type inbox) and capture the ID of the Inbox (behavior) that you want to target:

files-cli behaviors list --behavior inbox

Then, use this command to access the Inbox (behavior) access log of the specified Inbox (making sure to replace <ID> with the correct ID returned from the prior command above):

files-cli inbox-uploads list --inbox-id <ID>

Inbox Registrations

To retrieve the information in the inbox registrations log, use the following commands.

First, use this command to list the Inboxes (folder behavior of the type inbox) and capture the ID of the Inbox (behavior) that you want to target:

files-cli behaviors list --behavior inbox

Then, use this command to access the Inbox Registrations log of the specified Inbox (making sure to replace <ID> with the correct ID returned from the prior command above):

files-cli inbox-registrations list --folder-behavior-id <ID>

Inbound Emails

To retrieve the inbound emails information, use the following command:

files-cli email-incoming-messages list

Outbound Emails

To retrieve the outbound emails information, use the following command:

files-cli email-logs list

Site Usage

To retrieve the site usage information use the following command:

files-cli usage-snapshots list

API Logs

To retrieve the API logs, use the following command:

files-cli api-request-logs list