2022 Zabbix中国峰会
2022 Zabbix中国峰会

SLA 对象

以下对象与 sla (服务水平协议) API 直接相关。

SLA

SLA 对象具有以下属性.

属性 类型 描述
slaid ID SLA 的 ID。

属性行为:
- 只读
- 必填 更新操作
name 字符串 SLA 的名称.

属性行为:
- 必填 创建操作
period 整型 SLA 的报告周期。

可能的值:
0 - 每天;
1 - 每周;
2 - 每月;
3 - 每季度;
4 - 每年.

属性的行为:
- 必填 创建操作
slo 浮点数 使用百分比表示可接受的最低服务水平目标。如果服务水平指标(SLI)降至更低的水平,则认为 SLA 处于问题/未满足状态。

可能的值: 0-100 (最多4位小数).

属性行为:
- 必填 创建操作
effective_date 整型 SLA 的生效时间。

可能的值: UTC日期时间戳。
timezone 字符串 报告时区, 比如: Europe/LondonUTC

时区的完整支持列表请参考 PHP 时区文档.

属性行为:
- 必填 对于创建操作
status 整型 SLA 的状态。

可能的值:
0 - (默认值) 关闭 SLA;
1 - 打开 SLA。
description 字符串 SLA 的描述。

SLA 时间表

SLA 调度对象定义了被调度的处于连接状态的服务(如果有的话)在正常运行期间的时间段。 它具有以下属性。

属性 类型 描述
period_from 整型 每周重复周期的开始时间(包含)。

可能的值: 以秒为单位的数值(从星期日开始计算)。

属性行为:
- 必填
period_to 整型 每周重复周期的结束时间(不包含)。

可能的值: 以秒为单位的数值(从星期日开始计算)。

属性行为:
- 必填

SLA 排除停机时间

排除的停机对象定义了计划内停机时间,这些时间不会影响 SLI 的计算,比如正在进行的计划内维护。 它具有如下属性。

属性 类型 描述
name 字符串 排除的停机时间的名称.

属性行为:
- 必填
period_from 整型 排除的停机时间的开始时刻 (包含)。

可能的值: timestamp.

属性行为:
- 必填
period_to 整型 排除的停机时间的结束时刻 (不包含).

可能的值: timestamp.

属性行为:
- 必填

SLA 服务标签

SLA 服务标签对象将服务与 SLA 计算关联起来。 它具有如下属性。

属性 类型 描述
tag 字符串 SLA 服务标签名称.

属性行为:
- 必填
operator 整型 SLA 服务标签操作.

可能的值:
0 - (默认) 等于;
2 - 包含。
value 字符串 SLA 服务标签的值。