服务 object
以下 objects 直接与 service API 相关。
服务
service 对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| serviceid | ID | service 的 ID。 Property behavior: - read-only - required for update operations |
| algorithm | integer | 状态计算规则。仅在存在子服务时适用。 Possible values: 0 - 将状态设为 OK； 1 - 如果所有子项都有问题，则取最严重的状态； 2 - 取子服务中最严重的状态。 Property behavior: - required for create operations |
| name | string | service 的名称。 Property behavior: - required for create operations |
| sortorder | integer | 用于排序的 service 位置。 Possible values: 0-999. Property behavior: - required for create operations |
| weight | integer | service 权重。 Possible values: 0-1000000. Default: 0. |
| propagation_rule | integer | 状态传播规则。 Possible values: 0 - (default) 按原样传播 service 状态，不做任何更改； 1 - 按给定的 propagation_value 增加传播后的状态（增加 1 到 5 个严重级别）；2 - 按给定的 propagation_value 降低传播后的状态（降低 1 到 5 个严重级别）；3 - 忽略此 service - 状态根本不会传播到父 service； 4 - 使用给定的 propagation_value 设置固定的 service 状态。Property behavior: - required if propagation_value is set |
| propagation_value | integer | 状态传播值。 Possible values if propagation_rule is set to "0" or "3":0 - 未分类。 Possible values if propagation_rule is set to "1" or "2":1 - 信息； 2 - 警告； 3 - 一般； 4 - 严重； 5 - 灾难。 Possible values if propagation_rule is set to "4":-1 - OK； 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 严重； 5 - 灾难。 Property behavior: - required if propagation_rule is set |
| status | integer | service 处于 OK 还是问题状态。 如果 service 处于问题状态， status 等于最严重问题的严重级别，或处于问题状态的子 service 的最高状态。如果 service 处于 OK 状态， status 等于 -1。Property behavior: - read-only |
| description | string | service 的描述。 |
| uuid | string | 通用唯一标识符，用于将导入的 service 与已存在的 service 关联。如果未提供，则自动生成。 |
| created_at | integer | service 创建时的 Unix 时间戳。 |
| readonly | integer | 对 service 的访问权限。 Possible values: 0 - 读写； 1 - 只读。 Property behavior: - read-only |
状态规则
状态规则对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| type | integer | 设置（新状态）状态的条件。 可能的值： 0 - 如果至少有 (N) 个子服务具有（状态）状态或更高； 1 - 如果至少有 (N%) 的子服务具有（状态）状态或更高； 2 - 如果少于 (N) 个子服务具有（状态）状态或更低； 3 - 如果少于 (N%) 的子服务具有（状态）状态或更低； 4 - 如果具有（状态）状态或更高的子服务权重至少为 (W)； 5 - 如果具有（状态）状态或更高的子服务权重至少为 (N%)； 6 - 如果具有（状态）状态或更低的子服务权重小于 (W)； 7 - 如果具有（状态）状态或更低的子服务权重小于 (N%)。 其中： - N (W) 为 limit_value；- (Status) 为 limit_status；- (New status) 为 new_status。Property behavior: - required |
| limit_value | integer | 限制值。 可能的值： - 对于 N 和 W：1-100000； - 对于 N%：1-100。 Property behavior: - required |
| limit_status | integer | 限制状态。 可能的值： -1 - OK； 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 高； 5 - 灾难。 Property behavior: - required |
| new_status | integer | 新状态值。 可能的值： 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 高； 5 - 灾难。 Property behavior: - required |
服务标签
service tag 对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| tag | string | 服务标签名称。 Property behavior: - required |
| value | string | 服务标签值。 |
服务告警
无法通过 Zabbix API 直接创建、更新或删除服务告警。
服务告警对象表示服务状态的变更。 它具有以下属性。
| Property | Type | Description |
|---|---|---|
| clock | timestamp | 服务状态变更发生的时间。 有关可能值的列表，请参阅 service status property。 |
| value | integer | 服务的状态。 |
问题标签
问题标签可用于将服务与问题事件关联。 问题标签对象具有以下属性。