본문으로 건너뛰기
ClickHouse Loom
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

비용 예산

비용 예산

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

네임스페이스 및 지정 사용자 한도는 agent_events의 24시간 롤링 비용 원장을 사용합니다. 양수인 네임스페이스 정책은 해당하는 서버 기본값을 덮어씁니다. 0은 기본값을 상속하며, 두 티어 모두 0이면 해당 한도가 비활성화됩니다. 지정 사용자의 한도는 네임스페이스 상한과 독립적입니다. 둘 중 하나에 도달하면 승인 단계에서 유료 합성을 거부하며, 모델 라우팅은 더 큰 지출 비율을 사용합니다. 전체 문서 경로를 포함한 memory.ask, code.ask, knowledge.synthesize, code.search 쿼리 확장은 원장에 기록되는 논리적 사용자를 제공합니다. 네임스페이스 전체 범위의 워커는 네임스페이스 단위 회계를 유지하며, 토큰 subject는 귀속되지 않은 사용자를 대신해 사용되지 않습니다. 이러한 소프트 제어는 지출을 예약하지 않으며 청구 ID를 확립하지도 않습니다.

cost.budget_status는 가드와 정책 및 지출 읽기를 공유합니다. 사용자 모드는 네임스페이스가 필요하며 사용자의 한도와 판정, 그리고 namespace_over_cap을 보고합니다. 정확한 사용자 지출과 그 비율은 호출자가 네임스페이스 역할 제한이 없는 검증된 플랫폼 관리자가 아니면 null입니다. 이는 모든 이벤트가 일반 이벤트인 경우에도 마찬가지입니다. 숫자의 유무를 달리하면 표시된 활동이 드러나기 때문입니다. 인증이 없으면 비공개 지출에 접근할 수 없습니다. 내부 회계, 승인, 예산 압박에는 표시된 요청을 포함한 모든 지출이 반영됩니다. 네임스페이스 및 조직 합계는 숫자로 유지됩니다. 전송 계층의 승인은 토큰에 고정된 사용자를 강제합니다. 네임스페이스 및 조직 모드는 기존 읽기 범위를 유지합니다. 비용 가이드에서 구성과 경고 시점을 설명합니다.

선택 사항인 budget_alert_inbox는 같은 조직에서 해당 예산의 네임스페이스가 소유한 기존 인박스를 지정해야 합니다. 등록 시 이를 검증하고 전달 시 소유권을 다시 확인합니다. 지점 확인과 상태 폴링은 기존 태스크 이벤트 스트림을 통해 제한된 백그라운드 경고를 예약하며, 프로세스당 대기 중인 전달은 최대 32건입니다. 한 조직의 전달은 프로세스 내에서 순차적으로 실행되므로 네임스페이스 경고와 사용자 경고가 서로 경합하지 않습니다. 탐색 워커는 없습니다. 이벤트 ID에는 조직, 네임스페이스, 인박스, 선택된 사용자, 한도, 경고 비율, UTC 날짜가 포함됩니다. 분산 클레임과 강한 일관성의 이벤트 읽기가 확인과 삽입을 직렬화하며, 중복 제거 토큰과 재읽기로 불확실한 재시도를 처리합니다. 알림 실패는 한도 판정을 바꿀 수 없습니다.

사용자 경고 페이로드에는 선택된 사용자, 한도, 경고 비율이 담기며 spent_24h_usd: null입니다. 이는 운영자의 확인이 전달을 유발하는 경우에도 인박스, 폴링, 스트림, 웹훅 모두에 적용됩니다. 시작한 사람의 권한이 수신자의 권한을 확립하지 않기 때문입니다. 네임스페이스 경고는 네임스페이스 지출 합계를 유지합니다. 사용자 한도 판정과 경고 임계값 초과는 지출의 경계를 드러내며, 한도를 변경하는 관리자는 더 좁은 경계를 추론할 수 있습니다. 이는 표시된 지출 합계 예외와 함께 허용되는 정책 신호이며 완전한 비간섭이 아닙니다. 표시된 작업, 모델, 결과에 대한 접근 권한을 부여하지 않습니다.

태스크 업데이트와 감시 스트림은 페이지네이션 전에 호출자의 사용자 및 세션 범위를 경고에 적용합니다. 불완전한 범위는 경고를 받지 않으며, 일반 태스크 이벤트는 인박스 내에서 공유됩니다. 등록된 인박스의 웹훅은 해당 네임스페이스 스트림을 받습니다.

모든 전달과 태스크 이벤트 삭제는 동일한 조직 전체 경고 작성자 리스를 사용합니다. 삽입은 기존의 서버 측 시작 기한과 실행 한도를 사용하며, 리스 TTL은 작업 구간에 전체 전송 한도를 더한 값을 초과합니다. 불확실한 삽입이나 취소는 해당 리스를 만료되도록 두므로, 가능한 모든 전송이 끝나기 전에는 삭제가 리스를 획득할 수 없습니다. 삭제는 태그된 변경, 폴링, 재개 프로토콜을 유지합니다. 게시 전후의 원장 확인은 삭제에 도달한 관찰을 무효화하며, 쓰기 후 정리는 해당 전달의 정확한 이벤트와 시퀀스만 지정합니다. 읽을 수 없는 원장은 게시를 거부합니다.

