Documentation>Cisco IoT Operations Dashboard
Cisco IoT Operations Dashboard

Deploy asset-based Data Rules

About Data Policies

Data Policies define how data is sent from edge assets to a destination. There are two types of policies:

  • Data Rules: Data is sent from Assets to a destination without transformation.
  • Data Logic: Data is transformed before being sent to a destination. Data Logic scripts are developed using Microsoft VS Code.

Create a Data Rule

Data rules define the flow of data, from connected assets to data destinations, without transformation.

  1. From the left menu, click Data Policies > Data Rules.
  2. Click Create Data Rule, enter the following information and click Save.
Field Description
Rule Name Enter a meaningful name.
Description This is an optional field.
Source
Asset Type Data is sent for all assets of the selected Asset Type. Verify the following:

* The Asset Type is correctly configured for the connection method.
* The Asset instances are configured correctly in the Asset Inventory.
* The Asset instances are mapped to an EI Agent.
* The EI Agent is reachable.

See Add Assets.
Filter Select a filter from the drop-down list.

Attributes that will be sent to the destination can be filtered. If an attribute is not visible at the destination, check the Asset Type attribute definition.
Destination
Data Destination Type Select a supported destination type.
See Add Data Destinations.
Data Destination Select a destination that was configured for the selected type.
See Add Data Destinations.
Data Sampling Interval (ms) This defines how often data is sent to the destination. It helps to limit the bandwidth required. If the source receives data in a higher frequency only the last received value is sent and all others are discarded.
The default value is Disabled. You can select some predefined values from the dropdown list. You can also define custom values by clicking the + icon in the upper right corner of the dropdown list.
Rule Data Classification The type of rule data classification. This can be one of the following:
* Device Property
* Telemetry
Note: This option is shown only if you select the destination as Azure IoT.

Note: EI currently supports the use of one data policy to send data from an asset to the same Azure IoT Hub destination. For example, if you create two data policies that send data from the same asset to the same Azure IoT Hub destination, only the first policy will work.

Deploy Data Rules

Data Rules are deployed and run on the EI agent software installed on edge devices.

At least 1 Asset must be mapped to each EI Agent(s) where the data rule is deployed.

  1. From the left menu, click Data Policies > Data Rules.
  2. In the Data Rule entry, click Deploy / Undeploy.
  3. In the Data Rule section, select the EI agent(s) and click Deploy.
  4. Scroll down to Deployment Status:
    • Deployment Pending (yellow): The Data Policy is in the process of being deployed.
    • Deployed (green): Deployment is successful on all EI Agents. Data is flowing from all assets to the data destination as configured.
    • Error (red): The policy deployment is unsuccessful. There is at least one EI Agent on which the deployment failed. The data flow from assets to data destination is not successful for some configured assets.

Undeploy Data Rules

  1. From the left menu, click Data Policies > Data Rules.
  2. In the Data Rule entry, click Deploy / Undeploy.
  3. Select the data policy and click Undeploy.

Manage Data Rules

View Data Rule policy status

  1. From the left menu, click Data Policies > Data Rules.
  2. In the Data Rule entry, click the Policy Status. The status is shown for the EI Agents where the policy is deployed.
    • Not Deployed: No data policies are deployed on the EI Agent.
    • All Running: All data policies on EI Agent transferring data from assets to destinations.
    • Some Running: Not all data policies are transferring data.
    • Error: All data policies deployed on this EI Agent are in error state and data is not flowing for any configured assets.
    • Unknown: The EI Agent is offline. The policy status cannot be retrieved.

Edit a Data Rule

Note: A rule cannot be edited if it is active on any EI agents. To edit a rule, undeploy it from all EI agents.

  1. From the left menu, click Data Policies > Data Rules.
  2. In the Data Rule entry, click the name of a Data Policy.
  3. Click Edit in the details page to change the policy. Click Save.

Delete a Data Rule

Note: A rule cannot be deleted if it is active on any EI agents. To delete a rule, undeploy it from all EI agents.

  1. From the left menu, click Data Policies > Data Rules.
  2. Select the checkbox for the Data Rule you want to delete.
  3. Click Delete.
  4. In the warning pop-up, click Yes.

Create and Deploy a Data Rule for IBM Watson data destination

  1. Add an asset to be deployed.
    1. Open your IoT Dashboard and copy the Asset Type name and the serial number of the assets that send data to the IBM Watson destination.
    2. Open your IBM Watson IoT Platform web dashboard.
    3. From the left pane, click Devices → Device Types tab → Add Device Type.
    4. In the Add Type section, select Device as the Type and enter the Asset Type name copied from your Cisco IoT Dashboard in the Name field.
    5. Click Next. Enter the metadata for the asset if needed and click Finish.
    6. Click the Browse tab and then click Add Device. Note: If device provisioning is enabled in IBM Watson data destination, skip the next step to Add Device.
    7. In the Add Device section, enter the following:
      1. Device Type: Enter or select the Asset Type name you just created.
      2. Device ID: Enter the device serial number of the asset from your Cisco IoT Dashboard. Note: The Serial ID is the unique ID added while adding asset instances. See Add asset instances.
    8. Edit or add metadata for the asset if needed and click Next.
    9. Enter the Device Authentication Token in the Authentication Token field if you had provided it while adding the IBM Watson data destination in the EI UI (else skip this step). Click Next → Finish. The Asset is added and appears in the list of devices in the Browse tab.
  2. Create a data rule. See Create a Data Rule. In the Data Destination Type field, select IBM Watson.
  3. Deploy the data rule. See Deploy Data Rules. After the deployment is successful, in the IBM Watson IoT Platform UI → Browse tab → the status column of the device shows Connected.

To undeploy the data rule, see Undeploy Data Rules. After the asset is successfully undeployed, in the IBM Watson IoT Platform UI → Browse tab → the status column of the device shows Disconnected.

Next