コストおよび使用状況レポート

コストおよび使用状況レポートは、毎日生成されてオブジェクト・ストレージ・バケットに格納されるカンマ区切り値(CSV)ファイルです。レポートをダウンロードしてアクセスするには、「コストおよび使用状況レポート」ページを使用します。

使用状況レポートは消費された数量を示し、コスト・レポートはリソース消費のコストを示します。

使用状況レポートは、カンマ区切り値(CSV)ファイルで、監査または請求書の照合を目的として、Oracle Cloud Infrastructureリソースの詳細な内訳の取得に使用できます。

コスト・レポートは、使用状況レポートに似たカンマ区切り値(CSV)ファイルですが、コスト列も含まれます。このレポートを使用すると、リソース・レベルの粒度で請求書明細品目の内訳を取得できます。その結果、Oracle Cloud Infrastructureの支出を最適化し、より多くの情報に基づいてクラウド支出の意思決定を行うことができます。

FinOps Open Cost & Usage Specification (FOCUS)に準拠した業界標準のFOCUS CSVコスト・レポートも生成され、「コストおよび使用状況レポート」ページで使用できます。詳細は、FOCUSコスト・レポート・スキーマを参照してください。FOCUS CSVレポートは、商用レルムのすべてのリージョンで使用できます。

ノート

コストおよび使用状況レポートは、非従量制テナンシには適用されません。

必須IAMポリシー

Oracle Cloud Infrastructureを使用するには、管理者によってポリシーでセキュリティ・アクセス権が付与されている必要があります。このアクセス権は、コンソール、あるいはSDK、CLIまたはその他のツールを使用したREST APIのいずれを使用している場合でも必要です。権限を持っていない、または認可されていないというメッセージが表示された場合は、持っているアクセス権のタイプと作業しているコンパートメントを管理者に確認してください。

ポリシーを初めて使用する場合は、ポリシーの開始共通ポリシーを参照してください。

コストおよび使用状況レポートを使用するには、次のポリシー・ステートメントが必要です:

define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq
endorse group <group> to read objects in tenancy usage-report
ノート

この例では、特定のテナンシOCIDがあります。これは、レポートは、Oracle Cloud InfrastructureによってホストされるOracle所有のオブジェクト・ストレージ・バケットに格納され、顧客のテナンシに格納されないためです。

認証と認可

Oracle Cloud Infrastructureの各サービスは、すべてのインタフェース(コンソール、SDKまたはCLI、およびREST API)の認証および認可のためにIAMと統合されています。

組織の管理者は、どのユーザーがどのサービスとリソースにアクセスできるか、およびアクセスのタイプを制御する、グループコンパートメントおよびポリシーを設定する必要があります。たとえば、ポリシーは、新規ユーザーの作成、クラウド・ネットワークの作成と管理、インスタンスの起動、バケットの作成、オブジェクトのダウンロードなどを実行できるユーザーを制御します。詳細は、ポリシーの開始を参照してください。異なる各サービスに対するポリシーの記述の詳細は、ポリシー・リファレンスを参照してください。

会社が所有するOracle Cloud Infrastructureリソースを使用する必要がある通常のユーザー(管理者ではない)の場合は、ユーザーIDを設定するよう管理者に連絡してください。管理者は、使用する必要があるコンパートメントを確認できます。

コスト・レポート

OCI独自のコスト・レポートとFOCUSのコスト・レポートはどちらも、「コストおよび使用状況レポート」ページでダウンロードできます。コスト・レポートは、6時間おきに自動的に生成され、Oracle所有のオブジェクト・ストレージ・バケットに格納されます。レポートには、Oracle Cloud Infrastructureリソース(インスタンス、オブジェクト・ストレージ・バケット、VNICなど)ごと、時間ごとに1行と、消費情報(使用状況、価格、コスト)、メタデータおよびタグが含まれます。コスト・レポートには、通常、6時間の使用状況データが含まれており、遅れて到着するデータが含まれることもありますが、データは最大24時間遅れる可能性があります。コスト・レポートは1年間保持されます。

