View file transfer information

Use the File Tracking page to search for file tracking information and to view information about a file transfer including:

  • Export log statistics
  • Resubmitted or non-resubmitted transfers
  • MDN receipt information
  • Detailed status about a file transfer
  • History of a file transfer
  • Detailed status about an advanced route execution

The following topics provide how-to instructions for viewing and exporting file transfer information:

Related topics:

View and export log statistics about transferred files

Use the following procedure to view and export file transfer log statistics.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. Click Export Log to export the displayed file tracking data to a .csv file. You cannot export all the records from the database at one time.
  4. A dialog box is displayed asking whether you want to open the file or save it to disk.
  5. Specify whether to save the file or open the file, and then click OK.

Search file tracking information

Use the following procedure to search file tracking information.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. Specify the search criteria.
    1. In the Search for transfers pane, specify whether you want to search based on time the transfer started or completed and the time frame in which to search.
    2. (Optional) Specify the account or login associated with the transfer for which you are searching.
    3. (Optional) Specify whether to search for inbound or outbound transfers.
    4. (Optional) Specify whether you want to include successful transfers, transfers currently in progress, paused transfers, failed transfers, or failed subtransmissions. You can specify more than one.
  4. (Optional) Show the Advanced Search fields and specify additional search criteria.
    1. Specify the file name, class, site associated or Core ID with the transfer for which you are searching.
    2. Specify transfers initiated by the server or the user.
    3. Specify the protocols used for the transfers. You can use Control+click and Shift+click to select more than one.
    4. Specify whether the transfer was secure or non-secure.
    5. Specify whether the transfer was resubmitted or not resubmitted.
    6. Specify the application associated with the transfer. YOu can use Control + click and Shift + click to select more than one.
Note
Resubmitted files can be:
- the transfer that is resubmitted with the "Resubmit“ button or the REST API resource

Not Resubmitted files can be:
- the transfer that is NOT resubmitted with the "Resubmit“ button or the REST API resource;
- the transfer that is started from the Resubmit button or the REST API;
- the transfer that is without the Resubmit button.

4. When you have finished specifying your search criteria, click Search.

Note You can get the transferred file count by using REST API.

View MDN receipt information about a transfer

Use the following procedure to view MDN receipt information.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. To display MDN receipt information, click the MDN receipt icon for a specific transfer.
  4. The MDN Receipt dialog box is displayed. You can either view the MDN receipt or click Verify to view the MDN signature and file integrity check results. Clicking Close at the bottom of the MDN receipt closes the dialog box and returns you to the File Tracking page.
  5. If you click Verify to view the MDN signature and file integrity check results, a new page in the dialog box displays showing the verification status. Click Close or View to return to the MDN receipt.
Note An MDN receipt icon is displayed only when a receipt for the transfer is available in the system and the transfer was successful. To enable MDN receipts, see Certificates to generate during initial setup.

View the detailed status information about a transfer

Use the following procedure to view detailed status information.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. Click the status icon or the file name for a specific transfer.
  4. The Status Detail window is displayed.
  5. Click Close at the bottom of the details to return to the File Tracking page.

The Status Detail dialog box shows the following information:

Name Description
Status Displays the transfer status. Values include Processed, In Progress, Failed, Aborted, and Failed Subtransmission.
Time Displays the Transfer Start date and time and the duration of the transfer in milliseconds.
User Displays the Account name, login name, class type and user type.
Application Displays the application instance name.
Transfer

Displays the transfer type, transfer site name, file name, file size, transfer protocol, transfer mode, remote host name, remote folder name, account folder name, real file location, success or failure details, and protocol messages. At the bottom, there are three ID links:

  • Transfer ID - a unique identifier of a transfer in SecureTransport. It is used to track what happened to a file during a single transfer (e.g upload, download, push, pull).
  • Session ID - a session identifier in SecureTransport. It is used to track the file(s) during one or multiple transfers that happened in the same session.
  • Core ID - a unique file identifier in SecureTransport. It is generated the first time the file arrives in SecureTransport, and is stable throughout the lifespan of the file, even if its name changes. Core ID is used to track the file across different transfers and sessions. When you click on the Core ID value, SecureTransport refreshes the File Tracking page with the Core ID value pre-filled as a search criterion.
  • Note When transfers are performed by users behind a proxy or a load balancer, an additional parameter is listed: X-Forwarded-For. This is a dedicated HTTP header which is commonly used to identify the originating IP address of the user account and is especially useful when the user is behind a proxy or a load balancer. In such case, the Remote Host displays the IP address of the proxy/load balancer, and the X-Forwarded-For parameter displays the user's original IP address. Note that when the user is not behind a proxy/load balancer, the original IP address is displayed with the Remote Host parameter, and X-Forwarded-For is hidden from view.
