8 图表
描述
这些参数以及各自仪表盘小部件字段对象的可能属性值允许在dashboard.create和dashboard.update方法中配置图表小部件。
在创建或更新仪表盘时，不会验证小部件fields属性。 这允许用户修改内置小部件并创建自定义小部件，但也存在创建或更新小部件不正确的风险。 为确保成功创建或更新图表小部件，请参考下面表格中概述的参数要求。
参数
图表小部件支持以下参数。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 刷新间隔 | 0 | rf_rate | 0 - 不刷新； 10 - 10秒； 30 - 30秒； 60 - (默认) 1分钟； 120 - 2分钟； 600 - 10分钟； 900 - 15分钟。 |
数据集
以下参数支持配置数据集。
属性名称中的第一个数字（例如 ds.hosts.0.0，ds.items.0.0）代表特定的数据集， 如果存在第二个数字，则代表已配置的主机或监控项。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 主机模式 (必填) |
1 | ds.hosts.0.0 | 主机名称或模式（例如Zabbix*）。 |
| 监控项模式 (必填) |
1 | ds.items.0.0 | 监控项名称或模式（例如*: Number of processed *values per second）。 |
| 颜色 | 1 | ds.color.0 | 十六进制颜色代码（例如FF0000）。默认值： FF465C。 |
| 绘制方式 | 0 | ds.type.0 | 0 - (默认) 线条； 1 - 点； 2 - 阶梯； 3 - 条形。 |
| 宽度 | 0 | ds.width.0 | 有效值范围从1-10。 默认值：1。 如果绘制方式设置为"点"或"条形"，则宽度参数不可用。 |
| 点大小 | 0 | ds.pointsize.0 | 有效值范围从1-10。 默认值：3。 如果绘制方式设置为"线条"、"阶梯"或"条形"，则点大小参数不可用。 |
| 透明度 | 0 | ds.transparency.0 | 有效值范围从1-10。 默认值：5。 |
| 填充 | 0 | ds.fill.0 | 有效值范围从1-10。 默认值：3。 如果绘制方式设置为"点"或"条形"，则填充参数不可用。 |
| 缺失数据 | 0 | ds.missingdatafunc.0 | 0 - (默认) 无； 1 - 连接； 2 - 视为0。 如果绘制方式设置为"点"或"条形"，则缺失数据参数不可用。 |
| Y轴 | 0 | ds.axisy.0 | 0 - (默认) 左侧； 1 - 右侧。 |
| 时间偏移 | 1 | ds.timeshift.0 | 有效的时间字符串（例如3600，1h等）。您可以使用时间后缀。也允许使用负值。 默认值： ""（空）。 |
| 聚合函数 | 0 | ds.aggregate_function.0 | 0 - (默认) 无； 1 - 最小值； 2 - 最大值； 3 - 平均值； 4 - 计数； 5 - 总和； 6 - 第一个； 7 - 最后一个。 |
| 聚合间隔 | 1 | ds.aggregate_interval.0 | 有效的时间字符串（例如3600，1h等）。您可以使用时间后缀。 默认值： 1h。 |
| 聚合 | 0 | ds.aggregate_grouping.0 | 0 - (默认) 每个监控项； 1 - 数据集。 如果聚合函数设置为"无"，则聚合参数不可用。 |
显示选项
以下参数支持配置显示选项。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 历史数据选择 | 0 | source | 0 - (默认) 自动； 1 - 历史； 2 - 趋势。 |
时间段
以下参数支持配置时间段。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 设置自定义时间段 | 0 | graph_time | 0 - (默认) 禁用； 1 - 启用。 |
| 从 | 1 | time_from | 有效的时间字符串，格式为YYYY-MM-DD hh:mm:ss。也支持相对时间段值（如 now，now/d，now/w-1w等）。默认值： now-1h。 |
| 到 | 1 | time_to | 有效的时间字符串值，格式为YYYY-MM-DD hh:mm:ss。也支持相对时间段值（如 now，now/d，now/w-1w等）。默认值： now。 |
坐标轴
以下参数支持配置坐标轴。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 左Y轴 | 0 | lefty | 0 - 禁用； 1 - (默认) 启用。 如果Y轴（在数据集配置中）设置为"左"，则此参数可用。 |
| 右Y轴 | 0 | righty | 0 - (默认) 禁用； 1 - 启用。 如果Y轴（在数据集配置中）设置为"右"，则此参数可用。 |
| 最小值 | 1 | lefty_min | 任何数值。 默认值： ""（空）。 |
| righty_min | |||
| 最大值 | 1 | lefty_max | 任何数值。 默认值： ""（空）。 |
| righty_max | |||
| 单位（类型） | 0 | lefty_units | 0 - (默认) 自动； 1 - 静态。 |
| righty_units | |||
| 单位（值） | 1 | lefty_static_units | 任何字符串值。 默认值： ""（空）。 |
| righty_static_units | |||
| X轴 | 0 | xaxis | 0 - 禁用； 1 - (默认) 启用。 |
图例
以下参数支持配置图例。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 显示图例 | 0 | legend | 0 - 禁用； 1 - (默认) 启用。 |
| 行数 | 0 | legend_lines | 有效值范围从1-5。 默认值：1。 |
问题
以下参数支持配置问题。
| 参数 | 类型 | 名称 | 值 | |
|---|---|---|---|---|
| 显示问题 | 0 | show_problems | 0 - (默认) 禁用； 1 - 启用。 |
|
| 仅选定项 | 0 | graph_item_problems | 0 - 禁用； 1 - (默认) 启用。 |
|
| 问题主机 | 1 | problemhosts.0 | 主机 名称。 注意：属性名称中的数字引用了配置的主机。 要配置多个主机，请为每个主机创建一个仪表板小部件字段对象。 |
|
| 严重性 | 0 | severities | 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 平均； 4 - 高； 5 - 灾难。 默认值：空（全部启用）。 注意：要配置多个值，请为每个值创建一个仪表板小部件字段对象。 |
|
| 问题 | 1 | problem_name | 问题事件名称（不区分大小写，全名或部分名称）。 | |
| 标签（属性名称中的数字（例如tags.tag.0）引用标签评估列表中的标签顺序） | ||||
| 评估类型 | 0 | evaltype | 0 - (默认) 与/或； 2 - 或。 |
|
| 标签名称 | 1 | tags.tag.0 | 任何字符串值。 如果配置标签，则需要参数标签名称。 |
|
| 操作符 | 0 | tags.operator.0 | 0 - 包含； 1 - 等于； 2 - 不包含； 3 - 不等于； 4 - 存在； 5 - 不存在。 如果配置标签，则需要参数操作符。 |
|
| 标签值 | 1 | tags.value.0 | 任何字符串值。 如果配置标签，则需要参数标签值。 |
|
覆盖设置
以下参数支持配置覆盖设置。
属性名中的第一个数字（例如，or.hosts.0.0，or.items.0.0）表示特定的数据集， 如果存在第二个数字，则表示已配置的主机或监控项。
| 参数 | 类型 | 名称 | 值 |
|---|---|---|---|
| 主机模式 (必填项) |
1 | or.hosts.0.0 | 主机名称或模式（例如，Zabbix*）。 |
| 监控项模式 (必填项) |
1 | or.items.0.0 | 监控项名称或模式（例如，*: Number of processed *values per second）。 |
| 基础颜色 | 1 | or.color.0 | 十六进制颜色代码（例如，FF0000）。 |
| 宽度 | 0 | or.width.0 | 有效值范围从1-10。 |
| 绘制方式 | 0 | or.type.0 | 0 - 线条； 1 - 点； 2 - 阶梯； 3 - 条形。 |
| 透明度 | 0 | or.transparency.0 | 有效值范围从1-10。 |
| 填充 | 0 | or.fill.0 | 有效值范围从1-10。 |
| 点大小 | 0 | or.pointsize.0 | 有效值范围从1-10。 |
| 缺失数据 | 0 | or.missingdatafunc.0 | 0 - 无； 1 - 连接； 2 - 当作0处理。 |
| Y轴 | 0 | or.axisy.0 | 0 - 左侧； 1 - 右侧。 |
| 时间偏移 | 1 | or.timeshift.0 | 有效的时间字符串（例如，3600，1h等）。您可以使用时间后缀。允许使用负值。 |
示例
以下示例旨在仅描述图表仪表盘小部件的字段对象配置。 有关配置仪表盘的更多信息，请参阅dashboard.create。
配置图表小部件
按以下方式配置图表小部件：
- 一个主机上的总共9个监控项分为4个数据集。
- 每个数据集由一条具有自定义颜色、宽度、透明度和填充的线条组成。
- 数据集4配置了聚合。
- 图表中的数据显示过去3小时的时间段。
- 图表中的问题仅针对配置的监控项显示。
- 图表有两个Y轴，其中右侧Y轴仅显示数据集4的值。
- 图表图例以2行显示配置的监控项。
请求：
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "svggraph",
"name": "Graph",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.hosts.0.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.0.0",
"value": "Zabbix server: Utilization of poller data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.0",
"value": "FF0000"
},
{
"type": 0,
"name": "ds.width.0",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.0",
"value": 3
},
{
"type": 0,
"name": "ds.fill.0",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.1.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.1.0",
"value": "Zabbix server: Utilization of trapper data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.1",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.width.1",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.1",
"value": 3
},
{
"type": 0,
"name": "ds.fill.1",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.2.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.2.0",
"value": "Zabbix server: Utilization of history syncer internal processes, in %"
},
{
"type": 1,
"name": "ds.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.width.2",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.2",
"value": 3
},
{
"type": 0,
"name": "ds.fill.2",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.3.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.3.0",
"value": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.color.3",
"value": "000000"
},
{
"type": 0,
"name": "ds.transparency.3",
"value": 0
},
{
"type": 0,
"name": "ds.fill.3",
"value": 0
},
{
"type": 0,
"name": "ds.axisy.3",
"value": 1
},
{
"type": 0,
"name": "ds.aggregate_function.3",
"value": 3
},
{
"type": 1,
"name": "ds.aggregate_interval.3",
"value": "1m"
},
{
"type": 0,
"name": "ds.aggregate_grouping.3",
"value": 1
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_from",
"value": "now-3h"
},
{
"type": 0,
"name": "legend_lines",
"value": 2
},
{
"type": 0,
"name": "show_problems",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}响应: