fp를 사용하여 Cloud 텔레메트리를 검사하고 감사(audit), 발견 사항(finding), 이슈, 알림, 키, 사용자, 쿼리, 설정을 관리하세요. 로컬 훅, 정책, 캡처, 머신 등록에는 failproofai를 사용하세요.
릴리스된 Cloud CLI를 독립 도구로 설치하세요:
uv tool install fp-cli
fp version
로그인
fp login
fp whoami
문법
fp [GLOBAL_OPTIONS] COMMAND [SUBCOMMAND] [ARGUMENTS] [OPTIONS]
fp --json sessions --since 24h
fp COMMAND --help 또는 fp COMMAND SUBCOMMAND --help를 실행하세요.
CLI 명령어
인증
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp login | 이메일로 전송된 일회용 코드로 로그인하고 조직을 선택합니다. | --email, -e; --org; --force |
fp logout | 저장된 사용자 세션을 취소하고 제거합니다. | — |
fp whoami | 현재 ID, 인증 모드, 조직, 권한을 표시합니다. | — |
fp version | 설치된 CLI 버전을 표시합니다. | — |
fp help | 최상위 명령어 도움말을 표시합니다. | — |
fp login --email you@example.com --org reliability-team
fp whoami
이벤트
fp events [OPTIONS]
--full은 범위가 한정된 조사에만 사용하세요.
| 옵션 | 설명 |
|---|---|
--limit, -n <n> | 최대 전체 행 수. 기본값: 50. |
--since <window> | all, 15m, 1h, 6h, 24h, 또는 7d. |
--from <timestamp> / --to <timestamp> | ISO 8601 UTC 범위; --since를 덮어씁니다. |
--env <value> | 환경 필터; 반복하거나 쉼표로 구분된 값 사용. |
--event-type <value> | 이벤트 유형 필터; 반복하거나 쉼표로 구분된 값 사용. |
--agent-id <value> | 에이전트 필터; 반복하거나 쉼표로 구분된 값 사용. |
--session-id <value> | 세션 필터; 반복하거나 쉼표로 구분된 값 사용. |
--search <text> | 페이로드 텍스트 검색; 반복 가능하며 조건 중 하나라도 일치하면 반환. |
--order asc|desc | 시간 정렬 순서. 기본값: 최신 항목 먼저. |
--all | --limit까지 자동 페이지네이션. |
--cursor <token> | 불투명 커서에서 재개. |
--page-size <n> | --all 사용 시 요청당 행 수; 최대 200. |
--full | 더 무거운 이벤트 엔드포인트를 통해 원시 페이로드 포함. |
--fields <csv> | 선택한 필드만 반환; payload 요청 시 전체 모드 활성화. |
fp events --session-id <session-id> --order asc --all
fp --json events --full --session-id <session-id> --all
세션
fp sessions [OPTIONS]
| 옵션 | 설명 |
|---|---|
--limit, -n <n> | 최대 전체 행 수. 기본값: 50. |
--since <window> | all, 15m, 1h, 6h, 24h, 또는 7d. |
--from <timestamp> / --to <timestamp> | ISO 8601 UTC 범위; --since를 덮어씁니다. |
--env <value> | 환경 필터; 반복하거나 쉼표로 구분된 값 사용. |
--status <value> | done, error, 또는 timeout; 반복하거나 쉼표로 구분된 값 사용. |
--agent-id <value> | 선택한 에이전트가 포함된 세션을 매칭. |
--session-id <value> | 세션 필터; 반복하거나 쉼표로 구분된 값 사용. |
--all | --limit까지 자동 페이지네이션. |
--cursor <token> | 불투명 커서에서 재개. |
--page-size <n> | --all 사용 시 요청당 행 수; 최대 200. |
--fields <csv> | 선택한 필드만 반환. |
--full-ids | 터미널 출력에서 세션 ID를 단축하지 않음. |
--agents | 멀티 에이전트 세션의 에이전트 목록 펼침. |
평가
fp evals [OPTIONS]
| 옵션 | 설명 |
|---|---|
--aggregate | 개별 평가 대신 전체 합계 및 점수별 통계 표시. |
--limit, -n <n> | 최대 목록 행 수. 기본값: 50. |
--since, --from, --to | 시간 범위 선택. |
--env, --status, --agent-id, --session-id | 필터당 정확히 하나의 값으로 범위 좁히기. |
--score KEY:MIN..MAX | 점수 범위; 반복 가능하며 모든 범위가 일치해야 함. |
--all, --cursor, --page-size | 목록 페이지네이션 제어. |
--fields <csv> | 선택한 필드만 반환. |
--full-ids | 완전한 세션 ID 표시. |
--scores-full | 터미널 출력에서 모든 점수 표시. |
오류
fp errors [OPTIONS]
| 옵션 | 설명 |
|---|---|
--aggregate | 행 목록 대신 일치하는 오류 요약. |
--limit, -n <n> | 최대 목록 행 수. 기본값: 50. |
--since, --from, --to | 시간 범위 선택. |
--env, --error-type, --event-type, --agent-id, --session-id | 오류 범위 좁히기. |
--search <text> | 페이로드 텍스트 검색; 반복 가능. |
--order asc|desc | 시간 정렬 순서. |
--all, --cursor, --page-size | 목록 페이지네이션 제어. |
--fields <csv> | 선택한 필드만 반환. |
--full-ids | 완전한 세션 ID 표시. |
사용량 및 필터 값
| 명령어 | 목적 |
|---|---|
fp usage | 현재 미터링 윈도우의 사용량 표시. |
fp list envs | 관찰된 환경 목록. |
fp list agents | 관찰된 에이전트 ID 목록. |
fp list event_types | 이벤트 유형 목록. |
fp list score_filters | 평가 점수 키 목록. |
fp list models | 모델 이름 목록. |
fp list hooks | 훅 이름 목록. |
fp list tools | 도구 이름 목록. |
fp list error_types | 오류 유형 목록. |
조직
| 명령어 | 목적 |
|---|---|
fp orgs list | 접근 가능한 조직 목록. |
fp orgs switch [SLUG] | 활성 조직 저장; 생략 시 프롬프트 표시. |
fp orgs current | 활성 조직 표시. |
fp orgs perms | 활성 조직에서의 권한 표시. |
API 키
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp keys list | 조직 키 목록. | --show-id; --fields <csv> |
fp keys show NAME | 키 하나와 해당 권한 표시. | — |
fp keys create NAME | 키를 생성하고 비밀을 한 번 공개. | --permission-set; --add; --remove |
fp keys update NAME | 권한 세트를 교체하거나 권한 조정. | --permission-set; --add; --remove; --yes, -y |
fp keys regenerate NAME | 비밀을 교체하고 대체 값을 한 번 공개. | --yes, -y |
fp keys disable NAME | 키를 영구적으로 취소. | --yes, -y |
events:add와 같이 resource:action 형식을 사용합니다. --add를 반복하거나, 쉼표로 구분된 토큰을 사용하거나, events:read.add와 같이 점으로 연결된 액션을 사용하세요.
쿼리
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp query list | 저장된 쿼리 목록. | --show-id; --fields <csv> |
fp query show NAME | 쿼리 하나 표시. | — |
fp query create NAME | 쿼리 저장. | --sql <text|@file>; --description |
fp query update NAME | 쿼리 업데이트 또는 이름 변경. | --name; --sql; --description; --yes, -y |
fp query delete NAME | 저장된 쿼리 삭제. | --yes, -y |
fp query run [NAME] | 저장된 쿼리 또는 임시 SQL 실행. | --sql; --limit; --all; --arg, --param |
fp query schema [TABLE] | 조회 가능한 테이블 목록 또는 테이블 하나 검사. | — |
사용자
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp users list | 조직 구성원 목록. | --active-only; --show-id |
fp users show EMAIL | 구성원과 해당 권한 표시. | — |
fp users create EMAIL | 구성원 추가. | --permission-set; --add; --remove |
fp users update EMAIL | 구성원 권한 변경. | --permission-set; --add; --remove; --yes, -y |
fp users disable EMAIL | 로그인 비활성화. | --yes, -y |
fp users enable EMAIL | 로그인 재활성화. | --yes, -y |
설정
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp settings list | 조직 설정 및 현재 값 목록. | — |
fp settings schema | 허용 값 및 설명 표시. | — |
fp settings set KEY | 기존 설정 변경. | --value, --json-value, --file 중 정확히 하나; 선택적 --yes, -y |
알림
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp alerts list | 알림 규칙 목록. | --show-id |
fp alerts show NAME | 알림 하나 표시. | — |
fp alerts create NAME | 알림 생성. | --file; --description; --severity; --trigger-kind; --trigger-spec; --channels; --eval-interval-secs; --min-breaches; --eval-window |
fp alerts update NAME | 알림 업데이트 또는 이름 변경. | 생성 옵션에 --name; --yes, -y 추가 |
fp alerts delete NAME | 알림 삭제. | --yes, -y |
fp alerts test NAME | 테스트 알림 전송. | --channels; --yes, -y |
info, warning, critical입니다. 트리거 종류는 metric_threshold, custom_sql, evaluation_score, eval_compound, per_event입니다. 평가 간격은 30~86,400초 사이여야 합니다.
감사
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp audits list | 감사 목록. | --enabled-only; --show-id |
fp audits show NAME | 감사 정의 및 상태 하나 표시. | — |
fp audits create NAME | 감사를 생성하고 즉시 첫 번째 실행을 대기열에 추가. | 생성 옵션 참조. |
fp audits edit NAME | 미지정 값을 유지하면서 감사 설정 교체. | 감사 정의 생성 옵션; --name; --yes, -y |
fp audits delete NAME | 감사, 발견 사항, 실행 기록 삭제. | --yes, -y |
fp audits run NAME | 수동 실행 대기열에 추가. | — |
fp audits runs NAME | 실행 기록 목록. | --limit, -n; --show-id |
fp audits context-show NAME | 브리핑 및 참조 URL 가져오기 상태 표시. | — |
fp audits context-set NAME | 브리핑 또는 참조 URL 변경. | --text; --text-file; --url; --clear-urls |
fp audits context-refresh NAME | 참조 URL 재가져오기. | — |
fp audits findings | 발견 사항 목록. | --audit; --run-id; --status; --limit, -n; --offset; --show-id |
fp audits finding FINDING_ID | 발견 사항 하나와 증거 표시. | — |
fp audits ack FINDING_ID | 발견 사항 확인. | --reason |
fp audits mute FINDING_ID | 반복 패턴 억제. | --reason; --yes, -y |
fp audits dismiss FINDING_ID | 패턴을 조치 불필요로 표시하고 억제. | --reason; --yes, -y |
fp audits resolve FINDING_ID | 향후 억제 없이 발견 사항을 수정됨으로 표시. | --yes, -y |
fp audits reopen FINDING_ID | 발견 사항을 활성 대기열로 되돌리고 억제 해제. | — |
fp audits assign FINDING_ID | 발견 사항 담당자 설정. | 필수 --to <email> |
감사 생성 옵션
fp audits create checkout-reliability \
--description "Find checkout failures that agents do not recover from" \
--scope '{"environments":["production"],"agent_ids":["checkout-agent"]}' \
--schedule-interval-secs 86400 \
--window-mode since_last \
--sensitivity medium \
--text-file ./checkout-audit-brief.txt \
--url https://runbooks.example.com/checkout
| 옵션 | 설명 |
|---|---|
--file <path> | JSON을 기반으로 정의하거나 stdin에는 - 사용. 명시적 플래그가 파일 값을 덮어씁니다. |
--description <text> | 실패 질문 또는 목적 기술. |
--enabled / --disabled | 스케줄링을 활성 또는 비활성으로 시작. 기본값: 활성. |
--schedule-interval-secs <n> | 3600–604800. 기본값: 86400. |
--schedule-anchor <timestamp> | ISO 8601 형식의 고정 UTC 단계. 기본값: 다음 09:00 UTC. |
--window-mode since_last|fixed | 마지막으로 완전히 분석된 윈도우 이후 계속하거나 롤링 윈도우를 반복적으로 검사. 기본값: since_last. |
--lookback-window-secs <n> | 3600–7776000. 기본값: 604800. |
--scope '<json>' | environments, agent_ids 또는 기타 지원되는 범위 필드로 필터링. |
--ignore-error-type <type> | 오류 유형 제외; 반복하거나 쉼표로 구분. |
--llm / --no-llm | 에이전틱 분석 활성화 또는 비활성화. 기본값: 활성. |
--top-k <n> | 1–500 발견 사항 유지. 기본값: 50. |
--sensitivity low|medium|high | 보고 민감도 설정. 기본값: medium. |
--channels '<json>' | 알림 채널 배열. |
--text <brief> | 인라인 브리핑, 최대 8,192자. |
--text-file <path> | 파일에서 브리핑 읽기; --text와 상호 배타적. |
--url <https-url> | 공개 HTTPS 참조 추가; 최대 다섯 번 반복 가능. |
fp audits run은 비동기입니다. 발견 사항을 읽기 전에 fp audits runs NAME을 폴링하여 최신 실행이 성공하거나 실패할 때까지 기다리세요.이슈
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp issues list | 이슈 목록. | --state; --alert-id; --limit, -n; --show-id |
fp issues count | 열린 이슈 또는 선택한 이슈 상태 수 계산. | --state |
fp issues show INCIDENT_ID | 이슈 세부 정보, 댓글, 구독자, 활동 표시. | — |
fp issues open | 수동 또는 알림 연결 이슈 열기. | 필수 --summary; 선택적 --title, --alert-id, --severity |
fp issues ack INCIDENT_ID | 이슈 확인. | — |
fp issues assign INCIDENT_ID | 담당자 교체; 옵션 생략 시 초기화. | 반복 가능 --assignee |
fp issues resolve INCIDENT_ID | 이슈 해결. | --yes, -y |
fp issues comment-list INCIDENT_ID | 댓글 목록. | — |
fp issues comment-add INCIDENT_ID | 댓글 추가. | --body, --file 중 정확히 하나 |
fp issues comment-delete INCIDENT_ID COMMENT_ID | 댓글 삭제. | --yes, -y |
fp issues subscribers INCIDENT_ID | 구독자 목록. | — |
fp issues subscribe INCIDENT_ID | 본인 또는 다른 운영자 구독. | --email |
fp issues unsubscribe INCIDENT_ID | 구독 제거. | --email |
firing, acknowledged, resolved입니다. 독립 이슈 심각도는 info, warning, critical입니다.
Cloud 어시스턴트
| 명령어 | 목적 | 옵션 |
|---|---|---|
fp agent health | 어시스턴트 가용성 및 구성 확인. | — |
fp agent models | 사용 가능한 어시스턴트 모델 목록. | — |
fp agent chats | 저장된 채팅 목록. | — |
fp agent ask [MESSAGE] | 채팅 시작 또는 계속; 메시지 생략 시 stdin에서 읽음. | --chat; --model; --page-context |
fp agent show CHAT_ID | 저장된 대화 표시. | — |
fp agent rename CHAT_ID | 대화 이름 변경. | 필수 --title |
fp agent delete CHAT_ID | 대화 삭제. | --yes, -y |
글로벌 플래그
| 플래그 | 설명 |
|---|---|
--json | 기계가 읽을 수 있는 JSON 출력. |
--base-url <url> | 자체 호스팅 또는 개발 대시보드 사용. |
--org <slug> | 이번 호출에 사용할 조직 선택. |
--token <token> | 저장된 사용자 세션 토큰 재정의. |
--api-key <key> | API 키로 자동화 인증; 저장되지 않음. |
--timeout <seconds> | HTTP 타임아웃; 양수여야 함. 기본값: 30. |
--quiet, -q | stderr의 상태 출력 억제. |
--no-color | 색상 출력 비활성화. |
--insecure / --secure | TLS 인증서 검증 비활성화 또는 복원. |
--version | 버전을 출력하고 종료. |
--help, -h | 도움말 표시. |
--api-key는 자동화용입니다. 로그인, 조직 전환, 어시스턴트 명령어는 사용자 세션이 필요합니다.
환경 변수
| 변수 | 동등한 옵션 또는 목적 |
|---|---|
AGENTEYE_DASHBOARD_URL | --base-url |
AGENTEYE_ORG | --org |
AGENTEYE_CLI_TOKEN | --token |
AGENTEYE_CLI_API_KEY | --api-key |
AGENTEYE_CLI_JSON | --json |
AGENTEYE_INSECURE | --insecure |
AGENTEYE_HOME | 현재 CLI 구성 디렉토리 위치 변경. |
AGENTEYE_ANALYTICS_DISABLED 또는 DO_NOT_TRACK | 익명 CLI 분석 비활성화. |
NO_COLOR | 색상 출력 비활성화. |
--org 또는 AGENTEYE_ORG로 테넌트를 명시적으로 선택하세요.
삭제, 취소, 억제, 해결 또는 구성 교체 명령어는 기본적으로 확인을 요청합니다. 활성 조직과 대상을 확인한 후에만
--yes를 사용하세요.