`operator usage` — 클라이언트 수 보고서 조회하기

operator usage — 클라이언트 수 보고서 조회하기

vault operator usage은 관리자가 기본 보고 기간 또는 특정 월 범위에 대한 클라이언트 수(client count) 보고서를 가져올 수 있게 하는 명령어예요.

명령어 출력은 각 네임스페이스의 구별 엔티티(distinct entity), 비엔티티 토큰(non-entity token), ACME 클라이언트, 시크릿 동기화(secret sync) 클라이언트, 총 활성 클라이언트, 그리고 전체 클러스터의 합계를 나열해요. 요청한 시간 범위에 사용 가능한 데이터가 없다고 표시될 수 있는데, 이는 클라이언트 수 보고가 비활성화되었거나, 시간 범위가 너무 과거이거나, 기능이 활성화된 이후 데이터가 아직 수집되지 않았기 때문일 수 있어요.

필요한 정책과 데이터 수집 세부 사항을 포함한 사용 메트릭에 대해 더 알아보려면 Vault Client Usage 가이드를 참고하세요.

출처: 문서

본문

예시 (Examples)

기본 보고 기간의 클라이언트 수를 가져와요:

$ vault operator usage
Period start: 2019-11-01T00:00:00Z
Period end: 2020-10-31T23:59:59Z

Namespace path   Distinct entities   Non-Entity tokens   Secret syncs   ACME clients   Active clients
--------------   -----------------   -----------------   ------------   ------------   --------------
[root]           1541                332                 40             60             1973

Total            1541                332                 40             60             1973

과거 특정 달의 클라이언트 수를 가져와요:

$ vault operator usage -start-time=2020-01 -end-time=2020-01
Period start: 2020-01-01T00:00:00Z
Period end: 2020-01-31T23:59:59Z

Namespace path   Distinct entities   Non-Entity tokens   Secret syncs   ACME clients   Active clients
--------------   -----------------   -----------------   ------------   ------------   --------------
[root]           934                 176                 20             30             1160

Total            934                 176                 20             30             1160

사용법 (Usage)

모든 명령어에 기본으로 포함된 표준 플래그 외에 다음 플래그들을 추가로 사용할 수 있어요.

출력 옵션 (Output options)

  • -format (string: "table") — 출력 형식을 지정해요. 유효한 값은 "table", "json", "yaml"이에요. VAULT_FORMAT 환경 변수로도 지정할 수 있어요.

커맨드 옵션 (Command options)

  • -start-time (date) — 생성할 보고서의 시작 월. YYYY-MM-DD, RFC3339 타임스탬프, 또는 Unix 에포크(epoch) 타임스탬프로 줄 수 있어요. 기본값은 청구 시작일이에요. 청구 시작일은 마지막 주기가 끝나면 자동으로 최신 청구 연도로 넘어가요.
  • -end-time (date: 이전 달) — 생성할 보고서의 끝 월. 기본값은 현재 달의 끝이에요.

출력은 보고되는 정확한 시간 범위를 보여주며, 전체 달을 사용할 수 없거나 사용 가능한 보고서가 요청한 달의 부분 집합일 경우 입력 매개변수와 일치하지 않을 수 있어요.

더 알아보기 (Learn more)

  • vault operator utilization — 라이선스 활용 보고
  • Vault Client Usage 가이드
  • Vault Enterprise 문서