Page tree

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

Skip to end of metadata
Go to start of metadata

Some elements of SAYMON web interface can be configured in the client configuration file /usr/local/saymon/client/client-config.js.

In some cases the file  client-config.js can be stored in another directory. The directory can be found by either checking the nginx configuration file or using the following command:

sudo find / -name "client-config.js"

Section/Parameter                                   Description
agentInstallerUrlA link to download an agent installation script.


It activates manual registration for users;

    • false | registration is disabled,
    • true | registration is enabled.

By default false | registration is disabled.


This section allows to set authentication methods for SAYMON users.

authentication: {
	availableMethods: ["native", "keycloak"],
	methodByDefault: "keycloak",
	services: {
		keycloak: {
			configUri: "keycloak_frontend.json",
			legacySupport: false

List of authentication methods available for users:

    • "native" - log in with the username and password directly on the SAYMON server;
    • "keycloak" - log in with using an external Keycloak server.

By default only "native" is used.


Authentication method offered to users when the authentication form is displayed.

By default "native".

Section with settings for authentication services.


Section with settings for authentication via Keycloak.

Name of the configuration file, generated by the Keycloak server for the Frontend-client. 

The file must be placed on the SAYMON server in the directory with the client-config.js file

It enables support for working with Keycloak-server version below 19;

    • false | support for working with Keycloak server version below 19 is disabled;
    • true | support for working with Keycloak server version below 19 is enabled.

By default false | support for working with Keycloak server version below 19 is disabled.

canEditObjectStyleIt allows to configure CSS styles for objects and links. With the option is enabled, the section Parameters contains the subsection Style (of objects, links).

It specifies the way sections and graphs are displayed:

    • false | sections are pinned, graphs are shown,
    • true | sections are unpinned, graphs are hidden.

By default true | sections are unpinned, graphs are hidden.


Along with REST API, SAYMON uses the Comet model to exchange data between the client and the server.

comet: {
    port: 8091,
	url: [

Port number which the client connects to the Comet server by.

By default 8091.


Addresses for connecting the clients to the Comet server from different networks.

The comet.port parameter is ignored while using the comet.url parameter.


It allows to set a standard icon and its size for objects of a particular class.

defaultClassImage: {
    '29': { img: '/images/cloud.svg', dim: [100, 75] }
defaultClassImage.'<number>'Class identificator, for example, 29.


Path to the image relatively to the directory where the configuration file is located.
Size of the image (in pixels, [width, height]).


It allows to embed widgets with information about objects to external resources.

defaultEmbeddableLink: {
    url: "",
    name: "SAYMON"

Name of the widget.


URL to which the widget refers.


Default colors for pie chart (Circle):

defaultPieChartColors: [

It allows to remove sections shown in the End View in the upper part of the screen.

The list of all available sections:


This section allows to set links to various documentation for SAYMON.

documentation: {
	main: {
    	root: '',
        ru: ''
    notificationTemplates: {
    	root: '',
        ru: ''


Links to user documentation.
documentation.main.rootLink to English-language documentation.
documentation.main.ruLink to Russian-language documentation.


Links to notification templates.
Links to English-language notification templates.
Links to Russian-language notification templates.

It enables incidents functionality;

    • false | functionality is disabled,
    • true | functionality is enabled.

By default false | functionality is disabled.


It enables SMS-notifications;

    • false | SMS-notifications are disabled,
    • true | SMS-notifications are enabled.

By default false | SMS-notifications are disabled.


It enables translation of numeric SNMP OIDs to the text format;

    • false | translation is disabled,
    • true | translation is enabled.

By default false | translation is disabled.


It enables voice notifications;

    • false | voice notifications are disabled,
    • true | voice notifications are enabled.

By default false | voice notifications are disabled.


By default, when an object is selected, SAYMON shows its End view, even if the object does not contain other objects. The list of class IDs, for which SAYMON will display the Standard view if the selected object is empty, can be set in this parameter.

By default:

  • 1 (Root),
  • 3 (Host),
  • 13 (Node),
  • 43 (Dashboard).


SAYMON allows to link objects to their geographical location and browsing them on a map.

geoMap: {
    serverName: undefined,
    initialPosition: [30.341306, 59.930089],
    initialZoom: 8

Initial position on the map [longitude, latitude]. 

By default Russia, Saint Petersburg.


Initial zoom of the map.

By default 8.


Name of the server used for displaying the map.

By default

It is also possible to use a local OSM server.


This section allows to set a grid for objects alignment in the Standard view.

grid: {
    dim: 20,
    color: "rgba(128, 128, 128, 0.3)",
    border: 4

Maximum indent between objects and grid border (in pixels).

By default 4.


Grid color in the RGBA format.

Be default "rgba(128, 128, 128, 0.3)".


Grid size (in pixels).

By default 20.


This section contains parameters of displaying objects in the Grid view.

Amount of objects placed in one row of the grid.

With gridView.cols > 0 width of objects changes automatically.

With gridView.cols = 0 the number of objects in a row adjusts to the screen width.

By default 6.

gridView.colWidthWidth of objects with gridView.cols = 0 (in pixels).

Indent between objects (in pixels).

By default 5.


Height of objects (in pixels).

By default 90.


It hides notifications about connection status with the Comet server;

    • false | notifications are displayed in the web interface,
    • true | notifications are displayed in the console.

By default false | notifications about connection status with the Comet server are displayed in the web interface.


It hides notifications about errors which can take place with sending automatic requests to the server;

    • false | notifications are displayed in the web interface,
    • true | notifications are hidden.

By default false | notifications are displayed in the web interface.

The errors which take place with the participation of the user, for instance, saving any data in forms, will be displayed in the web interface in any case.


This section contains parameters for displayng data on graphs, also some additional interface elements, used for plotting, can be activated here.

history: {
    slider: false,
    downsampling: [
        [[1, 'hours'], '15s-avg'],
        [[1, 'days'], '5m-avg'],
        [[1, 'weeks'], '1h-avg'],
    modelChangeAnnotations: false
history.downsamplingDownsampling parameters.

It activates the option which allows to change annotations on graphs;

    • false | annotation changing is disabled,
    • true | annotation changing is enabled.

By default false | annotation changing is disabled.


It activates the slider, which is used for setting time range of data displaying;

    • false | slider is deactivated,
    • true | slider is activated.

By default false | slider is deactivated.


This section allows to control installed languages of web interface.

languages: {
	en: { short: 'us', long: 'English' },
    ru: { short: 'ru', long: 'Русский' },
    it: { short: 'it', long: 'Italiano' }

Language identifier. Web interface is available on three languages:

  • en | English,
  • it | Italian,
  • ru | Russian.

Language full name.

This name is displayed in SAYMON current user menu with selecting an interface language.


Identifier of the flag icon.

This icon displayed in SAYMON current user menu with selecting an interface language.

- es,

- gb,

- it,

- ru,

- us.


It enables data update every millisecond.

    • false | update is disabled,
    • true | update is enabled.

By default false | update is disabled.


This section contains parameters to hide unused monitoring probes from the interface.

monitoring: {
	standardTasks: ['ping', 'snmpGet']
monitoring.standardTasksThe array of identifiers of the displayed standard probes.

Time period between data requests from the REST server, if the connection between the client and the Comet server is unavailable (in milliseconds).

By default 5000 | 5 seconds.


Time period between data requests from the Comet server, if the connection between the client and the Comet server is available (in milliseconds).

By default 60000 | 1 minute.


Header for tabs, and also the name, displayed at the top left corner of web interface. 

By default SAYMON.


This section contains parameters for object tree.

tree: {
	filterSubmit: true

It enables the "apply filter" button and disables the automatic filtering;

    • false | the button is disabled,
    • true | the button is enabled.

By default false | the button is disabled.


This parameter is used to configure SAYMON themes.

The theme Light is used by default. There is also the available theme Dark.

CSS files with the themes are located in the directory $SAYMON_ROOT/target/client/css.

$SAYMON_ROOT/target/client/css is the directory where SAYMON is installed.

themes: {
	default: { name: 'Light' },
	dark: { name: 'Dark' }


It enables sorting objects with the javascript-natural-sort library:

    • false | objects are sorted with native functions of the browser,
    • true | objects are sorted with the javascript-natural-sort library.

By default false | objects are sorted with native functions of the browser.

With set useNaturalSort = true performance of the web interface can degrade if there is huge number of objects in the system (100 000 and more).

  • No labels