継続的な洞察のための利用データのエクスポート

アカウントの使用状況データを Cloud Object Storage (COS)バケットにエクスポートすることで、クラウド環境全体での継続的な可視化、最適化、ガバナンスなどを実現できます。 例えば、あなたがアカウント管理者で、 アカウント使用状況について詳しく知り、コスト最適化分析を受けたい場合、 アカウントサードパーティプロバイダーと統合することで、 アカウント使用状況に関する洞察を得ることができます。

使用状況レポートを IBM Cloud Object Storage バケットにエクスポートするようにアカウント設定すると、 アカウントがそのデータを継続的にエクスポートできるようになります。 1回単位でデータをエクスポートするには、「 利用明細を CSV ファイルにエクスポートする 」を参照してください。

アカウント使用量データを共有できるようにするには、Billingサービスに使用量の詳細へのアクセスとCOSバケットへのエクスポートの許可を与える必要があります。 レポートには、 アカウント全体の使用量データ、 アカウント使用量、サービスおよびインスタンスに関する情報が含まれるため、使用量の詳細をエクスポートするには、Billingサービスで使用されるサービスIDに管理者アクセス権が必要です。 このセットアップが完了すると、 CSV フォーマットのコストと使用量レポートが毎日自動的にCOSバケットにエクスポートされます。

利用アカウントエクスポートできるようにする

アカウント使用量データをエクスポートできるようにするには、課金アカウント管理サービスの管理者または編集者ロールが必要です。 詳しくは、IAM アクセス権限を参照してください。

使用データをエクスポートできるようにアカウント有効にすると、COSバケットは1年前までのデータを収集することができます。 つまり、2024年6月であれば、2023年6月までの使用量しか見ることができないが、それ以前のデータは常に見ることができる。 つまり、2023年6月にこの機能を有効にし、現在が2024年6月であれば、2022年6月から2024年6月までの利用データを見ることができる。

アカウント利用データをエクスポートできるようにするには、以下の手順を実行します:

  1. IBM Cloud、コンソールから「 管理」 >「 課金と使用状況 」と進み、 「設定 」を選択します。
  2. 「接続」 をクリックします。
  3. Cloud Object Storage インスタンスとバケットを選択する。 これらを選択することで、どのバケツに利用レポートを保存するかを選択することになります。
    1. オプション:既存のインスタンスを選択したくない場合は、 Select an instance > Create newをクリックします。
    2. オプション: バケツを選択するか、バケツのドロップダウンにある新しいバケツを作成するをクリックして、新しいバケツを作成することができます。 バケットの詳細については、 IBM Cloud Object Storage 入門」を 参照してください。 バケットを作成したら
  4. サービス間の認証については、 Authorizeをクリックします。 必要なアクセスについては、 Object Writerと Content Readerを選択してください。 Review をクリックし、次に Assign をクリックする。
  5. フォルダの詳細を確認したら、「 接続 」をクリックします。

アカウントエンタープライズアカウント変更した場合、エンタープライズアカウント使用状況データをエクスポートできるようにするには、再度以下の手順を実行する必要があります。 元のアカウントこの機能を維持することも、 アカウント共有利用を停止する で削除することもできます。

履歴データへのアクセス要求

お客様のアカウント使用量データのエクスポートを有効にすると、COSバケットには、デフォルトでは、課金サービスからの自動日次エクスポートによって提供される当月のデータが収集されますが、過去のデータを要求する場合は、1年前までのデータを含めることができます。 つまり、2024年6月であれば、2023年6月までの使用量しか見ることができないが、それ以前のデータは常に見ることができる。 つまり、2023年6月にこの機能を有効にし、現在が2024年6月であれば、2022年6月から2024年6月までの利用データを見ることができる。 過去のデータを入手するには、サポートケースを作成する必要があります。

過去のデータへのアクセスをリクエストするには、以下の手順を使用します:

  1. IBM Cloud コンソールのメニューバーから、 ヘルプアイコン > Support center をクリックします。

  2. 「サポートにお問い合わせください」セクションで、**「Case の作成」**をクリックします。

  3. カテゴリーは「 請求と使用 」を選択。

  4. トピックで「 請求と使用状況 」を選択し、サブトピックで「 使用状況の詳細を.csvファイルにエクスポートする 」を選択します。

  5. 必須フィールドに入力します。 サポートケースの説明には、データが欲しい月を記載する必要があります。

    セキュリティーを維持するために、Case への返信に個人情報、機密データ、デバイスやサービスの資格情報などを含めないでください。 例えば、パスワード、 API キー、シークレット、クレジット・カードの情報を含めないでください。

  6. 「次へ」 をクリックし、Case サマリーを確認し、「Case の送信」 をクリックします。 その Case に関する E メールでの確認を受け取ったら、指示に従い、問題についての情報交換をさらに行います。

サポート Case が作成されたら、「Case の管理」ページでその進行状況に従うことができます。

アカウント使用して利用データをエクスポートできるようにする

Terraformを使用して使用状況データをエクスポートできるようにアカウントアタッチする前に、以下を完了していることを確認してください:

  • Terraform CLIをインストールし、Terraform用の IBM Cloud Providerプラグインを設定する。 詳細については、 IBM Cloud® での Terraform の使用開始 に関するチュートリアルを参照してください。 このプラグインは、以下のタスクを実行するために使用される IBM Cloud API を抽象化します。
  • main.tfという名前の Terraform 構成ファイルを作成します。 このファイルでは、 HashiCorp Configuration Languageを使用してリソースを定義します。 詳しくは Terraformのドキュメントを参照。