FOCUS (FinOps Open Cost & Usage Specification)は、クラウド請求データのオープン・ソースの仕様およびスキーマです。OCIコンソールのFOCUSレポートは、使用日ごとにパーティション化されており、表示に役立つように、縮小可能で展開可能なフォルダ構造に年、月および日ごとに表示されます。たとえば、2024年5月24日に発生した使用状況のレポートについては、「FOCUS Reports > 2024 > 05 > 24」を参照してください。詳細は、コストまたは使用状況レポートのダウンロードを参照してください。

コスト・レポートには、修正を含めることができます。修正はレポートに新しい行として追加され、lineItem/iscorrection列が設定されて、修正された行のreferenceNo値がlineItem/backReference列に移入されます。

各コスト・レポートのファイル名には数値が付いており、この数値は自動的に増加します。最初のファイルには-00001.csv.gzが付加されます。コスト・レポート・ファイルに100万を超えるレコードが存在する場合、コスト・レポート・ファイルは複数のファイルに分割されます。ファイル分割が発生すると、新しい連続したファイルが生成され、ファイル分割ごとに-00002.csv.gz-00003.csv.gzなどが付加されます。コスト・レポート・ファイルのサイズがファイル・サイズのしきい値未満の場合、ファイル分割は行われず、1つのファイルのみが生成されます。

FOCUSレポートのファイル・ネーミングは、使用が発生した年、月および日に対応します。

OCI独自のコスト・レポート・スキーマ

次の表に、OCI独自のコスト・レポート・スキーマを示します。

フィールド名 説明
lineItem/referenceNo 明細識別子。デバッグおよび修正に使用します。
lineItem/TenantId Oracle Cloud Infrastructureテナントの識別子(OCID)。
lineItem/intervalUsageStart リソースの使用間隔の開始時間(UTC)。
lineItem/intervalUsageEnd リソースの使用間隔の終了時間(UTC )。
product/service リソースが属するサービス。
product/compartmentId リソースを含むコンパートメントのID。
product/compartmentName リソースを含むコンパートメントの名前。
product/region リソースが含まれるリージョン。
product/availabilityDomain リソースを含む可用性ドメイン
product/resourceId リソースの識別子。
usage/billedQuantity

使用期間中に請求されたリソースの数量。

ノート: billedQuantitymyCostおよびunitPriceには超過数が含まれます。

cost/billingUnitReadable 明細のusage/billedQuantityに関連付けられた単位。このフィールドは、<count> <GiB/MiB/TiB/PiB> <HOURS/MILLIS/MONTH/SECOND> <measure>という構造になっています。例: ONE GiB MONTH DATA_TRANSFERRED
cost/subscriptionId コミットメントまたはサブスクリプションに関連付けられた一意の識別子。
cost/productSku 明細のリソースの部品番号。
product/description 明細のリソースの製品説明。
cost/unitPrice

使用されたリソースに対して請求される単位当たりのコスト。

ノート: billedQuantitymyCostおよびunitPriceには超過数が含まれます。

cost/myCost

この使用状況明細で請求されるコスト。myCost = usage/billedQuanty * cost/unitPriceとなります。

ノート: billedQuantitymyCostおよびunitPriceには超過数が含まれます。

cost/currencyCode テナンシの通貨コード。
usage/billedQuantityOverage 請求された使用量。
cost/unitPriceOverage リソースの超過使用に対する使用単位当たりのコスト。
cost/myCostOverage リソースの超過使用に対して請求されるコスト。
lineItem/backReference データ修正および修正の参照。既存の明細品目に対する修正が必要な場合、修正された値と元の明細への参照を含む新しい行が追加されます。lineItem/isCorrectionフィールドとともに使用します。
lineItem/isCorrection 現在の明細が訂正の場合に使用します。修正された明細品目への参照については、lineitem/backReference列を参照してください。
tags/ レポートには、タグ定義ごとに1つの列が含まれます(コスト・トラッキング・タグのみではなく、すべてのタグ定義が含まれます)。

