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