Page tree

SAYMON документация

Skip to end of metadata
Go to start of metadata

Counter - the basic, the simplest and the most common widget to display text and numeric values from Data table.

This widget allows to choose one metric from one object.

Additional fields:

FieldDescription
Show labelDisplays or hides metric name under its value.
Label textDisplays custom metric name.
Value type

Current value is used for all metric types. For the numeric metric you can use one of the following functions:

  • minimum value,
  • average value,
  • maximum value,
  • number of values,
  • sum of values,
  • standard deviation
Period

Displays the metric value for the last:

  • hour,
  • day,
  • week,
  • month,
  • quarter,
  • year

or another period defined in "From" and "To" fields.

Count from

Defines the logic of the period count:

  • Present moment - displays the value type for the selected period, counting fron the present moment. E.g. you set the script execution and get the date metric (today's date) with the value of 15. When setting up the minimum weekly value: Count = metric value (15) - Period (7 days). The widget wll display the date of 8.
  • Calendar period - displays the value type for the selected period, counting fron the calendar biginning. E.g. you set the script execution and get the date metric (today's date) with the value of 15 (Thursday). When setting up the minimum weekly value: Count = metric value (15) - Period (Monday). The widget wll display the date of 12.
For previous periodCalculates and displays the metric value for the previous period with the offset defined in the "Period offset" field. E.g. you check website availability with Ping sensor and get packetsReceived as one of the metrics. You can display its average value for the last week or the previous week by turning on switcher and defining 1 for the offset.
Abbreviated valueTransforms numbers to compact view with K, M, G and T postfixes.
Theme

Allows to change a theme to apply to widget:

  • standard,
  • car,
  • vintage.
Multiline

Dispalys all lines of the metric value. If the parameter is off, only the first line of the value is displayed. E.g. when executing an HTTP request, the body metric is returned, the value of which is multi-line text. When you switch the slider to the "Yes" position and specify the font size, the response body will be fully displayed on the widget.

Dictionary

Serves to display the data that came from the agent in a human readable form on the widgets of Counters. The Dictionary is the set of records of the form "Key = Value". The data obtained from the agent are compared with the "Key". If a match is found, the propriate "Value" will  be displayed on th widget. 

For example, the door open sensor sends the values "0" and "1", which corresponds to its opening and closing. To display the state of the door in a human readable form, add to a widget the dictionary with the values:

  • 0 = the door is closed;
  • 1 = the door is opened.

The sensor fixed the door opening and sent the value "1". These data are compared with the dictionary in which correspondence is stored:

The value "The door is opened" will be displayed on the Counter.

The amount of created dictionaries and the rows stored in them for one widget is not limited. Key and Value can be respented in both alphabetic and numeric notation. The button  allows to see a list of already existing dictionaries.

  • No labels