Overview
DataXchange can monitor the current connection health of three different aspects in DataXchange. The first is Equipment Connectivity Health which refers to tracking the time in which the DataXchange Service has a connection to the Equipment Source such as Focas, MTConnect, or the SRC. The second is Command Connectivity Health which monitors the health of the DataXchange command for the associated equipment. The third is the Cloud Connectivity Health which refers to tracking the time in which the DX Service is communicating with the cloud.
Connection Monitoring can be viewed through the RTV Equipment Status Grid. This can be done when building an RTV screen. When Assigning a view select the Equipment Status Grid, then configure the columns then make sure the associated column is selected. Additional information on the Equipment Status Grid can be found here.
Connectivity RTV display
The three different connectivity aspects and their health can be viewed at any given time within the RTV. Adding this data to the RTV is simple and done through the RTV Equipment Status Grid View. More information about this view can be found here.
When the Connectivity Column is added to the Equipment Status Grid View within the RTV it will display the current health of that equipment and is indicated by a corresponding color. The most recent record will determine the color to be used.
Monitored |
Notes |
|
Equipment connectivity |
This indicates that all three aspects are in good condition . The command is enabled, the connection from the DX Service to the equipment is good and the connection from the DX Service to the Cloud is also good. In order to monitor this level of status the connectivity expressions must be assigned to the equipment. |
|
Equipment connectivity |
This indicates that there is an issue with the connection from the DX Service to the equipment. This may be a network connectivity issue or the power may be off at the equipment control. In order to monitor this status level, the connectivity expressions must be assigned to the equipment. |
|
Command |
This indicates the command is enabled and the DX Service has access to the DataXchange servers. This color should only be visible when the expressions are NOT assigned. |
|
Command |
*This indicates that the Command that enables the communication to the equipment is currently not enabled. |
|
Cloud |
The DX Service is running and able to communicate with the Cloud. The Equipment has not yet been configured, or has a configuration problem, therefore the other connectivity monitoring items are unavailable, and DataXchange can only monitor the connection of the DX Service to the DataXchange Servers |
|
Cloud |
The DX Service is unable to communicate with the Cloud. The DX Service may not be running or there may be an Internet connection issue from the server where the DX Service is running. Since the DX Service cannot communicate to the Cloud, the state of the connectivity to the equipment and the state of the command cannot be reported, and therefore DataXchange can only report that there is an issue with the connection between the DX service and the DX servers. |
|
There is no connectivity data in the database for the selected equipment. This state should only be visible during an initial account setup. |
Example RTV equipment Status Grid View Image |
*When a command (gear associated to equipment) is red or red with an X this is an indicator that it is not running it can be viewed through the DataXchange tab when viewing the equipment. If correct Communications and Expressions are assigned to the equipment simply selecting the Start button will activate the command, starting the collection process. Additional information on Expressions and Communications can be found here.
Connectivity Target Variables
|
Variable Name |
Notes |
Send Connectivity Start [PCSDB.send_connectivity_start] |
Sends a start event to mark when connectivity to the Source has been established. |
|
Send Connectivity Lost End [PCSDB.send_connectivity_end] |
Sends an end event to mark when connectivity to the Source has been lost. |
Connectivity Source Variables
|
Variable Name |
Notes |
Connectivity [PCSDB.connectivity] |
Returns True if connectivity to the Source is currently in good health. The connectivity variable is set by using the two target variables defined above. |
|
Connectivity [PCSDB.poll_count] |
Returns the amount of polls that have taken place. |
Connectivity Monitoring and expressions for the Source.
The connectivity of the DX Service and the DX Commands are automatically collected and displayed within the RTV by DataXchange. In order to monitor the connection to equipment, an expression will need to be added to that equipment along with the associated connect time expression as explained above. Additional information about the collected data and the report can be found here.
Each source will have an expression to mark when connectivity was established and when connectivity was lost.
Here’s an example for FOCAS.
Use the expression written below to record when there is a connection to the equipment (Focas - Connection Time - Start)
([Focas.connected_time] < 10) AND ([PCSDB.poll_count] > 3) AND (([PCSDB.connectivity] != True) OR ([PCSDB.connectivity_status] != 1))
With the Result
[PCSDB.send_connectivity_start]
Use the expression written below to record when there is NOT connection to the equipment (Focas - Connection Time - End)
([Focas.connected_time] > 30) AND ([PCSDB.poll_count] > 3) AND (([PCSDB.connectivity] != False) OR ([PCSDB.connectivity_status] != 0))
With the Result
[PCSDB.send_connectivity_end]
Here’s an example for SRC.
Use the expression written below to record when there is a connection to the equipment (SRC - Connection Time - Start)
([SRC.connected_time] < 10) AND ([PCSDB.poll_count] > 3) AND (([PCSDB.connectivity] != True) OR ([PCSDB.connectivity_status] != 1))
With the Result
[PCSDB.send_connectivity_start]
Use the expression written below to record when there is NOT connection to the equipment (SRC - Connection Time - End)
([SRC.connected_time] > 30) AND ([PCSDB.poll_count] > 3) AND (([PCSDB.connectivity] != False) OR ([PCSDB.connectivity_status] != 0))
With the Result
[PCSDB.send_connectivity_end]
Connectivity Report
The connectivity report will generate historical data based on the connection health starts and stops that happened during a specific timeframe. More Information