任务对象

以下 objects 直接与 task API 相关。

任务

任务 object 具有以下属性:

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

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

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

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

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

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

属性行为:
- 只读
ttl integer 任务过期前的秒数。

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

属性行为:
- 如果 type 设置为 "Diagnostic information" 或 "Refresh proxy configuration",则 支持
request object 根据任务类型确定的任务请求 object:
'Execute now' 任务的 object 是 立即检查请求-object
'Refresh proxy configuration' 任务的 object 是 described in detail below
'Diagnostic information' 任务的 object 是 诊断信息请求-object

属性行为:
- 必填
result object 诊断信息任务的结果 object。
如果结果尚未就绪,可能包含 NULL。
结果 object 是 统计结果-object

属性行为:
- 只读

'立即执行'请求对象

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

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

'刷新 proxy 配置'请求对象

“刷新 proxy 配置”任务请求 object 具有以下属性。

属性 数据类型 描述
proxyids array Proxy ID。

'诊断信息'请求对象

诊断信息任务请求 object 具有以下属性。所有类型属性的统计请求 object 的说明请参见 统计请求-object

属性 数据类型 描述
historycache object history cache 统计请求。适用于服务器和 proxy。
valuecache object 监控项 缓存统计请求。适用于服务器。
preprocessing object 预处理管理器统计请求。适用于服务器和 proxy。
alerting object 告警管理器统计请求。适用于服务器。
lld object LLD 管理器统计请求。适用于服务器。
统计请求对象

统计请求 object 用于定义应收集哪些有关 server/proxy 内部进程的信息。它具有以下属性。

属性 数据类型 描述
stats query 要返回的统计 object 属性。
每种诊断信息统计类型的可用字段列表见 每种诊断信息请求类型可用的统计字段列表

默认值:extend 将返回所有可用的统计字段。
top object 用于对返回的统计值进行排序和限制的 object。
每种诊断信息统计类型的可用字段列表见 每种诊断信息请求类型可用的排序字段列表

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

以下统计字段可以按每种诊断信息请求属性进行请求。

诊断类型 可用字段 描述
historycache 监控项 缓存的 监控项 数量。
values 缓存值的数量。
memory 共享 memory 统计信息(空闲空间、已使用块数量、空闲块数量、最大空闲块大小)。
memory.data 历史数据缓存共享 memory 统计信息。
memory.index 历史 index cache 缓存共享 memory 统计信息。
valuecache 监控项 缓存的 监控项 数量。
values 缓存值的数量。
memory 共享 memory 统计信息(空闲空间、已使用块数量、空闲块数量、最大空闲块大小)。
mode value cache 模式。
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
统计结果对象

统计结果 object 会在任务 object 的 result 字段中检索到。

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

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

属性行为
- 只读
data string/object 根据特定诊断信息任务的统计请求 object 得到的结果。
如果执行任务期间发生错误,则包含错误信息 string。