File Tracking

SecureTransport records information about the file transfers that it processes in the so-called transfer log and displays it on the File Tracking page. This page is available on SecureTransport Server only and accessible by choosing Operations > File Tracking.

Every time you open the File Tracking page, SecureTransport automatically loads the transfer log entries for the past hour. This behavior is determined by the FileTracking.InitialLoading.Enabled.Admin server configuration option. It accepts boolean values, and the default value is true. To disable the initial auto-loading of log entries on the page, set the value to false.

Customize your view of the File Tracking table

You can view details about the file transfers in the File Tracking table. By default, it contains the following columns:

  • Resubmit: When possible, SecureTransport shows a Resubmit button using which you can retry a failed transfer or resubmit a successful incoming one. See Resubmit transfers.
  • MDN Receipt. See View MDN receipt information about a transfer.
  • Transfer status: By clicking the transfer status icon, you can see more detailed status information, including the location of the file (Real File Location). You will be able to view more comprehensive information about the transfer if you are using Axway Sentinel. See Transfer statuses.
  • Account and Login name
  • Note For PeSIT transfers initiated by a partner, the Login column shows the name of the PeSIT transfer site that represents the partner.
  • Direction of the transfer (inbound or outbound)
  • Whether the transfer is initiated by the user or the server (Action by column)
  • Details about the transferred file: name of the file (File), bytes transferred, and protocol used
  • Note For all PeSIT transfers, the File column shows the name of the transfer profile used, and the name of the file is displayed in the Local filename column, which is not shown in the table by default.
  • Start time and duration of the transfer

The File Tracking table can additionally show the following transfer details:

  • Transfer site name. See Transfer sites.
  • Remote partner: the remote account name (for pluggable transfer sites only)
  • Transfer profile (PeSIT only). See Transfer profiles.
  • Remote folder: For client-initiated transfers, this is the local account directory where the file is uploaded. For server-initiated transfers, this is the remote directory.
  • Local name of the transferred file

To modify which columns are displayed in the File Tracking table, click Change Columns. Select or clear the check boxes for the columns you want to show or hide. Then, click the Save Preference button to save your customized view. Preferences are saved for the currently logged in administrator. The changes take immediate effect.

Consolidated view of all information about a transfer

Caution   This feature is currently in Beta. It is not production-ready and must never be used in a production environment. See Beta features.

Instead of creating an individual log entry for each failed resubmit and retry of the same server-initiated transfer, SecureTransport can be configured to log all the records with the same CycleID in a single entry. This entry gets updated for each retry - the Transfer Log shows information for the most recent attempt, and the Status Details box contains all the retry and resubmit attempts with the most recent on top.

To enable this functionality, set the configuration option FileTracking.ShowLatestStatusOnly.Enabled to true.

Search file tracking information

Use the following procedure to search for file tracking information.

  1. Select Operations > File Tracking.
  2. On the File Tracking page, specify the search criteria.
    1. In the Search for transfers pane, specify whether you want to search based on the time the transfer started or was completed and the time frame in which to search.
    2. (Optional) Specify the account or login associated with the transfer you are searching for.
    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.
  3. (Optional) Show the Advanced Search fields and specify additional search criteria.
    1. Specify the file name, class, site, Core ID, remote partner, transfer profile, remote folder, or local filename associated with the transfer you are searching for.
    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 whether the PeSIT transfer was positively acknowledged (ACK), negatively acknowledged (NACK), or not acknowledged at all. If all three options are selected, the search displays all PeSIT transfers.
    7. Specify the application associated with the transfer. You can use Control+click and Shift+click to select more than one.

4. When ready, click Search.

File Tracking specifics

  • In a Standard Cluster, the File Tracking page on the primary server in the cluster provides a consolidated view of the transfer data. See Consolidated log data representation.
  • Due to protocol specifics, when a user pauses or resumes a client-initiated transfer, two entries are recorded on the File Tracking page for the interrupted transfer. The entries have the following characteristics:
  • HTTP CIT: The log entry for the portion of the file uploaded before the transfer was paused is marked as failed and a Resubmit button is not displayed. The second entry - for the portion of the file uploaded after the transfer is resumed - is marked as successful and a Resubmit button is displayed.
  • FTP/SSH CIT: The log entry for the portion of the file uploaded before the transfer was paused is marked as successful and a Resubmit button is displayed. The second log entry - for the portion of the file uploaded after the transfer is resumed - is marked as successful and a Resubmit button is displayed.
  • The CycleId of the original transfer is preserved when retrying or resubmitting failed server-initiated transfers. For more information, see CycleId calculation.

The following topics provide information on viewing and managing file transfer activity:

Related Links