15 监控项 卡片
描述
这些参数及对应仪表板小部件字段objects的可选属性值 允许在dashboard.create和dashboard.update方法中配置Item 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分钟. |
|
| Item | 4 | itemid.0 | Item ID. 参数行为: - 必填 如果未设置监控项 (部件) |
|
| 监控项 (部件) | 1 | itemid._reference | 替代Item ID:ABCDE._itemid - 将部件兼容性 (其引用参数设置为"ABCDE")设置为监控项的数据源.参数行为: - 必填 如果未设置监控项 |
|
| Show | 0 | sections.0 | 0 - 描述; 1 - 错误文本; 2 - 指标; 3 - 最新数据; 4 - 信息类型; 5 - 触发器; 6 - 主机接口; 7 - 类型; 8 - 主机资产清单; 9 - 标签. 注意: 属性名称中的数字引用部分在部分列表中的顺序. 要配置多个部分, 为每个部分create一个仪表板部件字段object, 并在属性名称中使用递增的数字. |
|
| Override host | 1 | override_hostid._reference | ABCDE._hostid - 将部件兼容性 (其引用参数设置为"ABCDE")设置为主机的数据源;DASHBOARD._hostid - 将仪表板覆盖主机设置为主机的数据源.默认: "" (空)如果在template dashboard上配置部件, 则不支持此参数. |
|
微线图
如果显示设置为"最新数据"，则支持以下参数。
| 参数 | 仪表板小部件字段 | 名称 | 值 | |
|---|---|---|---|---|
| Width | 0 | sparkline.width | 取值范围0-10。 默认值: 1. |
|
| Fill | 0 | sparkline.fill | 取值范围0-10。 默认值: 3. |
|
| Color | 1 | sparkline.color | 十六进制颜色代码(例如FF0000)。默认值: 42A5F5. |
|
| Time period | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod - 将Time period selector设置为数据源;ABCDE._timeperiod - 将部件兼容性(其reference参数等于ABCDE)设置为数据源。默认值: "" (空)或者，您也可以仅在从和到参数中设置时间段。 |
|
| 从 | 1 | sparkline.time_period.from | 有效的string时间，使用绝对时间语法(YYYY-MM-DD hh:mm:ss)或relative时间语法(now, now/d, now/w-1w等)。默认值: now-1h. 参数行为: - 当时间段未设置时支持 |
|
| 到 | 1 | sparkline.time_period.to | 有效的string时间，使用绝对时间语法(YYYY-MM-DD hh:mm:ss)或relative时间语法(now, now/d, now/w-1w等)。默认值: now. 参数行为: - 当时间段未设置时支持 |
|
| History data | 0 | sparkline.history | 0 - (默认)自动; 1 - 历史数据; 2 - 趋势数据。 |
|
示例
以下示例仅描述监控项卡片小部件中仪表板小部件字段objects的配置。 有关配置仪表板的更多信息，请参阅dashboard.create。
配置监控项卡片部件
配置一个显示以下部分的监控项卡片部件: "描述", "最新数据", "触发器" 和 "标签".
执行请求:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemcard",
"name": "Item card",
"x": 0,
"y": 0,
"width": 14,
"height": 7,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42257
},
{
"type": 0,
"name": "sections.0",
"value": 0
},
{
"type": 0,
"name": "sections.1",
"value": 3
},
{
"type": 0,
"name": "sections.2",
"value": 5
},
{
"type": 0,
"name": "sections.3",
"value": 9
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}响应: