使用状況メトリクス
IBM Bob が IBM 使用量メータリングサービスと IBM Software Central を通じて IBM に使用状況メトリクスを報告する方法について説明します。
IBM Bob は IBM 使用量メータリングサービス (UMS) を使用して、使用状況メトリクスを収集・報告します。UMS はインストール中に自動的に設定されます。
報告されるデータ
Bob が報告するメトリクスはアクティブユーザーの総数のみです。ユーザーの ID、プロンプト、コードスニペット、行動データは収集または送信されません。
監査スナップショットの取得
UMS から監査スナップショットを取得するには、IBM Foundational Services ドキュメントの手順に従ってください。
IBM Foundational Services ドキュメントでは kubectl コマンドが使用されています。Red Hat OpenShift を使用する場合は、kubectl の代わりに oc を使用してください。
IBM Software Central へのデータ転送
UMS から IBM Software Central へ使用状況データをオンラインモードまたはオフラインモードで転送できます。
IBM License Reporter は Bob には不要です。
オンラインモード (インターネット接続済みクラスター)
インターネットに接続されているクラスターの場合、UMS は UTC 午前 0 時 5 分に 24 時間ごとの間隔で IBM Software Central へ使用状況データを自動的に転送します。
オフラインモード (エアギャップクラスター)
エアギャップまたは切断された環境の場合、UMS から使用状況ペイロードを手動でダウンロードし、IBM Software Central にアップロードする必要があります。
UMS から使用状況ペイロードをダウンロードします。
curl \
--header "Authorization: Bearer <UMS_TOKEN>" \
--cacert ca.crt \
--output swc_payload.tar.gz \
"<UMS_URL>/api/v1/swc"この場合:
<UMS_TOKEN>はibm-usage-metering-upload-tokenシークレットのtoken値です。<UMS_URL>はibm-usage-metering-fetchルートのLocation値です。ca.crtは監査スナップショットの生成時に取得した CA 証明書です。
swc_payload.tar.gz をインターネットアクセスのあるシステムに転送し、IBM Software Central にアップロードします。
curl -X POST \
"https://swc.saas.ibm.com/metering/api/v2/metrics" \
-H "Authorization: Bearer <IBM_ENTITLEMENT_KEY>" \
-F "file=@swc_payload.tar.gz;type=application/gzip"<IBM_ENTITLEMENT_KEY> はお客様の IBM エンタイトルメントキーです。
テスト用のアップロードには、本番エンドポイントの代わりに https://sandbox.swc.saas.ibm.com を使用してください。
アップロードが完了すると、報告された使用状況データが IBM Software Central で利用可能になります。アップロードされたデータを表示するには IBM Software Central アカウントが必要です。アカウントをお持ちでない場合は、最初のアップロードの前に swc.saas.ibm.com で登録してください。