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

> Service object服务对象

The following objects are directly related to the service API以下对象与 service API直接相关.

Service服务

The service object has the following properties服务对象具有以下属性.

Property参数 T pe类型 Des ription说明
serviceid string (readonly只读) ID of the service服务的ID.
algorithm
(required必要)
integer
Algorithm used to calculate the state of the service用于计算服务状态的算法.
Possible values可能的值为:
0 - do not calculate不计算;
1 - problem问题, if at least one child has a problem至少有一个问题;
2 - problem问题, if all children have problems都有问题.
name
(required必要)
string Name of the service服务的名称.
showsla
(required必要)
integer
Whether SLA should be calculated是否应计算SLA.
Possible values可能的值为:
0 - do not calculate不计算;
1 - calculate计算.
sortorder
(required必要)
integer Position of the service used for sorting用于排序服务的位置.
goodsla float Minimum acceptable SLA value. If the SLA drops lower, the service is considered to be in problem state最低可接受的SLA值,如果SLA降低,则该服务被认为处于问题状态.

Default: 99.9.
status integer (readonly只读) Whether the service is in OK or problem state服务是否处于OK或问题状态.

If the service is in problem state, status is equal either to如果服务处于问题状态,则status等于:
- the priority of the linked trigger if it is set to 2, "Warning" or higher (priorities 0, "Not classified" and 1, "Information" are ignored);链接触发器的优先级设置为2,"Warning"或更高(优先级0,"Not classified"和1,"Information"可忽略)
- the highest status of a child service in problem state处于问题状态的子服务的最高状态.

If the service is in OK state, status is equal to 0如果服务处于OK状态,则status等于0.
triggerid string Trigger associated with the service. Can only be set for services that don't have children. 与服务相关联的触发器,只能为无子服务设置

Default: 0

Service time服务时间

The service time object defines periods, when an service is scheduled to be up or down. It has the following properties.服务时间对象定义周期,当服务被调度为向上或向下时。它具有以下属性:

Property参数 T pe类型 Des ription说明
timeid string (readonly只读) ID of the service time服务时间的ID.
serviceid
(required必要)
string
ID of the service服务的ID.
Cannot be updated不能被更新.
ts_from
(required必要)
integer
Time when the service time comes into effect服务时间生效的时间.
For onetime downtimes ts_from must be set as a Unix timestamp一次宕机时间ts_from必须设置为Unix时间戳, for other types对于其他类型 - as a specific time in a week, in seconds, for example, 90000 for Tue, 2:00 AM.
ts_to
(required必要)
integer
Time when the service time ends.
For onetime uptimes ts_to must be set as a Unix timestamp, for other types - as a specific time in a week, in seconds, for example, 90000 for Tue, 2:00 AM.作为一周中的特定时间,以秒为单位,例如,星期二,上午2:00的90000
type
(required必要)
integer
Service time type服务时间类型.
Possible values可能的值是:
0 - planned uptime, repeated every week计划运行时间,每周重复;
1 - planned downtime, repeated every week; 计划停机,每周重复
2 - one-time downtime一次性停机.
note string Additional information about the service time有关服务时间的附加信息.

Service dependency服务依赖

The service dependency object represents a dependency between services. It has the following properties服务依赖对象表示服务之间的依赖关系,它具有以下属性.

Property参数 T pe类型 Des ription说明
linkid string (readonly只读) ID of the service dependency服务依赖关系的ID.
servicedownid
(required必要)
string ID of the service, that a service depends on, that is, the child service. An service can have multiple children. 服务依赖的服务ID,即子服务。 一个服务可以有多个子服务。
serviceupid
(required必要)
string ID of the service, that is dependent on a service, that is, the parent service. An service can have multiple parents forming a directed graph.服务的ID依赖服务,即父服务,服务可以有多个父级形成有向图
soft
(required必要)
integer
Type of dependency between services服务之间的依赖关系类型.
Possible values可能的值为:
0 - hard dependency硬依赖;
1 - soft dependency软依赖.

An service can have only one hard-dependent parent. This attribute has no effect on status or SLA calculation and is only used to create a core service tree. Additional parents can be added as soft dependencies forming a graph.一个服务只能有一个强依赖的父服务。该属性对状态或SLA计算没有影响,仅用于创建核心服务树。 新增的父服务可以作为形成图形的软依赖添加

An service can not be deleted if it has hard-dependent children.如果服务有硬依赖子服务,则无法删除该服务。

Service alarm服务告警

Service alrams cannot be directly created, updated or deleted via the Zabbix API不能通过Zabbix API直接创建,更新或删除服务告警.

The service alarm objects represents an service's state change. It has the following properties服务告警对象代表服务的状态变化,它具有以下属性.

Property参数 T pe类型 Des ription说明
servicealarmid string ID of the service alarm服务告警的ID.
serviceid string ID of the service服务的ID.
clock timestamp Time when the service state change has happened服务状态发生变化的时间.
value integer Status of the service服务状态.

Refer the the service status property for a list of possible values. 请参阅service status property以获取可能的值列表.