Table of Contents
> Dashboard object
The following objects are directly related to the dashboard API.
Dashboard
The dashboard object has the following properties.
| Property | Type | Description |
|---|---|---|
| dashboardid | string | (readonly) ID of the dashboard. |
| name (required) |
string | Name of the dashboard. |
| userid | string | Dashboard owner user ID. |
| private | integer | Type of dashboard sharing. Possible values: 0 - public dashboard; 1 - (default) private dashboard. |
| display_period | integer | Default page display period (in seconds). Possible values: 10, 30, 60, 120, 600, 1800, 3600. Default: 30. |
| auto_start | integer | Auto start slideshow. Possible values: 0 - do not auto start slideshow; 1 - (default) auto start slideshow. |
Note that for some methods (update, delete) the required/optional parameter combination is different.
Dashboard page
The dashboard page object has the following properties.
| Property | Type | Description |
|---|---|---|
| dashboard_pageid | string | (readonly) ID of the dashboard page. |
| name | string | Dashboard page name. Default: empty string. |
| display_period | integer | Dashboard page display period (in seconds). Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600. Default: 0 (will use the default page display period). |
| widgets | array | Array of the dashboard widget objects. |
Dashboard widget
The dashboard widget object has the following properties.
| Property | Type | Description |
|---|---|---|
| widgetid | string | (readonly) ID of the dashboard widget. |
| type (required) |
string | Type of the dashboard widget. Possible values: actionlog - Action log; clock - Clock; (deprecated) dataover - Data overview; discovery - Discovery status; favgraphs - Favorite graphs; favmaps - Favorite maps; geomap - Geomap; graph - Graph (classic); graphprototype - Graph prototype; hostavail - Host availability; item - Item value; map - Map; navtree - Map Navigation Tree; plaintext - Plain text; problemhosts - Problem hosts; problems - Problems; problemsbysv - Problems by severity; slareport - SLA report; svggraph - Graph; systeminfo - System information; tophosts - Top hosts; trigover - Trigger overview; url - URL; web - Web monitoring. |
| name | string | Custom widget name. |
| x | integer | A horizontal position from the left side of the dashboard. Valid values range from 0 to 23. |
| y | integer | A vertical position from the top of the dashboard. Valid values range from 0 to 62. |
| width | integer | The widget width. Valid values range from 1 to 24. |
| height | integer | The widget height. Valid values range from 2 to 32. |
| view_mode | integer | The widget view mode. Possible values: 0 - (default) default widget view; 1 - with hidden header; |
| fields | array | Array of the dashboard widget field objects. Required for specific widgets; see individual widgets in Dashboard widget fields. |
Dashboard widget field
The dashboard widget field object has the following properties.
| Property | Type | Description |
|---|---|---|
| type (required) |
integer | Type of the widget field. Possible values: 0 - Integer; 1 - String; 2 - Host group; 3 - Host; 4 - Item; 5 - Item prototype; 6 - Graph; 7 - Graph prototype; 8 - Map; 9 - Service; 10 - SLA. |
| name (required) |
string | Widget field name. Possible values: see Dashboard widget fields. |
| value (required) |
mixed | Widget field value depending on the type. Possible values: see Dashboard widget fields. |
Dashboard user group
List of dashboard permissions based on user groups. It has the following properties.
| Property | Type | Description |
|---|---|---|
| usrgrpid (required) |
string | User group ID. |
| permission (required) |
integer | Type of permission level. Possible values: 2 - read only; 3 - read-write. |
Dashboard user
List of dashboard permissions based on users. It has the following properties.
| Property | Type | Description |
|---|---|---|
| userid (required) |
string | User ID. |
| permission (required) |
integer | Type of permission level. Possible values: 2 - read only; 3 - read-write. |