전화:400-882-3320
OWL CLI의 역할
설정한 자격 증명이 허용하는 도구를 노출하고 실행 전에 입력을 검토
OWL CLI는 Guance 콘솔이나 OpenAPI를 대체하지 않습니다. 카탈로그 동기화, Schema 검토, 쿼리, 지원 작업을 위한 도구 중심 진입점을 제공합니다. 도구 표시와 결과는 API Key 권한을 따르며 쓰기 도구는 워크스페이스 리소스를 변경하므로 명시적인 검토 또는 승인 단계를 유지해야 합니다.
터미널, 스크립트, 지원되는 AI Agent 도구에서 OWL 사용
클라이언트마다 기능과 설치 흐름이 다릅니다. OWL이 실행될 환경에 맞는 최신 설정 가이드를 확인하세요.
Claude Code
Codex
Cursor
Trae
GitHub Copilot
Windsurf실제 옵저버빌리티 업무를 위한 도구 카탈로그
카탈로그는 Guance에서 동기화되고 플랫폼 기능과 함께 변경됩니다. `owl list`와 `owl show`로 현재 워크스페이스에서 사용할 수 있는 도구, 매개변수, 권한을 확인하세요.
옵저버빌리티 데이터 조회
지원되는 메트릭, 로그, RUM, APM, 네트워크, Profiling, 비용 및 관련 데이터를 탐색하고 조회합니다.
DQL 워크플로 검증
DQL 가이드를 검색하고 완성된 쿼리를 검증한 뒤 의도한 데이터 범위에서 실행합니다.
이벤트와 인시던트 검토
권한이 부여된 도구가 제공하는 이벤트, 인시던트, 댓글, 작업 기록, 온콜 컨텍스트를 읽습니다.
리소스와 토폴로지 검토
카탈로그 엔터티, 인프라스트럭처 레코드, 상세 정보, 사용 가능한 관계를 조회합니다.
모니터와 SLO 작업
권한에 따라 지원되는 모니터 리소스를 조회하거나 관리하고 사용 가능한 SLO 컨텍스트를 확인합니다.
대시보드 작업
자격 증명에 필요한 권한이 있을 때 문서화된 대시보드 작업을 읽거나 실행합니다.
불투명한 답변이 아닌 검토 가능한 워크플로
구체적인 운영 질문에서 시작해 도구 호출과 매개변수를 보이게 유지하고, 반환된 근거와 최종 엔지니어링 판단을 구분하세요.
프로덕션 Endpoint의 5xx 응답이 갑자기 증가
온콜: 최근 30분 prod /checkout 오류 원인 확인
권한이 부여된 탐색 및 쿼리 도구로 관련 데이터 소스를 찾고 쿼리를 검증한 뒤 서비스, Endpoint, 환경, 버전별 로그 또는 Trace 근거를 비교합니다.
범위서비스와 시간
→
근거로그와 Trace
→
검토영향받은 버전
여러 워크스페이스에 걸친 Trace 조사
플랫폼 팀: 동일 조직 워크스페이스에서 이 Trace ID 찾기
지원되는 경우 워크스페이스 탐색과 전용 Trace 쿼리를 사용하고, 반환된 워크스페이스·서비스·Span 컨텍스트를 검토한 뒤 결론을 내립니다.
탐색워크스페이스
→
쿼리Trace 근거
→
검토서비스 경로
일일 운영 검토에 일관된 입력 필요
SRE: 매일 아침 핵심 서비스 오류, 느린 요청, 모니터 상태 확인
스크립트나 Agent가 읽기 전용 도구를 일정에 따라 호출하고 요약 초안을 만들 수 있습니다. 쿼리 시간 범위와 결과를 보존해 조치 전에 엔지니어가 변화를 검증하도록 합니다.
수집정의된 시그널
→
비교중요한 변화
→
검토요약 초안
관련 AI 및 플랫폼 기능
OWL CLI 자주 묻는 질문
OWL CLI란 무엇인가요?
Guance의 명령줄 진입점으로, 도구 카탈로그를 동기화하고 도구 설명과 Schema를 확인하며 터미널, 스크립트, AI Agent 워크플로에서 지원되는 Guance 도구를 실행합니다.
OWL CLI는 어떤 기능에 접근할 수 있나요?
사용 가능한 카테고리와 도구는 현재 Guance 서비스가 반환하며 설정된 워크스페이스와 API Key 권한에 따라 달라집니다. 고정된 마케팅 목록 대신 `owl sync`, `owl list`, `owl show`로 현재 카탈로그를 확인하세요.
OWL CLI는 쓰기 작업을 지원하나요?
문서화된 일부 도구는 리소스를 생성하거나 업데이트합니다. 쓰기 도구는 Guance 워크스페이스를 변경하며 관련 권한이 필요합니다. AI Agent가 쓰기 작업을 실행하기 전에 수동 확인 또는 다른 승인 제어를 사용하세요.
OWL CLI와 OWL MCP Server는 어떤 관계인가요?
둘 다 Guance의 도구 중심 기능을 제공합니다. OWL CLI는 로컬 명령줄, 스크립트, Agent 워크플로용이고 OWL MCP Server는 Model Context Protocol을 통해 클라이언트에 도구를 제공합니다.
구현 가이드
LLM 호출, Token 사용량, Trace 컨텍스트 관측하기
모델 요청, 지연 시간, 오류, Token 사용량, 워크플로 Span을 하나의 조사 흐름에서 확인합니다.
AI Agent 실행을 운영 검토가 가능한 기록으로 만들기
Agent Session, Trace, 도구 호출, 실행 컨텍스트를 기록하고 모델 출력만을 근거로 취급하지 않는 운영 방식을 설계합니다.
엔지니어링과 AI Agent 워크플로에서 OWL CLI 사용하기
사용 가능한 도구 카탈로그를 동기화하고 Schema를 검토한 뒤 권한이 부여된 Guance 도구를 터미널에서 실행합니다.
MCP 클라이언트를 권한이 부여된 Guance 도구에 연결하기
MCP 연결과 인증을 설정하고 클라이언트에 노출되는 도구를 검토합니다.