这些参数及对应仪表板小部件字段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
}
响应: