Documentation
Table of Contents
23 按严重性划分的问题
描述
这些参数以及相应仪表板 widget 字段的可能属性值 objects 允许在 dashboard.create 和 dashboard.update 方法中配置 Problems by severity widget。
widget fields 属性在仪表板创建或 update 期间不会进行验证。
这允许用户修改 built-in widgets 和 create custom widgets，但也带来了创建或更新部件时出错的风险。
为确保成功创建或 update 按严重性显示问题 部件，请参考下表中概述的参数行为。
参数
问题按严重性小部件支持以下参数。
| 参数 | 仪表板小部件字段 | 名称 | 值 | |
|---|---|---|---|---|
| Refresh interval | 0 | rf_rate | 0 - 不刷新； 10 - 10 秒； 30 - 30 秒； 60 - (默认) 1 分钟； 120 - 2 分钟； 600 - 10 分钟； 900 - 15 分钟。 |
|
| Host groups | 2 | groupids.0 | Host group ID。 注意：要配置多个 主机 组，请为每个 主机组 create 仪表板 widget 字段 object，并在属性名称中递增编号。 如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| 主机 组 (Widget) | 1 | groupids._reference | 替代 Host group ID：ABCDE._hostgroupids - 将 部件兼容性（其 Reference 参数设置为 "ABCDE"）设置为 主机 组的数据源。如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| Exclude host groups | 2 | exclude_groupids.0 | Host group ID。 注意：要排除多个 主机 组，请为每个 主机组 create 仪表板 widget 字段 object，并在属性名称中递增编号。 如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| Hosts | 3 | hostids.0 | Host ID。 注意：要配置多个 主机，请为每个 主机 create 仪表板 widget 字段 object，并在属性名称中递增编号。对于多个 主机，参数 主机 组 必须完全未配置，或者至少配置一个 主机组，这些 主机 必须属于该组。 如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| 主机 (Widget/Dashboard) | 1 | hostids._reference | 替代 Host ID：DASHBOARD.hostids - 将 覆盖主机 设置为 主机 的数据源；ABCDE._hostids - 将 部件兼容性（其 Reference 参数设置为 "ABCDE"）设置为 主机 的数据源。如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| Problem | 1 | problem | 问题 配置（不区分大小写，可以是全名或部分名称）。 | |
| Severity | 0 | severities.0 | 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 高； 5 - 灾难。 默认值：空（所有启用的）。 注意：要配置多个值，请为每个值 create 仪表板 widget 字段 object，并在属性名称中递增编号。 |
|
| Problem tags | ||||
| 评估类型 | 0 | evaltype | 0 - (默认) And/Or； 2 - Or。 |
|
| 标签名称 | 1 | tags.0.tag | 任意 string 值。 注意：属性名称中的数字引用标签评估列表中的标签顺序。 参数行为： - 必需 如果配置了 问题标签 |
|
| 运算符 | 0 | tags.0.operator | 0 - 包含； 1 - 等于； 2 - 不包含； 3 - 不等于； 4 - 存在； 5 - 不存在。 注意：属性名称中的数字引用标签评估列表中的标签顺序。 参数行为： - 必需 如果配置了 问题标签 |
|
| 标签值 | 1 | tags.0.value | 任意 string 值。 注意：属性名称中的数字引用标签评估列表中的标签顺序。 参数行为： - 必需 如果配置了 问题标签 |
|
| Show | 0 | show_type | 0 - (默认) 主机 组； 1 - 总计。 如果在 template dashboard 上配置 widget，则不支持此参数，默认设置为 "总计"。 |
|
| Layout | 0 | layout | 0 - (默认) 水平； 1 - 垂直。 参数行为： - 支持 如果 显示 设置为 "总计" |
|
| Show operational data | 0 | show_opdata | 0 - (默认) 无； 1 - 单独显示； 2 - 与问题名称一起显示。 |
|
| Show suppressed problems | 0 | show_suppressed | 0 - (默认) 禁用； 1 - 启用。 |
|
| Hide groups without problems | 0 | hide_empty_groups | 0 - (默认) 禁用； 1 - 启用。 参数行为： - 支持 如果 显示 设置为 "主机 组" 如果在 template dashboard 上配置 widget，则不支持此参数。 |
|
| Problem display | 0 | ext_ack | 0 - (默认) 所有； 1 - 仅未确认； 2 - 分开显示。 |
|
| Show timeline | 0 | show_timeline | 0 - 禁用； 1 - (默认) 启用。 |
|
| Reference | 1 | reference | 任意由 5 字符组成的 string 值（例如 ABCDE 或 JBPNL）。此值在 widget 所属的仪表板中必须唯一。参数行为： - 必需 |
|
示例
以下示例仅用于描述为 按严重性显示问题 小组件配置仪表板 widget 字段 objects 的过程。 有关配置仪表板的更多信息，请参见 dashboard.create。
配置 按严重程度分类的问题 部件
配置一个按严重性显示问题的小部件get，以显示所有主机组的问题总数。
执行请求:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "problemsbysv",
"name": "Problems by severity",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "show_type",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}响应：