API 레퍼런스
로그인
본문으로 건너뛰기

사용 기록과 분쟁

잡마다 남는 기록(키, IP, 클라이언트, 시각, 실행 초, 금액, 커밋)과 확인 방법, 키 관리 책임과 청구 기준을 설명합니다

XenoCI는 모든 잡에 누가, 어디서, 무엇을 실행했는지 남깁니다, 청구된 금액이 낯설 때 이 기록으로 어떤 키가 어떤 IP에서 어떤 커밋을 빌드했는지 바로 확인할 수 있습니다

잡마다 남는 기록

항목내용
API 키잡을 시작한 키의 ID와 이름 (api_key_id, api_key_name)
워크스페이스잡이 속한 워크스페이스
출처CLI, MCP, GitHub Action, API, 플레이그라운드, 배치 (source)
요청 IP잡을 만든 요청의 IP
클라이언트User-Agent, CLI와 MCP와 Action의 버전
시각접수, 시작, 종료 시각 (UTC)
실행 초와 과금 초run_seconds, billed_seconds
금액amount_usd, 센트 두 자리
저장소와 커밋공개 git 소스의 저장소와 커밋 해시, GitHub Action은 워크플로의 저장소
로그잡 로그 전체, 데이터 보존과 삭제 기간 동안

API 요청은 따로 30일 동안 남습니다 (시각, 키, 메서드, 경로, 상태, 지연 시간, 요청 ID)

확인하는 방법

어디서내용
콘솔 분석 → 로그잡과 API 요청을 시간순으로, 키와 상태로 거르기
콘솔 분석 → 사용량잡 목록과 CSV 내려받기
API사용량 CSV, 로그 목록, 잡 조회
CLIxenocast usage --by api_key, xenocast status <잡 ID>

소유자와 관리자는 조직 전체를, 개발자는 배정된 워크스페이스만 봅니다

낯선 사용을 발견하면

  1. 어떤 키인지 찾기

    분석 → 로그에서 그 잡의 API 키와 IP, 출처를 확인합니다

  2. 키 폐기

    API 키에서 그 키를 폐기합니다, 그 뒤 요청은 바로 401 invalid_api_key이고, 실행 중인 잡도 다음 주기 점검 때 멈춥니다

  3. 새 키로 교체

    새 키를 만들어 쓰던 곳에 넣습니다, 필요하면 IP 허용 목록을 켭니다

  4. 문의

    조직 ID와 잡 ID를 적어 지원 메일로 보내 주세요

알림

  • 키가 처음 보는 IP나 처음 보는 국가에서 쓰이면 소유자에게 메일이 갑니다
  • 키 하나의 요청이 10분에 1,000건을 넘으면 소유자와 관리자에게 급증 알림 메일이 갑니다
  • 공개 GitHub 저장소 등에서 키가 발견되면 키를 자동으로 폐기하고 알립니다 (키 유출 대응)

키 관리 책임과 청구

  • API 키 관리는 고객의 책임입니다, 키를 저장소에 커밋하거나 다른 사람과 나누지 마세요
  • 유효한 키로 실행된 잡은 누가 실행했든 그 키의 조직에 청구됩니다
  • 키를 폐기하기 전까지의 사용은 환불 대상이 아닙니다, 낯선 사용을 발견하면 먼저 키를 폐기하세요
  • XenoCI의 장애로 실패한 잡(platform_error)은 청구하지 않습니다

자세한 내용은 이용약관에 있습니다

다음 단계