fp를 사용하여 Cloud 텔레메트리를 검사하고, 클라우드 관리형 적용(정책, 플릿 배포, 가드레일 결정)을 관리하며, 감사, 발견 사항, 이슈, 알림, 키, 사용자, 쿼리, 설정을 관리합니다. 로컬 훅, 정책, 캡처, 머신 등록에는 failproofai를 사용하세요.
배포된 Cloud CLI를 독립 도구로 설치합니다:
uv tool install fp-cloud-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 | 현재 신원, 인증 모드, 조직 및 권한을 표시합니다. | — |
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 --limit 10000
fp --json events --full --session-id <session-id> --all --limit 10000
--all은 --limit까지 페이지네이션하며, 기본값은 50입니다. 따라서 --all만 단독으로 사용하면 50행에서 멈춥니다. 일찍 멈추면 응답에 재개할 수 있는 next_cursor가 포함됩니다. "next_cursor": null은 피드가 실제로 소진되었음을 의미합니다.세션
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 | 알림을 업데이트하거나 이름을 변경합니다. | create 옵션 추가로 --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 | 감사를 생성하고 즉시 첫 번째 실행을 대기열에 추가합니다. | create 옵션을 참조하세요. |
fp audits edit NAME | 지정되지 않은 값은 유지하면서 감사 설정을 교체합니다. | create 정의 옵션; --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> |
감사 create 옵션
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 참조를 추가합니다; 최대 5회 반복 가능합니다. |
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 |
정책
클라우드 관리형 정책 버전입니다. 세션 전용 — 이 명령들은 API 키 아래에서 요청 전에 종료 코드2로 종료됩니다. 이는 /v1에 의도적으로 없는 루트 전용 쓰기 경로이기 때문입니다.
| 명령 | 목적 | 옵션 |
|---|---|---|
fp policies list | 정책 버전 목록을 표시합니다. | --json |
fp policies show POLICY_ID | 소스와 함께 정책 하나를 표시합니다. | — |
fp policies publish NAME PATH | 로컬 .mjs에서 버전을 생성합니다. | --description; --no-verify |
fp policies enable POLICY_ID | 제거된 모든 배포에 다시 추가하고, 각 배포에서 새 세대를 생성합니다. | --yes, -y |
fp policies disable POLICY_ID | 이를 포함하는 모든 배포에서 제거하고, 각 배포에서 새 세대를 생성합니다. | --yes, -y |
fp policies delete POLICY_ID | 정책 버전을 삭제합니다. | --yes, -y |
fp policies test PATH | 합성 컨텍스트에 대해 로컬에서 정책을 실행합니다. 각 정책의 match 필터를 적용하므로, 주어진 이벤트/도구를 다루지 않는 정책은 실행되지 않고 skipped로 보고됩니다. | --event; --tool; --command; --file; --expect |
fp policies compose PROMPT | 어시스턴트로 정책 초안을 작성합니다. policies:write가 필요합니다. | — |
플릿
어떤 머신에서 어떤 정책이 실행되는지를 관리합니다. 세션 전용, 위와 같은 이유입니다.| 명령 | 목적 | 옵션 |
|---|---|---|
fp fleet list | 등록된 머신과 그 배포 세대를 나열합니다. | — |
fp fleet show MACHINE_ID | 머신이 현재 실행 중인 정책 세트를 표시합니다. | — |
fp fleet deploy MACHINE_ID | 머신의 전체 정책 세트를 교체합니다. 계획을 출력하고 --json 없이 대화형 터미널에서만 확인을 요청합니다. | --add; --remove; --set; --create; --yes, -y |
fp fleet diff MACHINE_ID | 머신을 다른 배포와 비교합니다. | — |
fp fleet history MACHINE_ID | 머신의 과거 배포 기록을 표시합니다. | — |
fp fleet rollback MACHINE_ID GENERATION | 과거 세대의 정책 세트를 새 세대로 복원합니다. | --yes, -y |
fp fleet rename MACHINE_ID | 머신에 읽기 쉬운 이름을 부여합니다. | 필수 --name |
가드레일
적용이 실제로 수행한 작업을 확인합니다. 세션 전용, 위와 같은 이유입니다.| 명령 | 목적 | 옵션 |
|---|---|---|
fp guardrails summary | 적용 범위, 차단/평가 총계, 거부 스파크라인 및 정책별 테이블을 표시합니다. | --since (1h, 6h, 24h, 7d); --machine |
fp guardrails timeline | 윈도우에 걸쳐 버킷화된 결정을 모든 정책 소스에 대해 합산하여 표시합니다. | --since (1h, 6h, 24h, 7d); --machine |
글로벌 플래그
| 플래그 | 설명 |
|---|---|
--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는 자동화용입니다. 로그인, 조직 전환 및 어시스턴트 명령에는 사용자 세션이 필요합니다.
환경 변수
| 변수 | 동등한 옵션 또는 목적 |
|---|---|
FP_DASHBOARD_URL | --base-url |
FP_ORG | --org |
FP_TOKEN | --token |
FP_API_KEY | --api-key |
FP_JSON | --json |
FP_INSECURE | --insecure |
FP_HOME | CLI 구성 디렉터리를 재배치합니다 (기본값 ~/.failproofai/fpcli). |
FP_ANALYTICS_DISABLED 또는 DO_NOT_TRACK | 익명 CLI 분석을 비활성화합니다. |
NO_COLOR | 색상 출력을 비활성화합니다. |
--org 또는 FP_ORG로 테넌트를 명시적으로 선택하세요.
이 변수들의
AGENTEYE_* 형식은 fp에서 읽히지 않으며 처음부터 그랬습니다 — CLI는 FP_*를 선언하고(fp_cli/app.py), 알 수 없는 변수는 오류가 아닙니다. AGENTEYE_DASHBOARD_URL을 설정해도 CLI의 대상이 변경되지 않으며, 무시된 채 저장된 대시보드를 대상으로 명령이 자동으로 실행됩니다.AGENTEYE_HOME과 AGENTEYE_ENVIRONMENT는 여전히 존재하지만, 이 CLI가 아니라 컬렉터와 텔레메트리 SDK에 속합니다.삭제, 취소, 억제, 해결 또는 구성 교체를 수행하는 명령은 기본적으로 확인 프롬프트를 표시합니다. 활성 조직과 대상을 확인한 후에만
--yes를 사용하세요.