13 主机卡片

描述

这些参数及对应仪表板小组件字段objects的可选属性值允许通过dashboard.createdashboard.update方法配置Host card小组件。

小组件fields属性在仪表板创建或update过程中不会进行验证。这使得用户可以修改built-in widgets和createcustom widgets,但也存在错误创建或更新小组件的风险。为确保成功创建或update主机卡片小组件,请参考下文表格中列出的参数行为规范。

参数

以下参数支持主机卡片部件

参数 仪表板小部件字段 名称
Refresh interval 0 rf_rate 0 - 不刷新;
10 - 10秒;
30 - 30秒;
60 - (默认) 1分钟;
120 - 2分钟;
600 - 10分钟;
900 - 15分钟.
Host 3 hostid.0 Host ID.

参数行为:
- 必填 如果未设置主机 (部件/仪表盘)

template dashboard上配置部件时不支持此参数.
主机 (部件/仪表盘) 1 hostid._reference 替代Host ID:
DASHBOARD.hostid - 将覆盖主机设置为主机的数据源;
ABCDE._hostid - 将部件兼容性 (其引用参数设置为"ABCDE")作为主机的数据源.

参数行为:
- 必填 如果未设置主机

template dashboard上配置部件时不支持此参数.
Show suppressed problems 0 show_suppressed 0 - (默认) 禁用;
1 - 启用.
Show 0 sections.0 0 - 主机分组;
1 - 描述;
2 - 监控;
3 - 可用性;
4 - 监控方;
5 - 模板;
6 - 资产清单;
7 - 标签.

注意: 属性名称中的数字对应章节列表中的顺序. 要配置多个章节, 请create仪表盘部件字段object, 并在属性名称中递增数字.

显示设置为"资产清单"时支持以下参数

参数 仪表板小部件字段 名称
Inventory fields 0 inventory.0 主机资产清单 ID.

注意: 要配置多个资产清单字段, 请create仪表盘部件字段object, 并在属性名称中递增数字.

示例

以下示例仅描述主机卡片组件中仪表板小部件字段objects的配置。 有关配置仪表板的更多信息,请参阅dashboard.create

配置主机卡片部件

配置一个显示以下部分的主机卡片部件:"Monitoring", "Availability", "Monitored by", "Inventory", 和 "Tags".

执行请求:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "hostcard",
                               "name": "Host card",
                               "x": 0,
                               "y": 0,
                               "width": 14,
                               "height": 7,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 3,
                                       "name": "hostid.0",
                                       "value": 10084
                                   },
                                   {
                                       "type": 0,
                                       "name": "show_suppressed",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.0",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.2",
                                       "value": 4
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.3",
                                       "value": 6
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.4",
                                       "value": 7
                                   },
                                   {
                                       "type": 0,
                                       "name": "inventory.0",
                                       "value": 25
                                   },
                                   {
                                       "type": 0,
                                       "name": "inventory.1",
                                       "value": 26
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

另请参阅