產生資料使用情形概觀報告

在 IBM Cloud Logs 中，您可以將 Data Usage Report 匯出為 csv 格式，該格式提供當月、前 30 天或前 90 天的實例資料使用概觀。

您可以產生下列項目的報告:

現行月份
過去 30 天
過去 90 天

先決條件

您必須設定一個 metrics bucket。
您必須啟用資料使用特性。如需詳細資訊，請參閱啟用資料使用量指標。

報告中包含的資訊

「資料使用情形報告」包括下列資訊:

日期
已傳送封鎖資料 (GB)
傳送的低日誌資料 (GB)
傳送的中型日誌資料 (GB)
傳送的高日誌資料 (GB)
已傳送的高度量資料 (GB)
傳送資料總計 (GB)

產生報告

完成下列步驟，將資料使用情況報告匯出為 CSV 檔案：

導覽到您的 IBM Cloud Logs 實例：Observability > 日誌 > 雲端日誌 > 您的服務實體 > 開啟儀表板。
選擇 使用方式 圖示 > 資料使用。

畫面上會出現「資料使用」頁面。
為資料使用情況報告類型選擇概觀報告。
選擇日期範圍。
選擇匯出格式。

有效值為：CSV, TSV，和 JSON。

使用 CSV，和 TSV 透過試算表管理資料。

使用 JSON 透過自動整合來管理資料。
對於匯出格式 CSV 和 TSV，請選擇是否要在報告中包含標題。選取時，列名稱將新增為匯出檔案的第一行。
選擇是否要套用目前的篩選條件到報告。
按一下匯出。

使用 API 匯出概觀資料使用報告

您可以透過呼叫 IBM Cloud Logs API，以程式化的方式匯出概觀資料使用報告。

以下範例顯示您可用於匯出資料使用概觀報告的查詢。當您呼叫 API 時，請將 ID 變數和 IAM 令牌換成您 IBM Cloud Logs 範例的特定值。

使用 query 查詢參數值 daily 匯出概觀資料使用報告。

您可以使用 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=daily&&range=last_30_days' \
    -H 'Authorization: Bearer {iam_token}' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json'

成功的回應會傳回指定時間範圍的資料使用概觀報告。有關 API 的詳細資訊，請參閱 Get data usage metrics export status 或 return data usage report。

使用 CLI 匯出概觀資料使用報告

開始之前，請依照步驟設定您的 IBM Cloud Logs instance API 端點。

若要使用 IBM Cloud Logs CLI 外掛程式匯出資料使用量，請執行 ibmcloud logs data-usage 指令。例如，以下指令會匯出過去 30 天的資料使用詳細報告。

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

使用 query 參數值 daily 匯出概觀資料使用報告。

您可以使用 range 請求參數，擷取 IBM Cloud Logs 範例在指定時間範圍內的資料使用報告。 range 參數的有效值是 current_month, last_30_days, last_90_days，和 last_week。預設值為 current_month。

成功的指令會傳回指定時間範圍的資料使用量每日報告。