OWL¶

Owl is the unified capability entry point provided by Guance for tooling and intelligent scenarios, supporting two access forms: Owl CLI and Owl MCP Server.

Through Owl, users can uniformly invoke capabilities within Guance such as Metrics, Logs, Events, Monitors, Dashboards, APM, RUM, and Infrastructure.

Owl does not replace the Guance console or Open API. Instead, it provides encapsulated entry points on top of existing capabilities that are more suitable for tool invocation, automated orchestration, and AI Agent usage.

How It Works¶

flowchart LR
  user["User / Script"] --> cli["Owl CLI"]
  agent["AI Agent / MCP Client"] --> mcp["Owl MCP Server"]
  cli --> owl["Owl Tool Catalog and Execution Service"]
  mcp --> owl
  owl --> platform["Guance Platform Capabilities"]

Owl CLI and Owl MCP Server access the same set of platform capabilities but are oriented towards different access methods and usage scenarios.

Access Form	Applicable Scenarios	Core Capabilities
Owl CLI	Local command line, scripts, and automated workflows	Synchronize tool catalog, view tool descriptions, execute tools, export Agent Schema
Owl MCP Server	AI Agent, MCP client integration	Provide standardized tool service interfaces based on the Model Context Protocol

Use Cases¶

Query information such as Metrics, Logs, Events, Monitors, and Dashboards in the terminal.
Quickly verify observability capabilities in a customer's workspace during implementation and delivery.
Integrate Guance capabilities into MCP-supported AI clients.
Enable Agents to invoke Guance query, analysis, and management tools based on natural language.
Leverage capabilities like cross-workspace lists within the same organization (same-org, using the same_org_workspace_uuids parameter for data queries, specifying up to 20 workspaces), SLO lists (owl.slo.list), and document retrieval (mdsearch) to conduct troubleshooting and queries across workspaces.

Usage Limits¶

Owl's access permissions follow the API Key used. Resources that the API Key does not have permission to access cannot be accessed by Owl.
Write-type tools will modify resources within Guance, such as creating dashboards, updating monitors, appending comments, etc.
When integrating with AI Agents or MCP clients, it is recommended to configure manual confirmation or approval mechanisms for write-type operations to avoid unintended changes.