클라이언트 사용량
클라이언트 사용량 (Client Usage)
Enterprise — 적절한 Vault Enterprise 라이선스가 필요합니다.
Vault의 활동 로그(Activity Log)와 라이선스 활용 보고에서 사용량 데이터를 조회·해석하는 방법을 설명합니다. 클라이언트 사용량은 엔티티 단위로 집계되며, 표준/비표준 클라이언트로 구분됩니다.
출처: 문서
본문
사용량 조회
클라이언트 사용량은 다음 방법으로 조회할 수 있습니다.
- 활동 로그 API (Activity Log API) —
sys/internal/counters/activity엔드포인트를 통해 월별 사용량 데이터를 직접 쿼리할 수 있습니다. - 활동 내보내기 CLI (Activity export CLI) —
vault operator usage또는 관련 export 명령으로 사용량 데이터를 파일로 내보낼 수 있습니다. - 활동 로그 UI — Vault Enterprise UI에서 사용량을 시각적으로 확인할 수 있습니다.
사용량 지표 해석
사용량 보고는 기본적으로 달력 월 단위로 집계됩니다. 보고서는 전체 클라이언트 수, 표준/비표준 클라이언트 수, 그리고 (가능한 경우) 네임스페이스별로 나뉜 수치를 보여줍니다.
- 엔티티 기반 집계 — 한 사용자가 여러 인증 메서드로 로그인해도 하나의 엔티티로 합산됩니다.
- 이달(달력 월) 기준 — 라이선스 활용 기간의 시작일(billing start date)을 기준으로 보고 기간이 결정됩니다.
사용량 확인 시 주의사항
- 사용량 데이터는 약 2분마다 집계되어 저장되므로, 아주 최근의 활동은 반영이 지연될 수 있습니다.
- 카운트는 기본적으로 중복 제거되지 않습니다(동일 엔티티의 여러 활동은 하나로 합쳐지지만, 서로 다른 작업 유형은 각각 집계될 수 있음).
참고: 정확한 지표 이름과 엔드포인트 응답 형식에 대한 자세한 내용은 Vault API 문서와 활동 로그 문서를 참조하세요.