경고 행에는 전체 ID 튜플, 프로세스 행위자, 파생된 소스 클래스가 담깁니다. 사용자 삭제는 해당 사용자의 태스크 이벤트를 삭제하고 잔여 데이터 조사로 삭제를 검증하며, 네임스페이스 삭제는 태스크와 이벤트를 모두 포함합니다. 추가된 컬럼에는 이전 작성자를 위한 기본값이 있습니다. 경고 생성은 모든 라이브 레플리카가 마이그레이션을 지원할 때까지 대기하므로, 롤링 업그레이드 중 이전 삭제 구현이 사용자 정보가 담긴 경고 행을 놓칠 수 없습니다. 플릿 상태를 알 수 없으면 이후 확인까지 게시를 미룹니다.

활성화 및 롤백

사용자 한도와 예산 경고를 사용하려면 모든 서비스 빌드가 마이그레이션 107을 지원해야 합니다. 저장소를 공유하는 배포 중 하나라도 이전 빌드를 실행하거나 버전을 알 수 없는 동안에는 LOOM_DEFAULT_DAILY_USER_COST_CAP_USD와 모든 네임스페이스의 daily_user_cost_cap_usd를 0으로, budget_alert_inbox를 비워 두십시오. 이 기간에는 사용자 한도에 의존하지 마십시오. 이러한 정책을 설정하기 전에 마이그레이션을 적용하고 모든 서비스 프로세스를 업그레이드하십시오. 경고 플릿 확인은 이전 또는 알 수 없는 플릿에서 생성을 미루며, 이미 저장된 경고를 제거하지는 않습니다.

롤백 전에 전역 사용자 한도 기본값과 각 네임스페이스의 사용자 한도 및 알림 인박스를 저장하십시오. 롤백에는 유지보수 구간이 필요합니다.

  1. 예산을 확인하거나 경고를 예약할 수 있는 모든 요청 처리 및 백그라운드 프로세스를, 저장소를 공유하는 모든 배포에 걸쳐 중지하십시오. 상태 폴링도 중지하십시오. 백그라운드 워커를 끄거나 인박스 정책을 비우는 것만으로는 해당 인박스로 이미 예약된 전달이 멈추지 않습니다.
  2. 정리하기 전에 예약된 전달을 비우고 진행 중이거나 불확실한 모든 쓰기를 확정하십시오. 경고 작성자 리스가 해제되거나 만료되고, 제한된 지연 시작 및 서버 실행 구간이 끝날 때까지 기다리십시오. 중단된 드레인이나 비어 있는 실행 중 쿼리 목록은 지연된 전송이 도착할 수 없다는 증거가 되지 않습니다.
  3. event가 budget.warning인 loom.task_events 행만 삭제하십시오. 모든 스토리지 레플리카에서 삭제가 완료되기를 기다리고, 첫 번째 이전 프로세스를 시작하기 전에 어느 레플리카에도 경고 행이 남아 있지 않은지 확인하십시오. 읽을 수 없는 레플리카나 확정되지 않은 쓰기가 있으면 롤백할 수 없습니다. 네임스페이스 또는 사용자 삭제는 대체 수단이 아니며, 관련 없는 데이터도 삭제합니다.
  4. 이전 빌드가 서비스하는 동안에는 사용자 한도와 경고를 비활성화 상태로 유지하십시오. 모든 서비스 프로세스가 다시 마이그레이션 107을 지원하게 되면, 저장해 둔 전역 기본값을 복원하고 namespace.register로 네임스페이스 사용자 한도와 알림 인박스를 다시 적용하십시오. 경고 생성을 재개하기 전에 네임스페이스 정책을 읽고 유효 한도를 확인하십시오.

이는 혼합 버전 운영 중 활성화를 제한하고, 롤백 중에는 가용성을 희생하여 프라이버시를 보호합니다. 이전 태스크 리더는 비공개 경고를 필터링하지 않으며, 이전 사용자 삭제는 이를 삭제하지 않습니다. 또한 이전 네임스페이스 등록은 사용자 한도와 알림 인박스 컬럼을 생략하므로, 이를 대체하는 행은 이 정책을 기본값으로 재설정합니다. 네임스페이스 레지스트리는 이전 쓰기를 거치는 동안 해당 컬럼을 유지하지 않습니다. 따라서 운영자는 정책이 롤백 후에도 유지되기를 기대하지 말고 직접 보존하고 복원해야 합니다.

소스 진입점

  • server/observability/budget.py: budget_snapshot은 가드와 상태를 위해 정책과 롤링 지출을 읽습니다.
  • server/tasks/app/budget_notifications.py: deliver는 경고 클레임과 삭제 펜스를 담당합니다.
  • server/tasks/store/repo.py: events_since는 커서 페이지네이션 전에 경고 범위를 적용합니다.
  • server/tasks/app/reads.py 및 server/tasks/app/watch_routes.py: 폴링 및 스트리밍 리더가 해당 범위를 바인딩합니다.
  • server/erasure/store/steps_ledgers.py: 경고 작성자 리스가 태스크 이벤트 삭제를 보호합니다.

불변 조건

  • 지정 사용자의 허용량은 네임스페이스 상한을 높이지 않으며, 귀속 과정에서 토큰 subject를 추측하지 않습니다.
  • 범위가 좁혀진 리더는 자신의 사용자 및 세션 범위 밖의 경고를 받지 않습니다.
  • 불확실한 경고 쓰기는 가능한 전송이 끝날 때까지 삭제를 펜스로 막아 둡니다.
  • 알림 실패는 한도 결정을 절대 바꾸지 않습니다.

이 페이지가 도움이 되었나요?