Monitor Node

Monitor Node

The monitor node displays a value on a widget based on predefined logic and parameters. It can automatically update the color of your widget based on the meaning of the value on display.

Adding a Monitor node to your workflow

1. First, select your desired solution and navigate to Rayven Workflow.
2. Select ‘Visualizations’ from the left-hand panel.
3. Find the Monitor node and drag it onto the canvas.
4. Connect the Monitor node to your desired input node.
5. Double click on the Monitor node to open its configuration window.

Configuring your Monitor node

1. Give your node a name that clearly explains its purpose. You must pick a name that has three or more characters.
2. Under Data Field Name, enter the field name within the incoming JSON payload that contains the data you want to display on the widget.
3. If you want, you can add a Widget Subtitle. This additional text helps explain the data presented by the node to the end-user. It will appear under the Widget Name in a smaller font. 
4. Selecting the 'Device/Device Label Name' checkbox will ensure the widget displays the device or label name.
5. If you want to include an icon on your widget, clicking ‘Choose icon’ will let you select one to display from the Rayven library.
6. If you choose to display Trend, an up or down arrow will appear on the widget when its value changes to indicate it has gotten larger or smaller.
7. Enter a Symbol to display a special character at the end of a value (for example, °C or °F).
8. Enter the number of decimal places to display under Decimal Precision.
9. Select Hide Value if you don't want the value of the Input Data Field to show on the widget display.
10. Select Color Entire Widget to fill the widget display with the color defined in the Range roll. If unchecked, a strip at the top of the widget will show the Range roll color instead.
11. Select a Condition Type to determine the range format:
    • Numeric Range: choose this if the data received is numbers-based.
    • Alphanumeric: choose this if the data received is string-based.
12. Select a dashboard to open when a user clicks on the widget under Dashboard to Link To. Choose from the dropdown options - see Section 3.4: Dashboards for more information.
13. Choose how to Show Last Value:
    • Chronologically: Take the value from the payload with the latest timestamp.
    • Received: Take the value from the last payload received, irrespective of the timestamp.
14. You will need to set the conditions for particular colors to appear by entering at least one range. It is possible to add as many rows as you want. You can enter the same definition (e.g. normal, minor, critical) several times.
     

Grouping by Device Label

You will need to select how data should be grouped and displayed on the widget. To group data by device label, you must first create at least one label in the Device Labels section of the Workspace. See Creating Device Labels and Configuring Nodes Using Labels for more information.

To group your data:

1. Select the label you will be using to filter devices from the dropdown list under ‘Device label name’.
2. Select a method for grouping the widget on the dashboard:
   • No Grouping (widget per device): one Monitor widget will appear for each device.
   • Group by device label value (widget per label value): one Monitor widget will appear for each unique value label. For example, if the device label is ‘Color’ and the label values are ‘Green’ and ‘Gold’ the dashboard will show two widgets. One will contain data for devices labeled ‘Green’ and the other for devices labeled ‘Gold’.
   • Group by device label name (one widget): only one Monitor widget will be displayed. It will contain data from all devices with the selected device label.

See Also: Creating a dashboard, Creating device labels, Configuring nodes using labels

As of Release: 10.02.2022