这些参数及其可能的属性值允许配置dashboard.create
和dashboard.update
方法中的纯文本小部件。
在创建或更新仪表盘时,不会验证小部件fields
属性。 这允许用户修改内置小部件并创建自定义小部件,但同时也引入了错误创建或更新小部件的风险。 为确保纯文本小部件的成功创建或更新,请参考下表中概述的参数要求。
以下参数支持纯文本小部件。
参数 | 类型 | 名称 | 值 |
---|---|---|---|
刷新间隔 | 0 | rf_rate | 0 - 不刷新; 10 - 10秒; 30 - 30秒; 60 - (默认) 1分钟; 120 - 2分钟; 600 - 10分钟; 900 - 15分钟。 |
监控项 (必需) |
4 | itemids | 监控项 ID。 注意:要配置多个监控项,为每个监控项创建一个仪表盘小部件字段对象。 |
监控项位置 | 0 | style | 0 - (默认) 左; 1 - 上。 |
显示行数 | 0 | show_lines | 有效值范围从1-100。 默认:25。 |
将文本显示为HTML | 0 | show_as_html | 0 - (默认) 禁用; 1 - 启用。 |
动态监控项 | 0 | dynamic | 0 - (默认) 禁用; 1 - 启用。 |
以下示例旨在仅描述纯文本仪表盘小部件的配置。 有关配置仪表盘的更多信息,请参见dashboard.create
。
配置一个纯文本小部件,用于展示监控项"42269"和"42253"的最新数据。 此外,将监控项名称配置在数据列的顶部,并且只展示15行数据。
请求:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "plaintext",
"name": "Plain text",
"x": 0,
"y": 0,
"width": 6,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemids",
"value": 42269
},
{
"type": 4,
"name": "itemids",
"value": 42253
},
{
"type": 0,
"name": "style",
"value": 1
},
{
"type": 0,
"name": "show_lines",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
响应: