调用监控对象工具
诊断分析
调用监控对象工具
在单个监控对象上并发调用至多 8 个 monit-agent 工具。结果按入参 tools 数组顺序返回。长耗时——单个工具在 Agent 上有自己的超时,整体请求可能耗时数十秒。
POST
调用监控对象工具
调用限制
| 项 | 值 |
|---|---|
| 速率限制 | 600 次/分钟;10 次/秒 每账户 |
| 权限 | 任意有效的 app_key(只读;不受特定权限分类约束) |
使用说明
- 单次调用至多 8 个工具(
MaxToolsPerInvoke);超出需在客户端拆分。8 个工具的上限与单监控对象 Agent 的并发能力对齐。 - 工具在 Agent 上并行执行;webapi 返回的
results[]与请求中的tools[]顺序对齐。 - 长耗时:客户端超时至少设置 35 秒。该接口面向 AI-SRE / 人工排障流程,不适用于交互式 UI。
- 请求级错误(
target_unavailable、ambiguous_target_kind、unknown_toolset_hash、forward_failed)以 HTTP 200 返回,data.error不为空,data.results = []。 - 单工具失败以 HTTP 200 返回,
data.error = null,results[i].error被填充——务必同时检查三层(外层信封error、data.error、再到每个results[i].error)。 - 每条结果带两个耗时字段:
agent_elapsed_ms(Agent 自报,不含网络)与e2e_elapsed_ms(webapi 观测的端到端)。两者差距较大表示网络 / 边缘侧慢,而非工具执行慢。 - 按
/monit/tools/catalog返回的input_schema构造tools[].params。对于无参工具,务必显式传params: {}。
授权
在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。
请求体
application/json