メイン コンテンツにスキップ

ライセンス使用状況レポートの作成

使用状況レポートの作成

ユーザーは、システムがどの程度利用されたかを示すライセンス使用状況レポートを作成できます。このレポートの主な目的は、パッシブライセンスモードで稼働しているシステムが、ライセンスの使用量をGlasswallに報告できるようにすることです。ライセンス使用データは日次でレポート形式に集計されるため、ファイルがHaloに送信された直後にレポートを作成した場合、直近のアクティビティはすぐには表示されないことがあります。

レポートの内容

レポートには次の内容が含まれます:

  • レポート対象のライセンスID
  • ライセンス名
  • ライセンスの上限
  • System usage split into daily buckets
    • 各バケットには、その日に処理されたファイル数とファイルの合計サイズが含まれます
    • ライセンスに関連するライフサイクルイベント(インストール、削除など)
    • ライセンス使用状況の追跡中にシステムで発生した問題を示す異常
  • レポートが作成された日付
  • ライセンスが有効化された日付

reportsignature は、Halo システムによって生成された後にライセンスの内容が変更されていないことを検証するために使用されます。

記録されない情報

ライセンス使用状況レポートには、機密データや個人を特定できるデータは含まれません。具体的には、次の情報は記録されません。

  • IP アドレス
  • ホストまたはシステムの詳細
  • ファイル内容に関するメタデータ
  • 暗号化された情報またはユーザー固有の情報

これにより、すべてのライセンスレポートが安全で、匿名化されており、プライバシーおよびデータ保護基準に準拠していることが保証されます。

使用状況レポートの例


"licenseReport":
"licenseId": "1e6e8264-2aef-42ad-8fa3-f9f43bae5908",
"licenseName": "test_licensename:001",
"entitlementLimits":
"haloProcessingDataLimit": "500G",
"haloProcessingFileLimit": "10000"
,
"usage":
"2024-02-07":
"dayFileSize": 301045177,
"dayFileCount": 210,
"anomalyCount": 0,
"anomalies": [

],
"lifeCycle": [

"detail": "License Installed",
"time": "2024-03-05T10:01:26.801Z"

]
,
"2024-02-08":
"dayFileSize": 287259157,
"dayFileCount": 379,
"anomalyCount": 1,
"anomalies": [

"source": "license-monitor",
"time": "2024-02-21T15:06:00.457Z",
"message": "Tally Accumulator response could not be retrieved"

],
"lifeCycle": [

]
,
...
,
"created": "2024-03-06 11:22:13.970Z",
"activationDate": "2024-02-21T11:28:53Z"
,
"reportSignature": "eyJhbGciOiJIUzI1NiIsImI2NCI6ZmFsc2UsImtpZCI6ImNvbS5nbGFzc3dhbGwudXNhZ2UtcmVwb3J0LmhzMjU2LnYxIiwiY3JpdCI6WyJiNjQiXX0..PX-yzAbgSLCJDmW4Axf6sYvyIF-g_F8aiBQY96g8Fv8"

API を使用した使用状況レポートの作成

使用状況レポートをプログラムでダウンロードするための新しい http endpoint が 2 つ利用可能です:

  • Get /API/v1/license-usage/active は、現在インストールされているライセンスの使用状況レポートを含む生の JSON レスポンスを返します。
  • Get /API/v1/license-usage/licenseid は、過去にインストールされていたライセンスについて同じ種類のレスポンスを返します。これは、過去にインストールされたライセンスの一覧を返す get /API/v1/license-usage と組み合わせて機能します

ポータル経由で使用状況レポートを作成する

現在インストールされているライセンスのレポートは、Halo portal から直接ダウンロードすることもできます。

Only Admin users can perform this action from the System settings page. when downloaded, the report is provided as a .json file named using the license id and the report’s creation date.

使用状況レポートをダウンロードするには

  1. License management に移動します。
  2. Download usage report をクリックします。

Download usage report

レポートを含む .json ファイルが、お使いのマシンにダウンロードされます。