OWL¶
Owl 是 观测云 面向工具化与智能化场景提供的统一能力入口，支持 Owl CLI 和 Owl MCP Server 两种接入形态。
通过 Owl，用户可以以统一方式调用观测云中的指标、日志、事件、监控器、仪表板、APM、RUM、基础设施等能力。
Owl 不替代观测云控制台和 Open API，而是在现有能力之上提供更适合工具调用、自动化编排和 AI Agent 使用的封装入口。
工作方式¶
flowchart LR
user["用户 / 脚本"] --> cli["Owl CLI"]
agent["AI Agent / MCP 客户端"] --> mcp["Owl MCP Server"]
cli --> owl["Owl 工具目录与执行服务"]
mcp --> owl
owl --> platform["观测云平台能力"]Owl CLI 和 Owl MCP Server 访问的是同一类平台能力，但面向不同的接入方式和使用场景。
| 接入形态 | 适用场景 | 核心能力 |
|---|---|---|
| Owl CLI | 本地命令行、脚本与自动化流程 | 同步工具目录、查看工具说明、执行工具、导出 Agent Schema |
| Owl MCP Server | AI Agent 、MCP 客户端集成 | 基于 Model Context Protocol 提供标准化工具服务接口 |
适用场景¶
- 在终端中查询指标、日志、事件、监控器、仪表板等信息
- 在实施交付过程中，快速验证客户工作空间中的可观测能力
- 将观测云能力接入支持 MCP 的 AI 客户端
- 让 Agent 基于自然语言调用观测云查询、分析和管理类工具
使用限制¶
- Owl 的访问权限跟随所使用的 API Key。API Key 没有权限访问的资源，Owl 也无法访问；
- 写入类工具会修改观测云中的资源，例如创建仪表板、更新监控器、追加评论等；
- 接入 AI Agent 或 MCP 客户端时，建议对写入类操作配置人工确认或审批机制，避免非预期变更。
快速入口¶
场景一：命令行操作¶
适合开发者、运维人员和实施交付人员手动执行查询和管理任务。
场景二：AI Agent 集成¶
适合将平台能力集成到大模型应用，实现自然语言交互。