FOCUSコスト・レポート・スキーマ

次の表に、OCI独自のコスト・レポート・スキーマへのマッピングを含む、FOCUSコスト・レポート・スキーマを示します。

列ID 表示名 独自のマッピング タイプ 説明
AvailabilityZone 可用性ゾーン product/availabilityDomain 文字列 論理可用性ドメイン
BilledCost 請求済原価 cost/myCost BigDecimal すべての割引が適用された後の計算済コスト。

ノート: 請求コストには税金は含まれず、請求書金額とは異なる場合があります。

BillingAccountId 請求アカウントID ID cost/subscriptionId 文字列 サブスクリプション識別子
BillingAccountName 請求アカウント名 NONE 文字列 NULL
BillingCurrency 請求通貨 cost/currencyCode CurrencyCode 原価の通貨コード。
BillingPeriodEnd 請求期間終了 NONE DateTime 請求期間の終了日時。

ノート: 請求期間の開始と終了は、現在の使用の月次境界に基づいており、コミットメント請求書が発行される日付とは異なる場合があります。

BillingPeriodStart 請求期間開始 NONE DateTime 請求期間の開始日時。
ChargeCategory 手数料カテゴリ lineItem/isCorrection 文字列

前払手数料または定型手数料、すでに発生した使用原価、事後調整(クレジット)または税金を示します。

すでに発生した使用量のコスト(Usage)または事後調整(Adjustment)。
ChargeDescription 手数料摘要 product/description 文字列 手数料の購買および価格のSKU摘要。
ChargeFrequency 請求頻度 NONE 文字列 料金が発生する頻度を示し、繰返し期間を理解するために一般的に使用されます。デフォルトはUsage-basedです。
ChargePeriodEnd 課金期間終了 lineItem/intervalUsageEnd 文字列 使用時間の開始時間(ミリ秒)。
ChargePeriodStart 課金期間開始 lineItem/intervalUsageStart 文字列 エポック以降の使用の終了時間(ミリ秒)。
ChargeSubcategory 手数料サブカテゴリ NONE 文字列 NULL
CommitmentDiscountCategory 取引約定割引カテゴリ NONE 文字列 NULL
CommitmentDiscountId 取引約定割引ID NONE 文字列 NULL
CommitmentDiscountName 取引約定割引名 NONE 文字列 NULL
CommitmentDiscountType コミットメント割引タイプ NONE 文字列 OCIに予約済インスタンスの概念がないため、このフィールドはnullです。
EffectiveCost 有効コスト cost/myCost BigDecimal 適用可能なすべての割引を含む計算済コスト。
InvoiceIssuerName 請求書発行者 NONE 文字列 唯一指定された値としてOracleにデフォルト設定されます。
ListCost リスト原価 NONE BigDecimal 現在の定価に基づく計算済原価。
ListUnitPrice 定単価 NONE BigDecimal 現在のグローバル定価に基づいて、関連するSKUの単一価格設定単位の単価(割引を除く)。
PricingCategory 価格設定カテゴリ NONE 文字列 NULL
PricingQuantity 価格設定数量 usage/billedQuantity BigDecimal 時間単位で端数処理された請求可能値(該当する場合)。
PricingUnit 価格設定ユニット cost/skuUnitDescription 文字列 SKUユニット摘要。
ProviderName プロバイダ NONE 文字列 デフォルトはOracleです。
PublisherName Publisher NONE 文字列 サード・パーティ・マーケットプレイスのリストを除くOracle
リージョン リージョン product/region 文字列 コスト・エントリに関連付けられたリージョンで、一意性のためにtenantId、compartmentId、resourceIdおよびresourceMeterとともに索引付けされます。
ResourceId リソースID product/resourceId 文字列 一意性のためにtenantId、compartmentId、リージョンおよびresourceMeterとともに索引付けされた一意のリソース識別子。
ResourceName リソース名 NONE 文字列 Oracleが原価レポートでこの値を公開しないため、このフィールドはNULLです。
ResourceType リソースの種類 NONE 文字列 料金が適用されるリソースの種類。たとえば、Storageと指定します。
ServiceCategory サービス・カテゴリ NONE 文字列 FOCUSで受け入れられるサービス分類の列挙値。
ServiceName Service Name product/service 文字列 リソースに関連付けられているサービスは、一意性のためにtenantId、compartmentId、resourceIdおよびresourceMeterとともに索引付けされます。
SkuId SKU ID cost/productSku 文字列 一意のSKU ID。
SkuPriceId SKU価格ID NONE 文字列 この構成はOCIに存在しないため、このフィールドはnullです。
SubAccountId サブ・アカウントID lineItem/TenantId 文字列 Oracle Cloud Infrastructureテナントの識別子(OCID)。
SubAccountName サブ・アカウント名 NONE 文字列 テナント名。
タグ タグ tags/ JSON エントリに関連付けられたタグ。バイト配列として格納されます。
UsageQuantity 使用数量 usage/billedQuantity BigDecimal 時間単位で端数処理された請求可能値(該当する場合)。
UsageUnit 使用単位 cost/skuUnitDescription 文字列 SKUユニット摘要。