Post
Transmission
Status
Displays the operation type, whether the operation whether the operation succeeded or failed, the result of the operation, and comments that can provide additional information, such as if a transformation was performed. Multiple operations might be displayed.
Note When a logged-in account does not have permission to delete files and tries to delete them, the Status Detail dialog box is not available.
If the file transfer includes encrypting or decrypting files, this information might be displayed in the success or failure details or the Post Transmission Status. For more information about encryption and decryption, see Encryption options.

The Status Detail for a server-initiated transfer shows the protocol messages as part of the transfer details. For HTTP transfers, the headers are provided since there are no commands sent. For AS2 transfers, messages are also generated from the HTTP headers.

View the file history details information about a transfer

Use the following procedure to view file history details.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. Click the name of a file to open the File History Details dialog box.
  4. The File History Details dialog box is displayed. Click Close at the bottom of the details to return to the File Tracking page.

The File History Details dialog box displays detailed information about tracked events. Tracked events include client-initiated and server-initiated file uploads and downloads, server-initiated transfer protocol messages, PGP encryption, routing a file from one account to another, post-transmission actions, and file deletion or renaming from a client-initiated command. PGP encryption information includes the compression type and level. For more information, see Encryption options.

Note When a logged in account does not have permission to delete files and tries to delete them, the File History Details dialog box is not available.

The File History Details dialog box displays a chronological list of detailed transfer statuses starting from the last client-initiated upload or server-initiated download and ending with the first renaming or deletion of the file with the same name. If the client-initiated upload or server-initiated download is missing because the file tracking log was rotated, the dialog box shows the first event for that file name.

The File History Details dialog box shows the following information:

Name Description
Status Displays the transfer status. Values include Processed, In Progress, Failed, Aborted, and Failed Subtransmission
Time Displays the Transfer Start date and time and the duration of the transfer in milliseconds
User Displays the Account name, login name, class type and user type
Application Displays the application instance name
Transfer Displays the transfer type, transfer site name, file name, file size, transfer protocol, transfer mode, remote host name, remote folder name, account folder name, real file location, Transfer ID link, Session ID link, Core ID link, success or failure details, and protocol messages. Protocol messages are displayed only when a server-initiated transfer is part of the file transfer history. If you are encrypting or decrypting files, this information is included in the success or failure details.
Post
Transmission
Status

Displays the operation type and if the operation was client-initiated (local) or server-initiated (remote), whether the operation succeeded or failed, the result of the operation, and comments that can provide additional information, such as if a transformation was performed.

View the detailed status information about an advanced route execution

Use the following procedure to view detailed status information about an advanced route execution.

  1. Select Operations > File Tracking.
  2. The File Tracking page is displayed.
  3. Click the status icon or the file name for a specific advanced route execution.
  4. The Status Detail window is displayed.
  5. Click Close at the bottom of the details to return to the File Tracking page.

The Status Detail dialog box shows the following information:

Name Description
Status Displays the transfer status. Values include Processed, In Progress, Failed, Aborted, and Failed Subtransmission.
Time Displays the Transfer Start date and time and the duration of the transfer in milliseconds.
User Displays the Account name, login name, class type and user type.
Application Displays the application instance name.
Transfer Displays the transfer type, transfer site name, file name, file size, transfer protocol, transfer mode, remote host name, remote folder name, account folder name, real file location, Transfer ID link, Session ID link, Core ID link, success or failure details, and protocol messages.
Post
Transmission
Status
Displays the operation type, whether the operation whether the operation succeeded or failed, the result of the operation, and comments that can provide additional information, such as if a transformation was performed. Multiple operations might be displayed.
Route Status Displays the operation type, whether the route succeeded or failed, the route package name, start and end times, duration, and the execution ID.
Note When a logged-in account does not have permission to delete files and tries to delete them, the Status Detail dialog box is not available.
If the file transfer includes encrypting or decrypting files, this information might be displayed in the success or failure details or the Post Transmission Status. For more information about encryption and decryption, see Encryption options.

The Session ID and Transfer ID listed in the Status Details dialog box and the File History Details dialog box are links you can use to view the server log entries for that session or transfer.

  • From either the Status Details dialog box or the File History Details dialog box, click the value of either the Transfer ID field or the Session ID field.
  • SecureTransport copies the Session ID or Transfer ID to the search criteria of the Server Log page and displays the results of the search.

Related Links