Introduction
Use Data Logic to transform the data from assets before it is sent to a data destination. Data Logic scripts are created in VS Code and synchronized with your organization's Cisco IoT account where they can be deployed to an EI Agent. This means the script will be run on the Cisco network device where the EI Agent is installed, receive data from assets, transform that data according to the Data Logic script, and send the results to a data destination.
Deploy Data Logic
- In Cisco EI, configure the EI Agents, Asset Types, Asset instances, and Data Destinations that will be used by the Data Logic.
- In VS Code, develop and debug the Data Logic script.
- In VS Code, click Push to Production to save the Data logic to Cisco EI.
- In Cisco EI, deploy the Data Logic to an EI Agent:
- Click Data Polices > Data Logics.
- Click New / Not Deployed.
- In the Data Logic entry, click Configure.
- (Optional) Click the Configuration tab to change the Data Destination, or view the script or Input Asset Type details.
- Click Deploy. This takes you to the Deployment tab.
- Select one or more EI Agents and click Deploy. This takes you to the Status tab which shows the list of deployed EI Agents.
Undeploy Data Logic
- From the left menu, click Data Policies > Data Logics.
- Click Configure for the script you want to undeploy.
- Click the Status tab.
- In the Deployment Status section, select the EI Agent name where the script is deployed and click Undeploy. To undeploy multiple EI Agents, select one or more EI Agents and click Undeploy.
View Data Logic status
- From the left menu, click Data Policies > Data Logics.
- Data Logic entries are displayed on the right pane. You can view all of them or view only the deployed or non-deployed by selecting the tabs on top of the screen.
- Click View Policy Status for a script to view the EI Agent status where the Data Logic is deployed. This takes you to the Status tab which shows the list of deployed EI Agents.
- Under Policy Status:
- Click the status link to view detailed status of the source, destination and Data Logic.
- It also shows a table that lists the asset instances under the Asset tab, their status, and error messages in the policy.
- The EI Agent tab shows the EI Agent details.
- The Data Logic tab shows the data logic status and other details.
- The Destination tab shows its status, the last time when the data was sent to the data destination, and the error messages if any.
View Data Policy Event Log
You can track the health status of a data policy on a given EI Agent.
From the left pane, click Operations > Events.
A list of data policies appears in tabular form.
Column header | Description |
---|---|
Severity | The severity of the policy. * Major: The policy changes from Running Status to some other state. * Info: The pipeline changes state to Running from any other state. |
Entity Name | The name of the data policy. |
Event Type | The health of the data policy. |
Event Time | The timestamp when the event was raised. |
Message | The status of the data policy. |