OWL¶
OWL은 Guance가 도구화 및 지능형 시나리오를 위해 제공하는 통합 기능 진입점으로, OWL CLI와 OWL MCP Server 두 가지 접속 형태를 지원합니다.
OWL을 통해 사용자는 Guance의 메트릭, 로그, 이벤트, 모니터, 대시보드, APM, RUM, 인프라 등의 기능을 통합된 방식으로 호출할 수 있습니다.
OWL은 Guance 콘솔과 Open API를 대체하지 않으며, 기존 기능 위에 도구 호출, 자동화 오케스트레이션 및 AI Agent 사용에 더 적합한 래핑 진입점을 제공합니다.
접속 방식 선택¶
| 사용 방식 | 선택 | 시작 지점 |
|---|---|---|
| Agent 대화에서 사용하며 Agent가 터미널 명령을 실행할 수 있는 경우 | OWL CLI + 전용 Skill | 통합 자동 설치 절차 |
| 터미널에서 수동으로 작업하거나 스크립트를 작성하거나 자동화 작업을 실행하는 경우 | OWL CLI | 수동 설치 → CLI 빠른 시작 |
| 클라이언트에 원격 서비스 주소를 입력하고 MCP 도구를 사용하는 경우 | OWL MCP Server | 클라이언트 설정 및 최초 호출 |
CLI는 실행 가능한 명령이고, owl-diagnostics Skill은 Agent가 CLI를 사용하도록 돕는 전용 가이드이며, MCP는 클라이언트가 원격 도구 서비스에 연결하는 또 다른 방식입니다. 원격 OWL MCP Server에 접속할 때는 클라이언트에 OWL CLI나 CLI 전용 Skill을 설치할 필요가 없습니다.
지원하는 Agent와 클라이언트¶
Codex, Claude Code, Cursor, Trae, GitHub Copilot(VS Code), Windsurf 등 터미널 실행 기능을 갖춘 Agent는 통합 절차에 따라 CLI를 사용할 수 있습니다. 위 제품과 Claude Desktop, Cherry Studio, OpenClaw, Hermes 등 Streamable HTTP 및 Bearer 요청 헤더 인증을 지원하는 클라이언트는 MCP 가이드에 따라 접속할 수 있습니다.
작동 방식¶
flowchart LR
user["사용자 / 스크립트"] --> cli["OWL CLI"]
agent["AI Agent"] --> cli
agent --> mcp["OWL MCP Server"]
cli --> owl["OWL 도구 카탈로그 및 실행 서비스"]
mcp --> owl
owl --> platform["Guance 플랫폼 기능"]
OWL CLI와 OWL MCP Server는 동일한 유형의 플랫폼 기능에 접근하지만, 서로 다른 접속 형태와 사용 사례를 대상으로 합니다.
| 접속 형태 | 사용 사례 | 핵심 기능 |
|---|---|---|
| OWL CLI | AI Agent, 로컬 명령줄, 스크립트 및 자동화 흐름 | 도구 카탈로그 동기화, 도구 설명 조회, 도구 실행, Agent Schema 내보내기 |
| OWL MCP Server | AI Agent, MCP 클라이언트 통합 | Model Context Protocol 기반의 표준화된 도구 서비스 인터페이스 제공 |
사용 사례¶
- 터미널에서 메트릭, 로그, 이벤트, 모니터, 대시보드 등의 정보 조회
- 권한이 부여된 워크스페이스 탐색 및 크로스 워크스페이스 쿼리를 통해 동일 대상 사이트 내 여러 권한이 부여된 워크스페이스의 데이터 조회
- 구현 및 납품 과정에서 고객 워크스페이스의 관측 가능성 기능을 신속하게 검증
- 독립 Profile을 사용하여 여러 계정 또는 환경을 저장하고, 터미널, 스크립트 또는 Agent에 대해 접근 ID를 명확히 선택
- Guance 기능을 MCP를 지원하는 AI 클라이언트에 연동
- Agent가 자연어를 기반으로 Guance의 조회, 분석 및 관리 도구를 호출
- 동일 조직 워크스페이스 목록(same-org)과 전용 크로스 워크스페이스 Trace 조회 도구(
owl.data.same_org.trace.query), SLO 목록(owl.slo.list), 문서 검색(mdsearch) 등의 기능을 활용하여 크로스 워크스페이스 장애 대응 및 조회 수행
사용 제한¶
무료 플랜 워크스페이스에서도 개인 API Key를 통해 OWL을 사용할 수 있으며, 구체적인 기능은 여전히 워크스페이스 버전과 계정 권한에 따라 제한됩니다.
- DPoP 로그인은 선택한 계정 및 워크스페이스의 권한에 따라 리소스에 접근합니다. API Key를 사용하는 경우 접근 범위는 해당 Key에 따라 결정됩니다. 두 방식 모두 대상 도구에 대한 읽기 또는 쓰기 권한이 필요합니다.
- 쓰기 계열 도구는 대시보드 생성, 모니터 업데이트, 코멘트 추가 등 Guance의 리소스를 수정합니다.
- AI Agent 또는 MCP 클라이언트에 연동할 때는 쓰기 작업에 대해 인적 확인 또는 승인 메커니즘을 구성하여 예기치 않은 변경을 방지할 것을 권장합니다.
OWL을 통해 AI API를 호출하는 경우에도 트리거에 따라 계량되며, 모델 크레딧 소모와 별도로 집계됩니다.
바로가기¶
시나리오 1: CLI로 사용(Agent, 터미널 또는 스크립트)¶
Agent 대화에서 사용할 경우 자동 설치를 먼저 선택하고, 터미널에서 수동으로 작업하거나 스크립트를 작성할 경우 수동 설치와 CLI 빠른 시작을 선택합니다.
시나리오 2: MCP 클라이언트로 사용¶
클라이언트의 MCP 설정을 통해 원격 서비스에 연결하고 대화에서 도구를 호출하는 데 적합합니다.