詳細な使用状況レポートの生成

IBM Cloud Logs では、 Data Usage Report を CSV、TSV または JSON としてエクスポートできます。レポートは、当月、過去30日間、または過去90日間のインスタンスのデータ使用量の概要を提供します。

以下のレポートを生成できます。

現在の月
過去 30 日間
過去 90 日間

前提条件

メトリック・バケットを構成する必要があります。
データ使用状況機能を有効にする必要があります。詳しくは、データ使用状況メトリックの有効化を参照してください。

レポートに含まれる情報

詳細な使用状況レポートには、アプリケーション、サブシステム、重大度、優先順位、TCO ポリシー、およびタイプごとに以下の情報が含まれます。

日付
合計送信データ (GB)

レポートの生成

データ使用量レポートを CSV ファイルとしてエクスポートするには、以下の手順を実行します：

IBM Cloud Logs インスタンスに移動します： Observability > Logging > Cloud Logs > Your Service Instance > Open Dashboard.
使用状況アイコン > データ使用状況を選択します。

データ使用量ページが開きます。
データ使用量レポートのタイプで 「 詳細レポート 」を選択します。
日付の範囲を選択します。
エクスポート形式を選択します。

有効な値は CSV TSV および JSON。

CSV と TSV を使って、スプレッドシートでデータを管理する。

JSON 、自動化された統合によってデータを管理する。
エクスポート形式 CSV および TSV では、レポートにヘッダーを含めるかどうかを選択します。選択すると、エクスポートされたファイルの最初の行に列名が追加されます。
**「エクスポート」**をクリックします。

APIを使用した詳細なデータ利用レポートのエクスポート

IBM Cloud Logs API を呼び出すことで、プログラム的に詳細なデータ使用レポートをエクスポートすることができます。

次の例は、詳細なデータ使用状況レポートをエクスポートする際に使用できるクエリを示しています。 API を呼び出す際、ID の変数と IAM トークンは、IBM Cloud Logs インスタンスに固有の値に置き換えてください。

詳細なデータ使用状況レポートは、 query クエリパラメータに値 detailed を指定してエクスポートされます。

range リクエストパラメータを使用して、 IBM Cloud Logs インスタンスの指定した時間範囲の詳細なデータ使用レポートを取得できます。 range パラメータの有効な値は、 current_month、 last_30_days、 last_90_days、 last_week です。デフォルトは current_month。

curl 'https://{instance_ID}.api.{region}.logs.cloud.ibm.com/v1/data_usage?query=detailed&&range=last_30_days' \
    -H 'Authorization: Bearer {iam_token}' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json'

応答が成功すると、指定された時間範囲の詳細なデータ使用量レポートが返される。 APIの詳細については、「データ使用状況のエクスポート状況の取得」または「データ使用状況レポートの返却」を参照してください。

CLIを使用した詳細なデータ使用状況レポートのエクスポート

作業を開始する前に、 IBM Cloud Logs インスタンスのAPIエンドポイントを設定する手順に従ってください。

IBM Cloud Logs CLIプラグインを使用して詳細なデータ使用状況レポートをエクスポートするには、コマンドを実行します。 ibmcloud logs data-usage コマンドを実行します。例えば、次のコマンドは過去30日間のデータ使用量の詳細レポートをエクスポートします。

ibmcloud logs data-usage --query detailed --range last_30_days

詳細なデータ使用状況レポートは、 query パラメータに値 detailed を指定してエクスポートされます。

IBM Cloud Logs インスタンスの指定した期間における詳細なデータ使用レポートは、 range リクエストパラメータを使用して取得できます。 range パラメータの有効な値は、 current_month、 last_30_days、 last_90_days、 last_week です。デフォルトは current_month。

コマンドに成功すると、指定した時間範囲の詳細なデータ使用レポートが返される。