任务对象

以下对象直接与taskAPI相关。

任务

任务对象具有以下属性:

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

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

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

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

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

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

属性行为:
- 只读
ttl 整数 任务过期的时间(秒)。

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

属性行为:
- 支持 如果type设置为"诊断信息"或"刷新proxy配置"
request 对象 根据任务类型的任务请求对象:
“立即执行”任务的对象详细描述如下
“刷新proxy配置”任务的对象详细描述如下
“诊断信息”任务的对象详细描述如下

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

属性行为:
- 只读

“立即执行”请求对象

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

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

'刷新proxy配置'请求对象

'刷新proxy配置'任务请求对象具有以下属性。

属性 类型 描述
proxyids 数组 Proxy ID。

'Diagnostic information' 请求对象

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

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

统计请求对象用于定义应收集有关server/proxy内部流程的何种类型的信息。它具有以下属性。

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

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

示例:{ “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/对象 根据特定诊断信息任务的统计请求对象的结果。
如果执行任务时发生错误,则包含错误消息字符串。