OCI コストレポートの出力 （スケジュール済みレポート機能）

はじめに

OCIで日々のリソース利用料を確認する際にOCIコンソールを利用されている方も多いと思います。
今回は、都度OCIコンソールにログインしてレポートをダウンロードしなくても、
自分の欲しいレポート形式で保存し、定期的に任意のObject Storageに出力しておくことができる スケジュール済みレポート機能を使ってみます。

作業の流れ

1. ユーザーへの権限付与
2. スケジュール済みレポート機能で設定をする Object Storage のバケットの作成 (既存のものでも可)
3. 定義済みのコスト分析レポートを出力したい形式にレポートを編集、保存
4. スケジュール済みレポートの作成
5. 自身のPC端末にObject Storageからレポートをダウンロード

ユーザーへの権限付与

• スケジュール済みレポートを使用する上で必要なIAM権限
  • 参照マニュアル：
    https://docs.oracle.com/ja-jp/iaas/Content/Billing/Concepts/costs.htm#Required
  • コストおよび使用状況レポート機能利用に必要なIAMポリシー
    https://docs.oracle.com/ja-jp/iaas/Content/Billing/Concepts/usagereportsoverview.htm#policy
  • スケジュール済みレポート機能利用に必要なIAMポリシー
    https://docs.oracle.com/ja-jp/iaas/Content/Billing/Concepts/scheduledreportoverview.htm#scheduledreportoverview__iam_policy_scheduledreport

Object Storage Bucketの作成と事前認証済みリクエストの作成

• プライベートバケットでもパブリックバケットでもどちらでもOK
• 事前認証済みリクエストの作成
  • リクエスト・ターゲット : バケット
  • アクセスタイプ：　オブジェクトの読み取りを許可
  • オブジェクト・リストの有効化　：
    • チェックを入れる

• 発行されたURLをコピーして保存しておく
  

コスト分析レポートの編集

• OCIのメニュー画面から、請求とコスト管理 カテゴリの [コスト分析] を選択
  

• 今回は、定義済みレポートとして用意されている サービス別コスト レポートを使い、
  グループ化ディメンションで、サービスとSKU(部品番号) を表示できるように編集
  
  

• [適用] をして内容確認後、レポートを [新規レポートとして保存] しておきます。
  
  

スケジュール済みレポートの作成

• OCIのメニュー画面から、請求とコスト管理 カテゴリの [スケジュール済みレポート] を選択
  

• [スケジュール済みレポートの作成] を選択
  

  • 名前：任意

  • 保存されたレポート：前段のコスト分析画面で新規レポートとして保存したレポートを選択
    

  • 開始日：任意

  • 反復：毎日 /　毎月 / 1回 から選択
    

  • 形式 : csv / PDF　どちらかを選択

  • バケットの ：前段で作成 もしくは既存のバケットを選択
    

• [作成] ボタンをクリック
  

選択したバケットに適切な権限がない場合は選択ができず、以下のような情報がでます。
metering_overlayサービスがバケットに対して書き込みができるようにIAMポリシーを変更する必要があります。

• 作成直後、初回のレポート出力がされるまでは以下のように最終実行ステータスは不明となります。
  

• スケジュールが実行された場合、成功ステータスに変わります。
  

• ジョブ名をクリックすると出力されたレポート名も確認できました。
  

curlでレポートダウンロード

この状態で事前承認済みリクエスト で発行したURLを使い自分のwindowsのコマンドプロントで自動的に出力されるレポートを取得します。

Object Storageに出力されているレポートの名前をリストして確認

curl -X GET  https://objectstorage.ap-tokyo-1.oracle.com/xxxxxxxxxxxxxx/b/costreport/o/

実行すると、日付が入ったobject名がリストされるため、ほしい日付のファイル名を指定してダウンロード

curl -O https://objectstorage.ap-tokyo-1.oracle.com/xxxxxxxxxxxxxx/b/costreport/o/DailyReport_xxxxxx.csv.gz

取得したレポートの例

• csvの場合
  

• PDFの場合
  

おわりに

今回は手軽にレポートを取得するところまでを試しましたが、
スケジュール済みレポート機能を利用してObject Storageへ出力しておけば、functionサービスなどと連携して、レポートのメール配信なども可能だと思います。
また、コスト管理の効率化という意味だと、Autonomous Databaseを利用したコストと使用量をより柔軟に管理するためのツールなども公開されていますのでぜひ参考にしてください。

• 参考Qiita

  • [OCI] 前回実行時からの差分のコストレポートファイルのみをダウンロードするシェルスクリプトを作って実行してみた　
    https://qiita.com/500InternalServerError/items/f34de1bff9e457725547

• 参考Blog

  • Oracle Cloud Infrastructureのコストと使用量を管理
    https://blogs.oracle.com/oracle4engineer/post/ja-manage-your-oracle-cloud-cost-and-usage