Start a PI to CONNECT data transfer

Save PDF

Last UpdatedDec 05, 2025
4 minute read

Once you create a data transfer, you can start the transfer. During the transfer, events are sent asynchronously. Historical events are sent first, followed by current events. Data is transferred from on-premises to CONNECT every 30 seconds or for every 50,000 events, whichever occurs first.

To start a data transfer:

In the navigation rail, select Data connections. Then select Agents.
Select the PI to CONNECT Agent associated with the data transfer.
(Optional) In the Manage Agent tab, expand the Transfer Overview section.
Select Start Transfer, then select Start.

The data transfer begins, and transfer status is updated in the Transfer Overview section on the Manage Agent tab.

Note: The Manage Agent tab provides information about the agent associated with the transfer and the transfer progress.
In the Transfer Overview section, view the transfer status as data is sent to the agent and stream data is created.

Note: The rate at which data transfers varies and depends on the density of data in the source Data Archive and/or AF server. See PI to CONNECT data transfer status for a list of transfer statuses and descriptions.
(Optional) To see more information about log messages for the transfer, select More Options > Logs. See Logs for more information.
(Optional) To view transfer progress and metrics for stream and/or asset creation, select the Transfer Metrics tab.
(Optional) To stop a transfer, select Stop Transfer, then select Stop.
(Optional) To remove a transfer, select Remove Transfer, select the Delete Streams and Entities from the cloud option if applicable, then select Remove.

Health Events window

To view more information about an agent's status, select View Transfer from the Transfer Overview section, then select Health Events. The Health Events window provides information about an agent's activity and status. Health events are based on log messages. You can sort messages by severity, source, time, and message content.

The Health Events menu with two events showing, a clear all events button on the top right and a download button on the bottom right.

The following table provides descriptions for the elements of the Health Events window.

Element	Description
Severity	The severity level of the log message. To filter by a particular severity level (Critical, Error, Warning, Information, Debug or Trace), select the filter icon and select one or more severity levels.
Source	The source of an error message. To filter by source (agent, PI point indexing or AF indexing), select the filter icon and select one or more sources.
Health Event	The health event that occurred.
Timestamp	The date of the event. To filter log messages by a particular date and/or time, select the filter icon, then enter the date and/or time in Month 00, 000 00:00:00 PM format.
Message	The actual log message. To filter by a word or phrase, select the filter icon, then enter the word or phrase.
Clear All Events	Select Clear All Events to remove all events from the view.
Download	Select Download to save a copy of the health event messages to a .csv file.

Transfer metrics

The Transfer Metrics tab displays details about a transfer's progress by server connection. Metrics for streaming and historical events and the progress of stream and asset creation are shown.

The following table provides a description of the fields in the Transfer Metrics tab.

Field name	Description
PI Data Archive Server Version	The version of Data Archive that is installed on the source server configured to send PI point data via the agent.
Total PI Points In Transfer	Total number of PI points selected for transfer.
Last Streaming Read	The date of the latest stream value read.
Streaming Rate	The average number of streaming events transferred to the PI to CONNECT Agent per second over the last minute. This value is updated every 10 seconds during data transfer.
Historical Rate	The average number of historical events transferred to the PI to CONNECT Agent per second over the last minute. This value is updated every 10 seconds during data transfer.
Total Points Updated	The number of PI points added to or removed from the transfer configuration.
Streams Creation Status	The progress of streams creation during transfer progression.
Streams Created	Total number of streams created.
Streams Updated	Total number of streams updated with new configuration and metadata.
Streams Deleted	Total number of deleted streams.
Stream Creation Errors	Total number of errors generated while creation streams.
Stream Update Errors	Number of errors generated while updating streams. See the Transfer Overview section on the Manage Agent tab for error details.
Stream Deletion Errors	Number of errors generated during stream deletion. See the Transfer Overview section on the Manage Agent tab for error details.
Historical Transfer	Transfer progress for historical data.
Historical Start	The historical start date of the transfer.
Historical End	The historical end date of the transfer.
AF Server Version	The version of Asset Framework (AF) that is installed on the source server configured to send AF element data via the agent.
Elements in Transfer	The number of AF elements configured in the transfer.
Entities Created	The total number of entities created.
Entities Updated	The number of entities created or updated during data transfer.
Entities Deleted	The total number of deleted entities.
Entities Creation Rate	The number of entities created per second during the transfer.
Entity Create/Update Errors	The number of errors generated during entity creation or updating.
Entity Deletion Errors	The number of errors generated during entity deletion. See the Transfer Overview section on the Manage Agent tab for error details.

PI to CONNECT Agent EAP