FinOps ツールキットの一般的なエラーのトラブルシューティング

[アーティクル]
11/11/2024

この記事では、FinOps ツールキットの一般的なエラーについて説明し、ソリューションに関する情報を提供します。理解できない、または解決できない FinOps ツールキットソリューションを使用しているときにエラーが発生した場合は、次の対応するエラーコードと軽減手順を見つけて問題を解決してください。

軽減情報を含む一般的なエラーコードの一覧を次に示します。

提供された情報で問題が解決しない場合は、トラブルシューティングガイドを試してください。

BadHubVersion

重大度: Critical

FinOps Hubs 0.2 は動作していません。バージョン 0.3 以降にアップグレードします。

軽減策: 最新バージョンの FinOps ハブにアップグレードします。

InvalidExportContainer

重大度: Critical

このファイルは Cost Management からエクスポートされる可能性がありますが、正しいコンテナー内にありません。

軽減策: "msexports" ストレージコンテナーをポイントするように Cost Management エクスポートを更新します。 "インジェスト" コンテナーは、取り込まれたコストデータのクエリにのみ使用されます。

InvalidExportVersion

重大度: Critical

FinOps ハブにはフォーカスコストのエクスポートが必要ですが、このファイルは従来の Cost Management エクスポートのようになります。

軽減策: FOCUS コスト用の新しい Cost Management エクスポートを作成し、現在のエクスポートを停止するか、別のストレージコンテナーにエクスポートするように変更します。

InvalidHubVersion

重大度: Critical

FinOps Hubs 0.1.1 以前は、 Data インジェスト Power BI レポートでは機能しません。

InvalidScopeId

重大度: 情報

エクスポートパスが有効なスコープ ID ではありません。 FinOps ハブでは、エクスポートパスが、管理を簡略化するためにエクスポートが作成されたスコープの Azure リソース ID であることが想定されています。エラーが発生することはありませんが、スコープ関連のレポートの結果が混乱する可能性があります。

軽減策: Cost Management エクスポートのストレージパスを更新して、スコープに完全な Azure リソース ID を使用します。

ExportDataNotFound

重大度: Critical

指定したストレージパスにエクスポートが見つかりませんでした。

軽減策: Cost Management エクスポートが作成され、適切なストレージアカウント、コンテナー、およびストレージパスで構成されたことを確認します。作成後、[今すぐ実行] を選択してエクスポートプロセスを開始します。エクスポートの完了には、アカウントのサイズに応じて 15 ~ 30 分かかる場合があります。 FinOps ハブを使用する場合は、"インジェスト" コンテナーを指すようにストレージ URL を修正します。完全な URL については、FinOps ハブデプロイからの storageUrlForPowerBI 出力を参照してください。

HubDataNotFound

重大度: Critical

FinOps ハブのデータが、指定されたストレージアカウントに見つかりませんでした。

軽減策: このエラーは、FinOps ハブのデプロイに接続していることを前提としています。生のエクスポートを使用する場合は、 ingestion コンテナーを参照しないようにストレージパスを修正します。次の情報を確認します。

ストレージ URL は、FinOps ハブデプロイの StorageUrlForPowerBI 出力と一致している必要があります。
Cost Management エクスポートは、 msexports コンテナーを使用して同じストレージアカウントをポイントするように構成する必要があります。
Cost Management のエクスポートでは、実行履歴に正常なエクスポートが表示されます。
FinOps ハブデータファクトリのトリガーはすべて開始する必要があります。
FinOps ハブのデータファクトリパイプラインが正常に実行されるはずです。

詳細とデバッグ手順については、「 FinOps ハブのデプロイを検証するを参照してください。

MissingContractedCost

重大度: 情報

このエラーコードは、ContractedCostが null または 0 で、EffectiveCostが 0 より大きい場合に、x_DatasetChanges列に表示されます。このエラーは、Microsoft Cost Management に指定された行の ContractedCost が含まれていないことを示しています。これは、節約を計算できないことを意味します。

