Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

> 服务对象

以下对象与service API直接关联。

服务

服务对象有如下属性。

属性 类型 描述
serviceid string (只读) 服务ID。
algorithm
(必需)
integer 状态计算规则。仅用于子服务存在时。

可能的值:
0 - 设置状态为正常;
1 - 最严重的,如果所有子服务存在问题;
2 - 子服务中最严重者。
name
(required)
string 服务名称。
sortorder
(必需)
integer 用于排序的服务位置。

可能的值: 0-999.
weight integer 服务重量。

可能的值: 0-1000000.

Default: 0.
propagation_rule integer 状态传播规则。必须与propagation_value一起设置。

可能的值:
0 - (默认) 原始传播服务状态;
1 - 按照给定的propagation_value (按照1到5的严重性)增加传播状态;
2 - 按照给定的propagation_value (按照1到5的严重性)降低传播状态;
3 - 忽略服务 - 状态根本不会传播给父服务;
4 - 按照给定propagation_value设定固定服务状态。
propagation_value integer 状态传播值。必须和propagation_rule一起设置。

取值0和3的propagation_rule可能的值:0.

取值1和2的propagation_rule可能的值:1-5.

取值为4的propagation_rule可能的值:
-1 - 正常;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。
status integer (只读) 服务是正常或问题状态。

如果服务处于问题状态, status为以下其中一种:
- 最紧急问题的严重性;
- 处于问题状子服务的最高状态。

如果服务处于正常状态, status等于-1。
description string 服务描述。
uuid string 通用唯一标识符。 对更新操作,该字段是 只读
readonly boolean (只读) 服务的访问权限。

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

状态规则

状态规则对象有如下属性。

属性 类型 描述
type
(必需)
integer 设置(New status)状态的条件。

可能的值:
0 - 如果至少(N)个子服务处于(Status)或更高的状态;
1 - 如果至少(N%)的子服务处于(Status)或更高的状态;
2 - 如果不到(N)个子服务处于(Status)或更低状态;
3 - 如果不到(N%)的子服务处于(Status)或更低状态;
4 - 如果处于(Status)或更高状态的子服务的重量至少达到(W);
5 - 如果处于(Status)或更高状态的子服务的重量至少达到(N%);
6 - 如果处于(Status)或更低状态的子服务的重量低于(W);
7 - 如果处于(Status)或更低状态的子服务的重量低于(N%)。

其中:
- N (W) 是 limit_value
- (Status) 是 limit_status
- (New 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 - 灾难。

服务标记

服务标记对象有如下属性。

属性 类型 描述
tag
(必须)
string 服务标签名称。
value string 服务标签值。

服务告警

服务告警不能通过Zabbix API直接创建,更新或者删除 。

服务告警对象代表服务状态的变更。它有如下值:

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

可能值的清单请参考服务状态属性

问题标签

问题标签允许将服务和故障事件关联起来。问题标签对象有如下属性。

属性 类型 描述
tag
(必须)
string 问题标签名称。
operator integer 条件运算符映射。

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