Widget

Widgets allow you to display metrics in the standard view of the SAYMON UI.

Widgets are a part of entity’s client data.

Widget Model

Field Type Description

id

String

Widget’s ID.

type

String

Widget’s type.

parameters

Object

A set of widget’s parameters.

Widgets' Types

SAYMON provides 10 types of widgets, each having its own set of parameters. Below you can find the names of widgets' types (shown as a header) along with a set of parameters for each of the widgets.

Widget settings described below are defined in the parameter field.

counter

Counter widget displays the text and numeric values from the Data table.

Counter Widget
Field Type Description

bindPeriod

String

The type of a bind used for a metric time interval. Available options: present, calendar.

customAvgPeriod.from

Integer

A starting timestamp for the custom metric time interval.

customAvgPeriod.to

Integer

An ending timestamp for the custom metric time interval.

dictionary

String

The name of a dictionary used for metric values.

fontSize

Integer

The size of a font used for a multiline metric.

metric

String

The name of a metric displayed on the widget.

metricAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

metricCaption

String

The caption of the displayed metric.

multiline

Boolean

Whether to use the multiline format to display metrics.

periodAvg

String

The size of a time interval on which metric values should be displayed. Available options:1h, 1d, 1w, 1n, 3n, 1y, custom.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

showBefore

Boolean

Whether to show metrics for a previous period.

showBeforeTimes

Integer

The offset that should be used to show metrics for a previous period.

showName

Boolean

Whether to show a metric’s caption.

theme

String

Widget’s theme. Available options: minimal, car, train-station.

ring

Ring widget displays percentage values from the Data table.

Ring Widget
Field Type Description

bindPeriod

String

The type of a bind used for a metric time interval. Available options: present, calendar.

customAvgPeriod.from

Integer

A starting timestamp for the custom metric time interval.

customAvgPeriod.to

Integer

An ending timestamp for the custom metric time interval.

metric

String

The name of the metric displayed on the widget.

metricAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

metricCaption

String

The caption of the displayed metric.

periodAvg

String

The size of a time interval on which metric values should be displayed. Available options:1h, 1d, 1w, 1n, 3n, 1y, custom.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

showBefore

Boolean

Whether to show metrics for a previous period.

showBeforeTimes

Integer

The offset that should be used to show metrics for a previous period.

showName

Boolean

Whether to show a metric’s caption.

percent-bar

Percent bar (or level) displays percentage values from the Data table.

This widget has the same model as the ring widget.

Percent Bar

pie

Pie chart widget allows to choose and compare several metrics from one object or several metrics with the same names from several objects.

Pie Chart Widget
Field Type Description

bindPeriod

String

The type of a bind used for a metric time interval. Available options: present, calendar.

colors

Array<String>

An array of colors used for metrics of the pie widget.

customAvgPeriod.from

Integer

A starting timestamp for the custom metric time interval.

customAvgPeriod.to

Integer

An ending timestamp for the custom metric time interval.

innerRadius

Integer

The radius of an inner circle.

legend

Boolean

Whether to display a widget’s legend.

metric

Array<String>

An array of metrics that should be displayed on the pie widget.

metricAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

metricCaption

String

The caption of the displayed metrics.

periodAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

sectorLabel

String

The type of a label used for pie widget metrics. Available options: none, percent, value, entity.

sectorLabelColor

String

The color of a section label.

showBefore

Boolean

Whether to show metrics for a previous period.

showBeforeTimes

Integer

The offset that should be used to show metrics for a previous period.

showName

Boolean

Whether to show a metrics' caption.

radar

Radar widget allows you to display and compare metrics of multiple entities.

Radar Widget
Field Type Description

bindPeriod

String

The type of a bind used for a metric time interval. Available options: present, calendar.

customAvgPeriod.from

Integer

A starting timestamp for the custom metric time interval.

customAvgPeriod.to

Integer

An ending timestamp for the custom metric time interval.

legend

Boolean

Whether to display a widget’s legend.

metric

Array<String>

An array of metrics that should be displayed on the radar widget.

metricAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

metricCaption

String

The caption of the displayed metrics.

periodAvg

String

The type of transformation applied for metric values. Available options: current, min, avg, max, count, zimsum, dev.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

showBefore

Boolean

Whether to show metrics for a previous period.

showBeforeTimes

Integer

The offset that should be used to show metrics for a previous period.

showName

Boolean

Whether to show a metrics' caption.

chart

Chart widget allows you to plot a graph based on a specified metric.

Chart Widget
Field Type Description

chartType

String

The type of a char. Available types: lines, bars.

downsample

Integer

The size of an interval used for downsampling.

duration

Integer

The length of a period on which metrics are displayed. Should be specified in milliseconds.

legend

Boolean

Whether to show a legend on the widget.

metric

String

A metric (of several metrics) displayed on the chart widget. The metrics should be specified as a mathematical formula.

movingAverage

Boolean

Whether to use a moving average on a chart.

movingAveragePeriod

Integer

The length of an interval on which a moving average should be calculated.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

graph

Graph widget displays the relations of object’s child entities.

Graph Widget
Field Type Description

depth

Integer

The depth of a graph.

graphType

String

The type of a graph. Available types: block, blockVert, mindMap, force.

position.height

Integer

Widget’s height.

position.scale

Integer

The scale of a graph.

position.translation

Array<Integer>

The coordinates of a graph inside the widget.

position.width

Integer

Widget’s width.

section

Section widget allows you to display a section from an end view

Section Widget
Field Type Description

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

section

String

The type of a section displayed inside the widget. Available types: stat, properties, documents, state-history, operations-history.

operation-widget

Operation widget is a button that performs a specified operation.

Button Widget
Field Type Description

color

String

The color of a button displayed on the widget.

operation

String

The ID of an operation. This operation will be executed after the user clicks the button on the widget.

operationCaption

String

Operation’s caption.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.

iframe

Iframe widget allows to embed content from other resources to the system web interface.

IFrame Widget
Field Type Description

src

String

URL of the page shown in an iframe.

type

String

MIME type of the media shown in an iframe.

position.height

Integer

Widget’s height.

position.width

Integer

Widget’s width.