軽減策: 不足しているデータの回避策として、FinOps ツールキットレポートは、このエラーコードでフラグが設定された行のContractedCost列にEffectiveCostをコピーします。これらのレコードでは、節約は使用できません。

完全な節約額を計算するために、コストと使用状況データを価格と結合できます。詳細については、「 issue #873」を参照してください。

MissingContractedUnitPrice

重大度: 情報

このエラーコードは、ContractedUnitPriceが null または 0 で、EffectiveUnitPriceが 0 より大きい場合に、x_DatasetChanges列に表示されます。このエラーは、Microsoft Cost Management に指定された行の ContractedUnitPrice が含まれていないことを示しています。これは、節約を計算できないことを意味します。

軽減策: 不足しているデータの回避策として、FinOps ツールキットレポートは、このエラーコードでフラグが設定された行のContractedUnitPrice列にEffectiveUnitPriceをコピーします。これらのレコードでは、節約は使用できません。

完全な節約額を計算するために、コストと使用状況データを価格と結合できます。詳細については、「 issue #873」を参照してください。

MissingListCost

重大度: 情報

このエラーコードは、ListCostが null または 0 で、ContractedCostが 0 より大きい場合に、x_DatasetChanges列に表示されます。このエラーは、Microsoft Cost Management に指定された行の ListCost が含まれていないことを示しています。これは、節約を計算できないことを意味します。

軽減策: 不足しているデータの回避策として、FinOps ツールキットレポートは、このエラーコードでフラグが設定された行のListCost列にContractedCostをコピーします。これらのレコードでは、節約は使用できません。

完全な節約額を計算するために、コストと使用状況データを価格と結合できます。詳細については、「 issue #873」を参照してください。

MissingListUnitPrice

重大度: 情報

このエラーコードは、ListUnitPriceが null または 0 で、ContractedUnitPriceが 0 より大きい場合に、x_DatasetChanges列に表示されます。このエラーは、Microsoft Cost Management に指定された行の ListUnitPrice が含まれていないことを示しています。これは、節約を計算できないことを意味します。

軽減策: 不足しているデータの回避策として、FinOps ツールキットレポートは、このエラーコードでフラグが設定された行のListUnitPrice列にContractedUnitPriceをコピーします。これらのレコードでは、節約は使用できません。

完全な節約額を計算するために、コストと使用状況データを価格と結合できます。詳細については、「 issue #873」を参照してください。

ManifestReadFailed

重大度: Critical

パイプライン msexports_ExecuteETL FinOps ハブが Cost Management マニフェストファイルを読み取れませんでした。

対応策:

ハブまたはエクスポートに変更が加えられたときに作業ハブインスタンスでエラーが発生した場合、Cost Management によって既存の API バージョンのマニフェストスキーマが変更された可能性があります。
新規の作成または既存のエクスポートの変更後にエラーが発生した場合、エクスポート API のバージョンでは、サポートされていない新しいマニフェストスキーマが使用される可能性があります。
ハブのデプロイ (初期インストールまたはアップグレード) の後にエラーが発生した場合、デプロイが失敗したか、パイプラインにバグがある可能性があります。

