OWL CLI

一条指令，让 Agent 操作观测云

复制安装指令给 AI Agent，替换工作空间 Endpoint 和临时授权码，即可完成 OWL CLI、Owl Skill、认证配置与工具目录同步。

复制以下内容到 AI 工具的对话窗口中执行，先按站点选择 Endpoint，再替换临时授权码：

阅读 https://static.guance.com/owl/skill.md ，按照文档在当前环境中安装并配置 Owl CLI 和 Owl Skill。

安装参数如下：
OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
OWL_TEMP_CODE="<YOUR_TEMP_CODE>"

OWL_REGISTRY_ENDPOINT 不在控制台生成，请按工作空间所属站点在安装文档的 Endpoint 表格中选择；OWL_TEMP_CODE 才是在观测云控制台「个人 API 密钥」页面生成。

Linux / macOS 手动安装命令，先按站点选择 Endpoint，再替换临时授权码：

export OWL_INSTALL_BASE_URL="https://static.guance.com/owl"
export OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
export OWL_TEMP_CODE="<YOUR_TEMP_CODE>"
bash -c "$(curl -fsSL "${OWL_INSTALL_BASE_URL}/install.sh")" -- --yes

立即查看安装文档了解 CLI 详情

支持所有主流 AI Agent 工具

Claude Code

Codex

Cursor

Trae

GitHub Copilot

Windsurf

可观测核心能力

覆盖观测云核心数据域与动作，支持个人和企业级场景，持续快速迭代。

数据查询

查询日志、指标、链路、事件、RUM 等数据

数据洞察

多维分析、关联分析、根因定位、趋势洞察

监控与告警

管理监控、告警规则，查看告警状态

资源与拓扑

查看服务拓扑、主机资源、依赖关系

配置与平台

管理仪表盘、看板、数据源、集成

仪表盘与看板

创建、查询、分享仪表盘和看板

真实场景

把值班、排障和巡检里真实会发生的动作交给 Agent 执行，工程师保留参数、证据和结论审查权。

线上服务突然 5xx 升高

值班同学：查一下 prod /checkout 近 30 分钟错误来源

Agent 通过 OWL CLI 查询日志、Trace 与 RUM 错误，按服务、接口和版本汇总影响面。

告警5xx 突增

→

查询日志 + Trace

→

结论定位异常版本

官网转化与漏斗分析

增长同学：分析首页 → 计费页 → 联系我们的转化漏斗

Agent 拉取页面访问、RUM 点击与业务事件，按来源、设备和路径拆解流失节点，输出可执行的转化优化建议。

路径高意向页面

→

漏斗流失节点

→

结论优化机会

每日自动巡检

SRE：每天 9 点检查核心服务错误、慢接口和告警恢复状态

脚本或 Agent 定时调用 OWL CLI，同步核心指标并沉淀日报。

巡检核心服务

→

筛选异常变化

→

沉淀日报摘要

更多内容

观测云 MCP Server

让支持 MCP 的 AI 客户端调用授权观测能力。

AI Agent 可观测

追踪智能体会话、Trace、工具调用、Token 消耗和风险事件。

可编程性

用 DQL、OpenAPI 和 DataFlux Func 扩展可观测分析流程。

常见问题

OWL CLI 只是命令行工具吗？

不是。OWL CLI 首先是工程师可直接使用的命令行入口，同时也可以作为 AI Agent 调用观测云能力的工具层。它的价值在于把查询、诊断和上下文整理组织成统一、可执行、可审查的工具目录。

OWL CLI 可以让 AI Agent 调用哪些观测云能力？

可用能力取决于工具目录、配置和 API Key 权限。典型场景包括日志、指标、链路、事件、RUM、APM、基础设施、监控器、仪表盘等观测对象的查询、诊断和上下文整理，也包括监控与告警、资源与拓扑、配置与平台、仪表盘与看板等操作。

如何快速安装 OWL CLI？

可以从自动安装文档开始。按照文档在当前环境中安装并配置 OWL CLI 和 OWL Skill，完成连接后即可用命令行或 AI Agent 工作流调用观测云能力。

OWL CLI 和观测云 MCP Server 是什么关系？

OWL CLI 更像本地命令与工具执行层，适合工程师终端、脚本和 Agent 工作流；观测云 MCP Server 更像协议桥梁，适合把观测云能力接入支持 MCP 的 AI 客户端。两者可以组合使用，共同服务 AI 辅助排障。

相关阅读

LLM 可观测：看清模型调用、Token 成本与 Trace 链路

从模型请求、Prompt、响应耗时、错误和成本入手，建立大模型应用的可观测分析入口。

AI Agent 可观测接入指南：从应用创建到调用分析

AI Agent 可观测接入指南：从应用创建到调用分析

了解 Agent 监测应用、LLM 监测应用、Session 列表、Trace 列表和风险事件分析。

OWL CLI：把观测云诊断能力接入命令行与 AI Agent 工作流

OWL CLI：把观测云诊断能力接入命令行与 AI Agent 工作流

把日志、指标、链路、事件、RUM 和基础设施查询组织成可执行、可审查的诊断流程。

MCP Server 快速开始：把观测云上下文接入 AI 客户端

MCP Server 快速开始：把观测云上下文接入 AI 客户端

通过 Model Context Protocol 连接 AI IDE、桌面客户端和自动化 Agent，让建议基于授权观测数据。