Skip to main content
Failproof AI Observability 배포 전체를 명령어 하나로 관리하세요. 터미널을 벗어나지 않고 프로덕션을 점검하고, API 키를 발급하고, 인시던트를 확인할 수 있습니다. 이를 CI에 스크립트로 작성하거나, 코딩 에이전트가 일상 언어로 대신 처리하도록 할 수도 있습니다.
agenteye CLI는 대시보드와 통신합니다. 이벤트를 서버로 전송하는 콜렉터와는 별개의 도구입니다.

​
배포 전체를 명령어 하나로

간단한 질문에 답하려고 탭을 여러 개 열어둘 필요가 없습니다. agenteye CLI는 단일 바이너리로 데이터를 읽고 조직을 관리합니다. 대시보드를 클릭해야 했던 작업이 이제 한 줄 명령어로 해결됩니다. 다시 실행하거나, 별칭으로 등록하거나, 런북에 붙여 넣을 수 있습니다. 네 가지 기능을 제공합니다:
  • 데이터 조회: sessions, events, evals, errors를 시간, 에이전트, 환경별로 필터링합니다.
  • 조직 관리: keys, users, settings, alerts, incidents를 관리합니다.
  • 분석 실행: 저장된 SQL과 이벤트 데이터에 대한 임시 query 실행기를 사용합니다.
  • 어시스턴트 질의: agent ask로 대시보드에서 대화하는 것과 동일한 읽기 전용 분석가에게 질문합니다.
pipx로 한 번 설치하고, 이메일로 전송된 6자리 코드로 로그인하면 준비 완료입니다. 세션은 약 하루 동안 유지되며, 만료되면 agenteye login을 다시 실행하세요. 브라우저를 열지 않고도 프로덕션 점검, 키 발급, 인시던트 트리아지 등을 처리할 수 있습니다:
한 가지 알아둘 사항: --json과 같은 전역 옵션은 명령어 앞에 위치합니다. agenteye --json sessions가 올바른 형식이며, agenteye sessions --json은 올바르지 않습니다.

​
스크립트 작성 및 CI 연동

모든 명령어에 --json을 사용할 수 있으며, 이것이 모든 것을 바꿉니다. 정제된 JSON은 stdout으로 출력되고, 사람을 위한 상태 메시지와 경고는 stderr로 출력됩니다. 따라서 --json으로 캡처한 결과를 불필요한 줄 없이 바로 jq에 파이프할 수 있습니다. 이 덕분에 CLI는 프롬프트에서 직접 사용하는 경우와 출력을 파싱하는 코딩 에이전트 모두에게 동일하게 유용합니다:
무인 실행을 위해 설계되었습니다. 터미널이 연결되어 있지 않으면 확인 프롬프트가 자동으로 건너뛰어져 파이프라인이 중단되지 않습니다. 모든 명령어는 의미 있는 종료 코드를 반환합니다: 0 성공, 4 미로그인, 5 권한 부족 (메시지에 해당 권한 명시, 예: alerts:write), 3 대시보드 연결 불가. 스크립트에서 4를 감지하면 재인증을 수행하고, 5를 감지하면 관리자에게 정확히 어떤 권한이 필요한지 알 수 있어 오류 원인을 모른 채 실패하는 상황을 방지합니다.

​
코딩 에이전트가 일상 언어로 처리하도록

더 나아가, 이 플래그들을 직접 기억할 필요조차 없습니다. CLI 스킬은 agenteye-cli라는 작은 Agent Skill 폴더로, Claude Code나 Codex 같은 코딩 에이전트가 일상 언어 요청으로 CLI를 사용할 수 있도록 가르쳐 줍니다. “오늘 뭔가 문제가 있나요?”라고 물으면 에이전트가 적절한 명령어를 선택해 실행하고 결과를 설명해 줍니다. Claude Code의 경우, agenteye-cli 폴더를 ~/.claude/skills/에 넣으면 자동으로 인식됩니다. Failproof AI Observability가 해당 폴더를 제공하며, 이미 설치된 CLI를 활용하는 것이므로 추가 설치가 필요하지 않습니다. 단, 로그인은 직접 먼저 해야 합니다. 스킬은 이메일 코드 로그인을 대신 완료할 수 없습니다. 에이전트는 사용자 권한으로 CLI를 실행하므로, 로그인이 허용하는 모든 작업(읽기와 쓰기 모두)이 가능합니다: 키 생성, 설정 변경, 인시던트 해결. CLI의 “정말 하시겠습니까?” 프롬프트는 에이전트에게는 표시되지 않으므로, 스킬은 변경 작업 전에 정확한 명령어를 명시하고 사용자의 승인을 기다리도록 작성되어 있습니다. 사용자가 직접 확인 단계가 됩니다.
읽기 작업은 즉시 실행되고, 쓰기 작업은 매번 사용자 확인을 기다립니다:

​
관련 문서