データ使用状況の概要レポートの生成

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

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

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

前提条件

レポートに含まれる情報

データ使用状況レポートには、以下の情報が含まれます。

  • 日付
  • 送信データ・ブロック (GB)
  • 送信した低ログ・データ (GB)
  • 送信されたメディア・ログ・データ (GB)
  • 送信された高ログ・データ (GB)
  • 送信したハイ・メトリック・データ (GB)
  • 合計送信データ (GB)

レポートの生成

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

  1. IBM Cloud Logs インスタンスに移動します： Observability > Logging > Cloud Logs > Your Service Instance > Open Dashboard.

  2. 使用状況アイコン使用状況アイコン > データ使用状況を選択します。

    データ使用量ページが開きます。

  3. データ使用量レポートタイプで 「概要レポート 」を選択します。

  4. 日付の範囲を選択します。

  5. エクスポート形式を選択します。

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

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

    JSON 、自動化された統合によってデータを管理する。

  6. エクスポート形式 CSV および TSV では、レポートにヘッダーを含めるかどうかを選択します。 選択すると、エクスポートされたファイルの最初の行に列名が追加されます。

  7. 現在のフィルタをレポートに適用するかどうかを選択します。

  8. **「エクスポート」**をクリックします。

APIを使用した概要データ使用レポートのエクスポート

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

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

概要データ使用レポートは、 query クエリパラメータに値 daily を指定してエクスポートされます。

IBM Cloud Logs インスタンスの指定した時間範囲の概要データ使用レポートは、 range リクエストパラメータで取得できます。 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=daily&&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 daily --range last_30_days

概要データ使用レポートは、 query パラメータに値 daily を指定してエクスポートされます。

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

コマンドに成功すると、指定された時間範囲のデータ使用日報が返される。