Sidebar

> 任务对象

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

任务对象具有以下属性:

属性 类型 描述
taskid string (只读) 任务的ID。
type
(必须)
integer 任务的类型.

可能的值:
1 - 诊断信息;
6 - 立即检查。
status integer (只读) 任务状态。

可能的值:
1 - 新任务;
2 - 进行中的任务;
3 - 已完成的任务;
4 - 过期的任务。
clock timestamp (只读) 任务创建时间。
ttl integer (只读) 任务过期时间(秒)。
proxy_hostid string 被统计诊断信息的代理ID。
不包含“立即检查”任务。
request
(必须)
object 根据任务类型的任务请求对象:
“立即检查”任务的对象为详细描述如下
“诊断信息”任务的对象为详细描述如下
result object (只读) 诊断信息任务的结果对象。如果结果还未准备好,可能会包含NULL。结果对象为详细描述如下

“立即检查”请求对象

“立即检查”任务请求对象具有以下属性。

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

“诊断信息”请求对象

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

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

统计请求对象

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

属性 类型 描述
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 结果根据特定诊断信息任务的统计请求对象。 如果在执行任务期间发生错误,则包含错误消息字符串。