OWL¶

OWL은 Guance가 도구화 및 지능화 시나리오를 위해 제공하는 통합 기능 진입점으로, OWL CLI와 OWL MCP Server 두 가지 방식으로 제공됩니다.

OWL을 통해 사용자는 통합된 방식으로 Guance의 메트릭, 로그, 이벤트, 모니터, 대시보드, APM, RUM, 인프라스트럭처 등의 기능을 호출할 수 있습니다.

OWL은 Guance 콘솔과 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["Guance 플랫폼 기능"]

OWL CLI와 OWL MCP Server는 동일한 플랫폼 기능에 접근하지만, 서로 다른 접근 방식과 사용 사례를 대상으로 합니다.

접근 방식	사용 사례	핵심 기능
OWL CLI	로컬 명령줄, 스크립트 및 자동화 워크플로우	도구 카탈로그 동기화, 도구 설명 보기, 도구 실행, Agent Schema 내보내기
OWL MCP Server	AI Agent, MCP 클라이언트 통합	Model Context Protocol 기반 표준화된 도구 서비스 인터페이스 제공

사용 사례¶

터미널에서 메트릭, 로그, 이벤트, 모니터, 대시보드 등의 정보 조회
구축 및 전달 과정에서 고객 워크스페이스의 관측 가능성 기능 빠르게 검증
Guance 기능을 MCP를 지원하는 AI 클라이언트에 연결
Agent가 자연어로 Guance의 조회, 분석 및 관리 도구를 호출하도록 지원
동일 조직 워크스페이스 목록(same-org) 및 전용 교차 워크스페이스 Trace 조회 도구(owl.data.same_org.trace.query), SLO 목록(owl.slo.list), 문서 검색(mdsearch) 등의 기능을 활용한 교차 워크스페이스 장애 해결 및 조회

제한 사항¶

OWL의 접근 권한은 사용된 API Key를 따릅니다. API Key가 접근 권한이 없는 리소스는 OWL도 접근할 수 없습니다.
쓰기 도구는 Guance의 리소스(예: 대시보드 생성, 모니터 업데이트, 댓글 추가 등)를 수정합니다.
AI Agent 또는 MCP 클라이언트에 연결할 때는 쓰기 작업에 대해 수동 확인 또는 승인 메커니즘을 구성하여 예상치 못한 변경을 방지하는 것이 좋습니다.