The following objects are directly related to the templatedashboard
API.
The template dashboard object has the following properties.
Property | Type | Description |
---|---|---|
dashboardid | ID | ID of the template dashboard. Property behavior: - read-only - required for update operations |
name | string | Name of the template dashboard. Property behavior: - required for create operations |
templateid | ID | ID of the template the dashboard belongs to. Property behavior: - constant - required for create operations |
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. |
uuid | string | Universal unique identifier, used for linking imported template dashboards to already existing ones. Auto-generated, if not given. |
The template dashboard page object has the following properties.
Property | Type | Description |
---|---|---|
dashboard_pageid | ID | ID of the dashboard page. Property behavior: - read-only |
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 template dashboard widget objects. |
The template dashboard widget object has the following properties.
Property | Type | Description |
---|---|---|
widgetid | ID | ID of the dashboard widget. Property behavior: - read-only |
type | 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; gauge - Gauge; graph - Graph (classic); graphprototype - Graph prototype; honeycomb - Honeycomb; hostavail - Host availability; hostnavigator - Host navigator; itemnavigator - Item navigator; item - Item value; map - Map; navtree - Map Navigation Tree; piechart - Pie chart; plaintext - Plain text; problemhosts - Problem hosts; problems - Problems; problemsbysv - Problems by severity; slareport - SLA report; svggraph - Graph; systeminfo - System information; tophosts - Top hosts; toptriggers - Top triggers; trigover - Trigger overview; url - URL; web - Web monitoring. Property behavior: - required |
name | string | Custom widget name. |
x | integer | A horizontal position from the left side of the dashboard. Possible values range from 0 to 71. |
y | integer | A vertical position from the top of the dashboard. Possible values range from 0 to 63. |
width | integer | The widget width. Possible values range from 1 to 72. |
height | integer | The widget height. Possible values range from 1 to 64. |
view_mode | integer | The widget view mode. Possible values: 0 - (default) default widget view; 1 - with hidden header; |
fields | array | Array of the template dashboard widget field objects. |
The template dashboard widget field object has the following properties.
Property | Type | Description |
---|---|---|
type | integer | Type of the widget field. Possible values: 0 - Integer; 1 - String; 4 - Item; 5 - Item prototype; 6 - Graph; 7 - Graph prototype; 8 - Map; 9 - Service; 10 - SLA; 11 - User; 12 - Action; 13 - Media type. Property behavior: - required |
name | string | Widget field name. Possible values: see Dashboard widget fields. Note that some host-related parameters (e.g., Host groups, Exclude host groups and Hosts in the Problems widget, Host groups in the Host availability widget, etc.) are not available when configuring the widget on a template dashboard. This is because template dashboards display data only from the host that the template is linked to. Property behavior: - required |
value | mixed | Widget field value depending on the type. Possible values: see Dashboard widget fields. Note that some host-related parameters (e.g., Host groups, Exclude host groups and Hosts in the Problems widget, Host groups in the Host availability widget, etc.) are not available when configuring the widget on a template dashboard. This is because template dashboards display data only from the host that the template is linked to. Property behavior: - required |