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, LOG, 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 use by AI Agents.

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 & 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 use cases.

Access Form	Applicable Scenarios	Core Capabilities
Owl CLI	Local CLI, 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, LOG, events, monitors, and dashboards in the terminal.
Quickly verify observability capabilities in a customer's workspace during implementation and delivery.
Integrate Guance capabilities into AI clients that support MCP.
Enable Agents to invoke Guance query, analysis, and management tools based on natural language.

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, adding 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.