服务 object

以下 objects 直接与 service API 相关。

服务

服务 object 具有以下属性。

属性 数据类型 描述
serviceid ID 服务的 ID。

属性行为:
- 只读
- 对于 update 操作是必填
algorithm integer 状态计算规则。仅在存在子服务时适用。

可能的值:
0 - 将状态设置为 OK;
1 - 如果所有子服务都有问题,则为最关键状态;
2 - 子服务中的最关键状态。

属性行为:
- 对于 create 操作是必填
name string 服务的名称。

属性行为:
- 对于 create 操作是必填
sortorder integer 用于排序的服务位置。

可能的值:0-999。

属性行为:
- 对于 create 操作是必填
weight integer 服务权重。

可能的值:0-1000000。

默认值:0。
propagation_rule integer 状态传播规则。

可能的值:
0 - (默认) 按原样传播服务状态 - 不做任何更改;
1 - 按给定的 propagation_value 提高传播状态(从 1 到 5 严重级别);
2 - 按给定的 propagation_value 降低传播状态(从 1 到 5 严重级别);
3 - 忽略此服务 - 状态根本不会传播到父服务;
4 - 使用给定的 propagation_value 设置固定服务状态。

属性行为:
- 如果设置了 propagation_value 则为必填
propagation_value integer 状态传播值。

如果 propagation_rule 设置为 "0" 或 "3",可能的值:
0 - 未分类。

如果 propagation_rule 设置为 "1" 或 "2",可能的值:
1 - 信息;
2 - 警告;
3 - 平均;
4 - 高;
5 - 灾难。

如果 propagation_rule 设置为 "4",可能的值:
-1 - 正常;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 平均;
4 - 高;
5 - 灾难。

属性行为:
- 如果设置了 propagation_rule 则为必填
status integer 服务是否处于正常或问题状态。

如果服务处于问题状态,status 等于以下之一:
- 最关键问题的严重性;
- 处于问题状态的子服务的最高状态。

如果服务处于正常状态,status 等于:-1。

属性行为:
- 只读
description string 服务的描述。
uuid string 通用唯一标识符,用于将导入的服务链接到已存在的服务。如果不提供则自动生成。
created_at integer 服务创建时的 Unix 时间戳。
readonly boolean 对服务的访问权限。

可能的值:
0 - 读写;
1 - 只读。

属性行为:
- 只读

状态规则

状态规则 object 具有以下属性。

属性 数据类型 描述
type integer 设置(新状态)状态的条件。

可能的值:
0 - 如果至少有 (N) 个子服务处于 (状态) 或更高级别状态;
1 - 如果至少有 (N%) 的子服务处于 (状态) 或更高级别状态;
2 - 如果少于 (N) 个子服务处于 (状态) 或更低级别状态;
3 - 如果少于 (N%) 的子服务处于 (状态) 或更低级别状态;
4 - 如果处于 (状态) 或更高级别状态的子服务权重至少为 (W);
5 - 如果处于 (状态) 或更高级别状态的子服务权重至少为 (N%);
6 - 如果处于 (状态) 或更低级别状态的子服务权重小于 (W);
7 - 如果处于 (状态) 或更低级别状态的子服务权重小于 (N%)。

其中:
- N (W) 是 limit_value
- (状态) 是 limit_status
- (新状态) 是 new_status

属性行为
- 必填
limit_value integer 限制值。

可能的值:
- 对于 N 和 W:1-100000;
- 对于 N%:1-100。

属性行为
- 必填
limit_status integer 限制状态。

可能的值:
- 1 - 正常;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。

属性行为
- 必填
new_status integer 新状态值。

可能的值:
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。

属性行为
- 必填

服务标签

服务标签 object 具有以下属性。

属性 数据类型 描述
tag string 服务标签名称。

属性行为:
- 必填
value string 服务标签值。

服务告警

服务告警无法通过 Zabbix API 直接创建、更新或删除。

服务告警 objects 表示服务状态的变化。它具有以下属性:

属性 数据类型 描述
clock timestamp 服务状态变化发生的时间。
value integer 服务的状态。

有关可能值的列表,请参阅 service status property

问题标签

问题标签允许将服务与问题事件关联。问题标签 object 具有以下属性。

属性 数据类型 描述
tag string 问题标签名称。

属性行为:
- 必填
operator integer 映射条件运算符。

可能的值:
0 - (默认) 等于;
2 - 类似。
value string 问题标签值。