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

任务对象

以下对象直接与 task API相关。

任务对象有下列属性:

属性 类型 描述
taskid ID 任务的 ID 。

属性行为:
- 只读
type integer 任务的类型。

可能的值:
1 - 诊断信息;
2 - 刷新代理配置;
6 - 立即执行.

属性行为:
- 必需
status integer 任务的状态。

可能的值:
1 - 新的任务;
2 - 正在进行的任务;
3 - 任务已完成;
4 - 任务已过期.

属性行为:
- 只读
clock timestamp 任务被创建的时间。

属性行为:
- 只读
ttl integer 任务过期的时间,单位是秒。

属性行为:
- 只读
proxyid ID 关于收集诊断信息统计的代理ID。

属性行为:
- 支持 ,如果 type 被设置为 "诊断信息" 或者 "刷新代理配置"
request object 根据任务类型的任务请求对象:
'立即执行' 任务的对象是 详细描述如下;
'刷新代理配置' 任务的对象是 详细描述如下;
'诊断信息' 任务的对象是 详细描述如下.

属性行为:
- 必需
result object 诊断信息任务的结果对象。
如果结果尚未准备好,可能包含NULL。
结果对象是 详细描述如下.

属性行为:
- 只读

'立即执行' 请求对象

'立即执行' 任务请求对象具有以下属性。

属性 类型 描述
itemid ID 监控项和低级别发现规则的 ID。

'刷新代理配置' 请求对象

'刷新代理配置' 任务请求对象有如下属性。

属性 类型 描述
proxyids array 代理的 ID。

'诊断信息' 请求对象

诊断信息任务请求对象具有以下属性。所有类型属性的统计请求对象详细描述如下.

属性 类型 描述
historycache object 历史缓存统计请求。可用于服务端和代理端。
valuecache object 监控项缓存统计请求。可用于服务端。
preprocessing object 预处理管理器统计请求。可用于服务端和代理端。
alerting object 告警管理器统计请求。可用于服务端。
lld object LLD 管理器统计请求。可用于服务端。

统计请求对象

统计请求对象用于定义应收集关于服务端/代理端内部进程的类型信息。它具有以下属性。

属性 类型 描述
stats query 要返回的统计对象属性。
每种类型的诊断信息统计可用字段的 详细列表如下.

默认: extend 将返回所有可用的统计字段。
top object 用于排序和限制返回的统计值的对象。
每种诊断信息统计类型可用字段的 详细列表如下.

示例: { “source.alerts”: 10 }
每种诊断信息请求类型可用的统计字段列表

对于每种诊断信息请求属性,可以请求以下统计字段。

诊断类型 可用字段 描述
historycache items 缓存的监控项数量。
values 缓存的值的数量。
memory 共享内存统计 (空闲空间、已使用块的数量、空闲块的数量、空闲块的最大尺寸)。
memory.data 历史数据缓存的共享内存统计。
memory.index 历史数据索引缓存的共享内存统计。
valuecache items 缓存的监控项数量
values 缓存的值的数量。
memory 共享内存统计 (空闲空间、已使用块的数量、空闲块的数量、空闲块的最大尺寸)。
mode 数值缓存模式。
preprocessing values 队列里值的数量。
preproc.values 带有预处理步骤的队列里值的数量。
alerting alerts 队列里告警的数量。
lld rules 队列里规则的数量。
values 队列里值的数量。
每种诊断信息请求类型可用的排序字段列表

以下统计字段可用于对请求的信息进行排序和限制。

诊断类型 可用的字段 类型
historycache values integer
valuecache values integer
request.values integer
preprocessing values integer
alerting media.alerts integer
source.alerts integer
lld values integer

统计结果对象

统计结果对象存储在任务对象的 result 字段中。

属性 类型 描述
status integer 任务结果的状态。

可能的值:
-1 - 执行任务时发生错误;
0 - 任务结果已创建。

属性行为:
- 只读
data string/object 根据特定诊断信息任务的统计请求对象的结果。
如果执行任务时发生错误,此字段包含错误消息字符串。