수동 라이선스 이용 보고

수동 라이선스 이용 보고 (Manual license utilization reporting)

엔터프라이즈: 이 기능은 노마드 엔터프라이즈를 필요로 해요.

수동 라이선스 이용 보고를 사용하면 CLI나 HCP 웹 포털을 통해 라이선스 이용 데이터를 내보내고 검토한 뒤 HashiCorp로 보낼 수 있어요. 이 보고서를 사용해 현재 계약 아래에서 얼마나 더 배포할 수 있는지 이해하고, 과잉 이용을 방지하며, 예상 소비에 대한 예산을 세울 수 있어요. 수동 보고는 계약에서 정의한 대로 라이선스 이용을 검증하는 데 필요한 최소 데이터를 공유해요. 보고서는 대부분 계산된 메트릭으로 구성되며 개인 식별 정보(PII)나 다른 민감한 정보를 절대 포함하지 않아요.

수동 라이선스 보고는 자동 라이선스 보고와 같은 데이터를 공유하지만 더 많은 시간이 걸려요. 에어갭(air-gapped) 환경에서 실행 중이거나 데이터를 수동으로 보고할 다른 이유가 없다면, 자동 보고를 사용할 것을 강력히 권장해요. 자동 라이선스 보고를 비활성화했다면 문서에 설명된 옵트아웃 과정을 반대로 수행해 다시 활성화할 수 있어요.

데이터가 걱정되어 수동 보고를 고려하고 있다면, 예시 페이로드(자동과 수동 보고가 동일)를 검토할 것을 강력히 권장해요. 자동으로 보고되는 데이터에 대한 추가 우려가 있다면 자동 보고를 옵트아웃하고 수동 보고로 전환하기 전에 계정 관리자에게 문의해 주세요.

출처: 문서

본문

데이터 보고서를 수동으로 보내는 방법

데이터 번들 생성

데이터 번들은 라이선스 이용 정보를 포함하는 JSON 스냅샷 모음을 담고 있어요.

다음 CLI 명령을 실행해 데이터 번들을 생성해요:

$ nomad operator utilization

기본적으로 번들에는 모든 과거 스냅샷이 포함돼요.

보고서가 생성되고 제출된 조건에 대한 문맥을 주석(comment)을 제공해 설명할 수 있어요. 이 선택적 주석은 라이선스 이용 번들에는 포함되지 않지만, 노마드 서버 로그에는 포함돼요.

예시:

$ nomad operator utilization -message="Change Control 654987" \
     -output="/utilization/reports/latest.json"

이 명령은 유지된 모든 스냅샷을 번들로 내보내요. "Change Control 654987" 메시지는 번들에는 포함되지 않지만 노마드 서버 로그에는 포함돼요. -output 플래그는 JSON 번들의 출력 위치를 지정해요.

사용 가능한 명령 플래그:

• -message (string: "") — 보고서가 생성되고 제출된 조건에 대한 문맥을 제공해요. 이 메시지는 라이선스 이용 번들에는 포함되지 않지만 노마드 서버 로그에는 포함돼요. (선택 사항)
• -today-only (bool: false) — 과거 스냅샷 없이 오늘의 스냅샷만 포함하려면 사용해요. 지난 24시간 동안 저장된 스냅샷이 없으면 스냅샷을 찍어 번들로 내보내요. (선택 사항)
• -output (string: "") — 번들의 출력 경로를 지정해요. 기본값은 시간 기반의 생성 파일 이름이에요. (선택 사항)

데이터 번들을 HashiCorp로 보내기

• https://portal.cloud.hashicorp.com/license-utilization/reports/create 로 이동해요.
• Choose files를 클릭하거나 파일을 컨테이너에 드롭해요. a. 업로드가 성공하면 HCP 사용자 인터페이스가 파일 상태를 초록색 Uploaded로 바꿔요. b. 업로드가 실패하면 파일 상태가 빨간색 Failed로 표시되고 오류 정보가 포함돼요.
• 업로드가 실패하면 파일 서명을 수정하지 않았는지 확인해 주세요. 오류가 지속되면 계정 담당자에게 문의해 주세요.

수동 보고 활성화

수동 라이선스 이용 보고를 지원하는 릴리스로 업그레이드해요. 이 릴리스에는 다음이 포함돼요:

• Nomad Enterprise 1.11.0 이상
• Nomad Enterprise 1.10.2 이상
• Nomad Enterprise 1.8.14 이상

구성

관리자는 스냅샷을 보관할 기간(일 수)을 정의해 스냅샷 저장을 위한 디스크 공간을 관리할 수 있어요.

reporting {
  snapshot_retention_time = "9600h"
}

기본 보관 기간은 400일이에요.

데이터 파일 내용

{
  "version": "2",
  "mode": "manual",
  "timestamp": "2025-09-26T17:20:41.189292719Z",
  "signature": "...",
  "checksum": ...,
  "snapshots": [
    {
      "snapshot_version": 2,
      "id": "0001MDDJT442VWX01R4K21A22D",
      "timestamp": "2025-09-26T13:20:04.598859749-04:00",
      "schema_version": "2.1.0",
      "product": "nomad",
      "process_id": "01K63GH92XVS1V95RM7509N303",
      "metrics": {
        ...
        "nomad.billable.clients": {
          "key": "nomad.billable.clients",
          "value": 25,
          "mode": "write"
        },
        ...
      },
      "product_version": "1.10.6",
      "license_id": "...",
      "checksum": ...,
      "metadata": {}
    }
  ]
}

더 알아보기 (Learn more)

• 자동 라이선스 이용 보고
• 노마드 엔터프라이즈 라이선스
• nomad operator utilization 명령