Accessing Logs

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.

Retrieve the settings changes log using the following command option:

files-cli settings-changes list

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>

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

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

To retrieve the FTP logs, use the following command:

files-cli ftp-action-logs list

To retrieve the SFTP logs, use the following command:

files-cli sftp-action-logs list

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

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

files-cli external-events list

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>

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.

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>

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>

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>

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

files-cli email-incoming-messages list

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

files-cli email-logs list

To retrieve the site usage information use the following command:

files-cli usage-snapshots list

To retrieve the API logs, use the following command:

files-cli api-request-logs list