マニフェストスキーマ (#1) または API バージョン (#2) を確認するには、

Azure portal またはストレージエクスプローラーでハブストレージアカウントを開きます。
Azure portal の場合は、メニューの Storage ブラウザー に移動します。
msexports コンテナーを選択します。
問題があるエクスポートのファイル階層を下に移動します (エラーメッセージのマニフェストの場所を参照してください)。
manifest.json ファイルを見つけてメニュー (⋯) を選択し、表示/編集を選択します。

次のプロパティを特定します。

{
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}

次のサポートされている値に設定されていることを確認します。
- resourceId には任意のスコープ ID とエクスポート名を指定できますが、"Microsoft.CostManagement/exports" リソースの種類と共に存在する必要があります。大文字と小文字は区別されません。
- type は存在する必要がありますが、null 以外の値の場合は、このエラーで失敗しないでください。
- dataVersion は存在する必要がありますが、null 以外の値の場合は、このエラーで失敗しないでください。
- apiVersion は明示的には使用されませんが、マニフェストスキーマの変更を示すことができます。詳細については、サポートされている API のバージョンを参照してください。
新しい API バージョンを使用している場合:
1. 新しい API バージョンのサポートの追加を追跡するには、GitHub で変更要求の問題を作成。
2. Cost Management でエクスポートを削除します。
3. サポートされている API バージョンを使用して、 New-FinOpsCostExport PowerShell コマンドを使用してエクスポートを作成します。
  
  ヒント
  
  自分をパワーユーザーと考える場合は、迅速な解決のために自分でパイプラインを更新してみてください。これを行うには、Data Factory を開き、[ > Pipelines > msexports_ExecuteETLの作成] に移動し、該当する "Set" アクティビティを選択し、必要に応じて Settings>Value プロパティを更新します。これを行う場合は、以前のバージョンでエクスポートを再作成する必要はありません。引き続き問題を報告し、パイプライン designer._の右上にある {} アイコンから新しい JSON を共有することを検討してください
サポートされている API バージョンのプロパティが変更されている場合:
1. 破壊的変更を追跡するには、GitHub で変更要求の問題を作成。 manifest.json ファイルから、 type、 dataVersion、および apiVersion を含めます。
2. FinOps ハブやその他のカスタムソリューションを使用して全員が中断されるため、変更を元に戻すように要求するには、Cost Management でサポート要求を提出します。 Cost Management サポートチームがシステム内の問題を特定するのに役立つ次の詳細を含めます。 Cost Management には FinOps ハブに関するコンテキストがないため、詳細は Cost Management の機能に重点を置いておく必要があります。以下に例を示します:
  
  コスト管理のエクスポートを使用して、コストデータを ADLS にプルしています。マニフェストファイルが書き込まれるときにデータを処理する ADF パイプラインがあります。パイプラインは、exportConfig.resourceId、exportConfig.type、およびexportConfig.dataVersionのプロパティが一貫して配信されることを期待する API バージョン<your-supported-api-version>に基づいて構築されました。これらのファイルは、 <your-export-date>で実行されたエクスポート用のこの API バージョンのマニフェストファイルに含まれていないことに気付きました。私の期待は、マニフェストファイルが既存の API バージョンに対して変更されることは決してないことです。これらの変更を元に戻すことができますか?
  
  トラブルシューティングを支援するために、マニフェストファイル {your-manifest-json} を次に示します。

マニフェストのプロパティが適切で、新しいまたはアップグレードされた FinOps ハブインスタンスであった場合は、デプロイを確認します。

Azure portal でハブリソースグループを開きます。
左側のメニューで Settings>Deployments を選択します。
すべてのデプロイが成功したことを確認します。具体的には、次のデプロイ名を探します。
- main
- hub
- dataFactoryResources
- storage
- keyVault
デプロイに失敗した場合は、エラーメッセージを確認して、自分で解決できるかどうかを判断します (名前の競合、修正可能なポリシー違反など)。
エラーが一時的と思われる場合は、もう一度デプロイしてみてください。
エラーが解決しない場合は、 discussion を作成して問題が発生した場合や考えられる回避策 (特にポリシーの問題) を知っている他のユーザーがいるかどうかを確認します。
エラーが明らかにバグまたは機能のギャップである場合は、GitHub でバグまたは機能要求の問題を作成。

2営業日以内に問題や議論に対応するよう努めます。

ResourceAccessForbiddenException

Power BI: 'Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException' 型の例外がスローされました

Power BI でデータを読み込むアカウントに、 Storage BLOB データ閲覧者ロールがないことを示します。 Power BI でデータを読み込むアカウントにこのロールを付与します。

RoleAssignmentUpdateNotPermitted

FinOps Hubs を削除し、マネージド ID 名を含む同じ値で再デプロイしようとすると、次の既知の問題が発生する可能性があります。

"code": "RoleAssignmentUpdateNotPermitted",
"message": "Tenant ID, application ID, principal ID, and scope are not allowed to be updated."

この問題を解決するには、古い ID を削除する必要があります。

ストレージアカウントに移動し、メニューで Access コントロール (IAM) を選択します。
[ロールの割り当て] タブを選択します。
"不明な" ID を持つロールの割り当てを見つけて削除します。

SchemaLoadFailed

重大度: Critical

パイプライン msexports_ETL_ingestion FinOps ハブがスキーマファイルを読み込めませんでした。

軽減策: エラーメッセージを確認して、データセットの種類とバージョンを確認します。データセットの種類とバージョンはアンダースコア ( <type>_<version> や FocusCost_1.0など) で書式設定されています。デプロイされたバージョンの FinOps ハブでデータセットと種類の両方がサポートされていることを確認します。詳細については、サポートされているデータセットを参照してください。

SchemaNotFound

重大度: Critical

パイプライン msexports_ExecuteETL FinOps ハブは、エクスポートされたデータセットのスキーママッピングファイルを見つけることができませんでした。

軽減策: データセットの種類とバージョンがサポートされていることを確認します。詳細については、サポートされているデータセットを参照してください。データセットがサポートされている場合は、 Data インジェストレポートを使用してハブのバージョンを確認。

別のデータセットのサポートを追加するには、カスタムマッピングファイルを作成し、 config/schemas/<dataset-type>_<dataset-version>.jsonに保存します。 <dataset-type> <dataset-version>の値は、Cost Management で使用されているものと大きく一致します。各列のデータ型を識別するには、既存のスキーマファイルをテンプレートとして使用します。一部のデータセットには、EA と Microsoft 顧客契約 (MCA) のスキーマが異なります。これらの属性を使用して識別することはできないため、両方のアカウントの種類がある場合に問題が発生する可能性があります。フォーカスに合わせて、EA と MCA の違いに対応するデータセットとアカウントの追加に取り組んでいます。

UnknownExportFile

重大度: 情報

ハブストレージ内のファイルは、Cost Management からエクスポートされたようには見えません。ファイルは無視されます。

軽減策: msexports コンテナーは、Cost Management のエクスポートのみを対象としています。別のストレージコンテナー内の他のファイルを移動します。

UnknownHubVersion

重大度: Critical

設定ファイルから FinOps ハブのバージョンを識別できません。設定が正しいことを確認します。 FinOps ハブ 0.1.1 以前は、この Power BI レポートでは機能しません。

UnsupportedExportFileType

重大度: Critical

ファイルの種類がサポートされていないため、指定したエクスポートファイルを取り込むことができません。

軽減策: msexports コンテナーに追加する前に、ファイルをサポートされているファイル形式に変換するか、新しいファイルの種類を msexports_ETL_ingestion パイプラインに変換するためのサポートを追加します。

UnsupportedExportType

重要度: 警告

ハブストレージのエクスポートマニフェストは、エクスポートがサポートされていないデータセット用であることを示します。エクスポートされたデータは、インジェストエラーとして報告されます。

<name> リソースプロバイダーはサブスクリプション <guid に登録されていません>

Azure portal でサブスクリプションを開き、 Settings>Resource providers を選択し、リソースプロバイダーの行 (Microsoft.EventGrid など) を選択してから、ページの上部にある Register コマンドを選択します。登録には数分かかる場合があります。

コミットメント割引 ID を示すx_PricingSubcategory

2024 年 2 月 28 日より前の Cost Management のエクスポートには、コミットされた使用に対して x_PricingSubcategory が正しく設定されていないバグがありました。 Committed SpendやCommitted Usageなどの値が表示されます。代わりに、次のような値が表示されることがあります。

Committed /providers/Microsoft.BillingBenefits/savingsPlanOrders/###/savingsPlans/###
Committed /providers/Microsoft.Capacity/reservationOrders/###/reservations/###

これらの値が表示された場合は、その月のコストデータを再エクスポートします。使用できない古い月のデータをエクスポートする必要がある場合は、サポートに問い合わせて、前のエクスポート実行のデータ品質の問題を解決するために、データのエクスポートを要求してください。

Power BI: レポートに特定の日付のデータがありません

レポートにすべてのデータが 1 か月以上不足している場合は、 Number of Months、 RangeStart、および RangeEnd パラメーターを調べて、データがフィルター処理されていないことを確認します。

パラメーターを確認するには、リボンで Transform data>Edit parameters を選択するか、クエリエディターウィンドウの 🛠️ Setup フォルダーで個々のパラメーターを選択します。

特定の月数を常に表示する場合は、 数の月数 を終了 (完了) 月数に設定します。現在の月は、終了した月数に加えて、追加の月です。
時間の経過に伴って変化しない固定の日付範囲 (会計年度レポートなど) が必要な場合は、 RangeStart と RangeEnd を設定します。
使用可能なすべてのデータをレポートする場合は、3 つの日付パラメーターがすべて空であることを確認します。

詳細については、「最初のレポートを設定するを参照してください。

Power BI: レポートが空 (データなし)

Power BI やその他のレポートやツールにデータが表示されない場合は、データソースに基づいて次の手順を試してください。

Power BI で Cost Management コネクタを使用している場合は、 Billing Account ID パラメーターと Number of Months パラメーターを確認して、正しく設定されていることを確認します。過去数か月間、古い請求先アカウントにデータが含まれていない可能性があることに注意してください。
FinOps ハブを使用している場合は、ストレージアカウントを調べて、 ingestion コンテナーにデータが入力されていることを確認します。 providers または subscriptions フォルダーが表示されます。次のセクションを使用して、さらにトラブルシューティングを行います。

FinOps ハブ: インジェストコンテナーが空です

ingestion コンテナーが空の場合は、Data Factory Studio で Data Factory インスタンスを開き、Manage>Author>Triggers を選択し、msexports_FileAdded トリガーが開始されていることを確認します。そうでない場合は、開始します。

トリガーが "リソースプロバイダーが登録されていません" というエラーで開始できない場合は、Azure portal でサブスクリプションを開き、 Settings>Resource プロバイダーを選択し、 Microsoft.EventGrid 行を選択してから、ページの上部にある Register コマンドを選択します。登録には数分かかる場合があります。

登録が完了したら、 msexports_FileAdded トリガーをもう一度開始します。

トリガーが開始されたら、接続されているすべての Cost Management エクスポートを再実行します。アカウントのサイズに応じて、10 ~ 20 分以内にデータを完全に取り込む必要があります。

問題が解決しない場合は、Cost Management エクスポートがファイルパーティション分割が有効になっているかどうかを確認します。無効になっている場合は、有効にしてエクスポートを再実行します。

ingestion コンテナーが設定されていることを確認し、レポートやその他の接続されているツールを更新します。

FinOps ハブ: インジェストコンテナーで使用可能なファイル

ingestionコンテナーが空でない場合は、フォルダーをドリルダウンして、parquetまたはcsv.gzファイルがあるかどうかを確認します。

わかったら、power BI レポートで FileType パラメーターが .parquet または .gz に設定されていることを確認します。詳細については、データへの接続を参照してください。

別のツールを使用している場合は、使用しているファイルの種類がサポートされていることを確認します。

Power BI: リモート名を解決できませんでした: '<storage-account>.dfs.core.windows.net'

ストレージアカウント名が正しくないことを示します。 FinOps ハブを使用している場合は、デプロイの StorageUrl パラメーターを確認します。詳細については、データへの接続を参照してください。

Power BI: 値 null を論理型に変換できません

Billing Account ID パラメーターが空であることを示します。 FinOps ハブを使用している場合は、目的の課金アカウント ID に値を設定します。課金アカウントにアクセスできない場合、またはコミットメントの購入と払い戻しを含めない場合は、値を 0 に設定し、詳細エディターで CostDetails クエリを開き、 2 を 1に変更します。 Cost Management コネクタから実際または請求済みのコストデータを読み込まないようレポートに通知します。詳細については、データへの接続を参照してください。

該当するバージョン: 0.1 から 0.1.1 ( 0.2 で修正)

FinOps ハブ: 値 null を Table 型に変換できません

このエラーは通常、データが ingestion コンテナーに取り込まれていないことを示します。

FinOps Hubs 0.2 にアップグレードしたばかりの場合、Power BI レポートが古い (0.1.x から) か、FOCUS エクスポートを使用していないために問題が発生する可能性があります。詳細については、アップグレードガイドを参照してください。

トラブルシューティングの手順については、レポートが空 (データなし) を参照してください。

発生しているエラーが表示されない場合は、トラブルシューティングガイドを参照してください。ご質問がある場合は、GitHub でディスカッションを開始するか問題を作成してください。

次の方法で共有

FinOps ツールキットの一般的なエラーのトラブルシューティング

BadHubVersion

InvalidExportContainer

InvalidExportVersion

InvalidHubVersion

InvalidScopeId

ExportDataNotFound

HubDataNotFound

MissingContractedCost

MissingContractedUnitPrice

MissingListCost

MissingListUnitPrice

ManifestReadFailed

ResourceAccessForbiddenException

RoleAssignmentUpdateNotPermitted

SchemaLoadFailed

SchemaNotFound

UnknownExportFile

UnknownHubVersion

UnsupportedExportFileType

UnsupportedExportType

<name> リソースプロバイダーはサブスクリプション <guid に登録されていません>

コミットメント割引 ID を示すx_PricingSubcategory

Power BI: レポートに特定の日付のデータがありません

Power BI: レポートが空 (データなし)

FinOps ハブ: インジェストコンテナーが空です

FinOps ハブ: インジェストコンテナーで使用可能なファイル

Power BI: リモート名を解決できませんでした: '<storage-account>.dfs.core.windows.net'

Power BI: 値 null を論理型に変換できません

FinOps ハブ: 値 null を Table 型に変換できません

フィードバック

その他のリソース

次の方法で共有

FinOps ツールキットの一般的なエラーのトラブルシューティング

BadHubVersion

InvalidExportContainer

InvalidExportVersion

InvalidHubVersion

InvalidScopeId

ExportDataNotFound

HubDataNotFound

MissingContractedCost

MissingContractedUnitPrice

MissingListCost

MissingListUnitPrice

ManifestReadFailed

ResourceAccessForbiddenException

RoleAssignmentUpdateNotPermitted

SchemaLoadFailed

SchemaNotFound

UnknownExportFile

UnknownHubVersion

UnsupportedExportFileType

UnsupportedExportType

<name> リソース プロバイダーはサブスクリプション <guid に登録されていません>

コミットメント割引 ID を示すx_PricingSubcategory

Power BI: レポートに特定の日付のデータがありません

Power BI: レポートが空 (データなし)

FinOps ハブ: インジェスト コンテナーが空です

FinOps ハブ: インジェスト コンテナーで使用可能なファイル

Power BI: リモート名を解決できませんでした: '<storage-account>.dfs.core.windows.net'

Power BI: 値 null を論理型に変換できません

FinOps ハブ: 値 null を Table 型に変換できません

関連するコンテンツ

フィードバック

その他のリソース

<name> リソースプロバイダーはサブスクリプション <guid に登録されていません>

FinOps ハブ: インジェストコンテナーが空です

FinOps ハブ: インジェストコンテナーで使用可能なファイル