アカウント使用量データをエクスポートできるようにするには、2つのインスタンス間でポリシーを承認し、リソースインスタンスに billing_report_snaptshot。 詳細については、ibm_ billing _report_snapshot の terraform ドキュメントを参照してください。 以下の手順で、Terraformを使用して認可ポリシーを作成し、リソースインスタンスの billing_report_snaptshot :

課金スナップショット・コンフィギュレーションを実行するには、 アカウント APIキーに対応する環境変数 IC_API_KEY を設定することで認証情報を提供する必要がある。 詳しくは、 IBM Cloud Provider terraform documentationを参照。

  1. 以下の例では、2つの特定のインスタンス間で認可ポリシーを作成している。

    provider "ibm" {
    }
    resource "ibm_iam_authorization_policy" "policy" {
    source_service_name         = "billing"
    target_service_name         = "cloud-object-storage"
    target_resource_instance_id = var.cos_instance_id
    roles                       = ["Object Writer", "Content Reader"]
    }
    
  2. 次の例は、リソースインスタンスに billing_report_snaptshot。

       provider "ibm" {
    }
    resource "ibm_billing_report_snapshot" "billing_report_snapshot_instance" {
    interval = var.billing_report_snapshot_interval
    versioning = var.billing_report_snapshot_versioning
    report_types = var.billing_report_snapshot_report_types
    cos_reports_folder = var.billing_report_snapshot_cos_reports_folder
    cos_bucket = var.billing_report_snapshot_cos_bucket
    cos_location = var.billing_report_snapshot_cos_location
    depends_on = [ ibm_iam_authorization_policy.policy ]
    }
    
  3. 設定ファイルのビルドが終わったら、Terraform CLIを初期化します。 詳しくは、 作業ディレクトリの初期化を参照のこと。

    terraform init
    
  4. main.tf ファイルからリソースをプロビジョニングする。 詳しくは Terraformによるインフラのプロビジョニングを参照してください。

    1. terraform plan を実行してTerraformの実行プランを生成し、提案されたアクションをプレビューする。

      terraform plan
      
    2. terraform apply を実行し、プランで定義されたリソースを作成する。

      terraform apply
      

サービス間認証がすでに存在する場合、 depends_on 制約を削除して billing_report_snapshot_instance を作成することができます。

バケット要件

結果を保存するバケツには、特別な設定や命名形式は必要ありません。 課金サービスと Cloud Object Storage の間のトラフィックはすべてプライベートネットワーク上で行われる。 コンソールに表示するためのデータ検索に費用はかからない。 ただし、データを保存した後、 Cloud Object Storage から直接ダウンロードする場合は、データ転送費用が発生します。 詳しくは Cloud Object Storage 価格を ご覧ください。

アカウント共有利用を解除する

使用量データをエクスポートするようにアカウント設定している場合、選択したバケットを切断することで、データのエクスポートを停止することができます。

接続を解除するには、以下の手順で行う:

  1. IBM Cloud、コンソールから「 管理」 >「 課金と使用状況 」と進み、 「設定 」を選択します。
  2. 切断をクリックする。
  3. バケツの名前を入力してください。
  4. 切断をクリックする。

利用データがどのように保存され、利用されているかを知る

課金レポートのスナップショットを使用して共有されているあなたのデータは、使用状況データをエクスポートするためにアカウント有効にする手順を実行することにより、スナップショットを設定しています。

課金レポートのスナップショットは、コンフィギュレーション設定に基づいて保存されます。 設定によっては、古いスナップショットは削除されるか、保持される。 各スナップショットには、スナップショットの一部として含まれるファイルなど、スナップショットの詳細を記述したマニフェストファイルがあります。 その請求月の最新のスナップショットのマニフェストは、各請求月のフォルダにも保存される。

以下は、COSバケット内のスナップショットのフォルダ構造の例である。

<cos_reports_folder>/
<cos_reports_folder>/<billing-month>/
<cos_reports_folder>/<billing-month>/manifest.json
<cos_reports_folder>/<billing-month>/<snaphot-id>
<cos_reports_folder>/<billing-month>/<snaphot-id>/manifest.json
<cos_reports_folder>/<billing-month>/<snaphot-id>/*.gz
cos_reports_フォルダ
biling-reports-snapshotsセットアップの一部としてお客様設定した請求レポートのルートフォルダ。
デフォルトは IBMCloud-Billing-Reports です
ビリング月
スナップショットに対応する請求月。
フォーマットは YYYY-MM。 例えば、2023-03 です。
スナップショットID
スナップショットの ID。
英数字。 例えば、1678234269105 です。
manifest.json
お客様 アカウント ID、スナップショットに対応するcsvファイル、レポートタイプなど、スナップショットの詳細を記述したメタデータファイル
billing-monthにあるマニフェストファイルには、次のように撮影された最新のスナップショットが含まれています
*.gz
で言及されているファイルのリスト。 manifest.json

スナップショットAPIの使用方法の詳細については、 スナップショット設定のセットアップを参照してください。