以下对象都是与 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。 |
The 'Refresh proxy configuration' task request object has the following properties.
| Property | Type | Description |
|---|---|---|
| proxy_hostids | array | Proxy IDs. |
诊断信息任务请求对象有以下这些属性。 所有类型属性的统计请求对象详细描述如下。
| 属性 | 类型 | 描述 |
|---|---|---|
| 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 | 结果根据特定诊断信息任务的统计请求对象。 如果在执行任务期间发生错误,则包含错误消息字符串。 |