使用状況レポート

使用状況レポートは、毎日自動的に生成され、Oracle所有のオブジェクト・ストレージ・バケットに格納されます。レポートには、Oracle Cloud Infrastructureリソース(インスタンス、オブジェクト・ストレージ・バケット、VNICなど)ごと、時間ごとに1行と、消費情報、メタデータおよびタグが含まれます。使用状況レポートには、通常、24時間の使用状況データが含まれますが、24時間経過している遅れて到着したデータが含まれることもあります。使用状況レポートは1年間保持されます。

ノート

特定の時間帯にコスト・トラッキング・タグを変更した場合、最後に選択したコスト・トラッキング・タグがその時間に適用されます。たとえば、10:40にタグをAAAからBBBに変更した場合、そのタグの10:00-11:00の使用状況はBBBを反映します。また、タグを遡及的に適用することはできません。

使用状況レポートには、修正を含めることができます。修正はレポートに新しい行として追加され、lineItem/iscorrection列が設定されて、修正された行のreferenceNo値がlineItem/backReference列に移入されます。

各使用状況レポートのファイル名には数値が付いており、この数値は自動的に増加します。

使用状況レポート・スキーマ

次の表に、使用状況レポート・スキーマを示します。

フィールド名 説明
lineItem/referenceNo 明細識別子。デバッグおよび修正に使用します。
lineItem/TenantId Oracle Cloud Infrastructureテナントの識別子(OCID)。
lineItem/intervalUsageStart リソースの使用間隔の開始時間(UTC)。
lineItem/intervalUsageEnd リソースの使用間隔の終了時間(UTC )。
product/service リソースが属するサービス。
product/resource メータリング・システムによって使用されるリソース名。
product/compartmentId リソースを含むコンパートメントのID。
product/compartmentName リソースを含むコンパートメントの名前。
product/region リソースが含まれるリージョン。
product/availabilityDomain リソースを含む可用性ドメイン
product/resourceId リソースの識別子。
usage/consumedQuantity 使用期間中に消費されたリソースの数量。
usage/billedQuantity 使用期間中に請求されたリソースの数量。
usage/consumedQuantityUnits 消費数量および請求数量の単位。
usage/consumedQuantityMeasure 消費数量および請求数量のメジャー。
lineItem/backReference データ修正および修正の参照。既存の明細品目に対する修正が必要な場合、修正された値と元の明細への参照を含む新しい行が追加されます。lineItem/isCorrectionフィールドとともに使用します。
lineItem/isCorrection 現在の明細が訂正の場合に使用します。修正された明細品目への参照については、lineitem/backReference列を参照してください。
tags/ レポートには、タグ定義ごとに1つの列が含まれます(コスト・トラッキング・タグのみではなく、すべてのタグ定義が含まれます)。