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

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

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

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

リソースへのアクセスが禁止されています

^{重大度: 重大}

通常、このエラーは、接続しているアカウントが、使用しようとしているリソースにアクセスしていないことを意味します。

対策: 正しい Microsoft Entra ID テナントで正しいアカウントを利用していることを確認してください。

アカウントのプロパティを更新できません

^{重大度: 重大}

通常、このエラーは、作成時に最初に使用されたストレージアカウント構成とは異なるストレージアカウント構成で FinOps ハブのデプロイを更新するときに発生します。ほとんどのプロパティは変更できますが、ストレージアカウントの作成時に 1 回しか設定できず、変更できないプロパティがいくつかあります。 FinOps ハブに関してこの 1 つの既知のケースは、"requireInfrastructureEncryption" プロパティです。このプロパティが最初の FinOps ハブのデプロイ中に有効または無効にされた場合、変更することはできません。この場合、次のエラーが表示されます。

プロパティ 'requireInfrastructureEncryption' は入力で指定されましたが、読み取り専用であるため更新できません。

軽減策: この設定を変更するつもりがない場合は、ストレージアカウントがインフラストラクチャ暗号化を使用するように構成されているかどうかを確認し、同じ値 (オンまたはオフ) で FinOps ハブテンプレートを再デプロイします。設定を変更する場合は、新しい FinOps ハブインスタンスをデプロイすることをお勧めします。これにより、すべてのデータを再読み込みする必要があります。

既存のストレージアカウントを削除し、インフラストラクチャ暗号化を変更してテンプレートを再デプロイすることができます。しかし、私たちはこれを徹底的にテストしていません。問題は予測されませんが、問題が発生するかどうかは確認できません。

バッドハブバージョン

^{重大度: 重大}

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

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

テーブル 'Resources' の列 'id' に重複する値が含まれています

^{重大度: 重大}

次のエラーが発生した場合は、Azure Resource Graph が ID 列に同じ論理値を持つ行を返していることを意味します。リソース ID の値の大文字と小文字が不一致である場合や、別の列が複数の行にまたがって展開されている場合に、これが発生する可能性があります。

テーブル 'Resources' の列 'id' には重複する値 '{resource-id}' が含まれています。これは、多対一リレーションシップの一方の列や、テーブルの主キーとして使用される列では使用できません。

軽減策: 最新バージョンのレポートを使用していることを確認します。重複する値の原因を特定し、重複する値を回避するようにクエリを更新します。今後のリリースで修正できるように、 GitHub でもこの問題を報告してください。エラーの原因をトラブルシューティングするには、追加の詳細または会議が必要な場合があります。

競合エラー

^{重大度: 重大}

このエラーのインスタンスが複数存在する可能性があります。既知のインスタンスの 1 つは、Key Vault から次のエラーが返されたときです。

同じ名前のボールトが既に削除済みの状態で存在します。既存のキーボールトを復旧または消去する必要があります。論理的な削除の詳細については、このリンク https://go.microsoft.com/fwlink/?linkid=2149745 に従ってください。

これは通常、削除された古いデプロイの上にデプロイしているが、Key Vault は古いコンテナーインスタンスを回復可能な削除状態に保っていることを意味します。

軽減策: これを修正するには、Azure portal で削除された Key Vault を消去します。

Azure portal で Key Vault インスタンスの一覧を開きます。
ページの上部にある [ 削除されたコンテナーの管理 ] コマンドを選択します。
ドロップダウンでサブスクリプションを選択します。
削除する保管庫を確認します。
フライアウトの下部にある消去を選択します。
確認ダイアログで [削除] を選択 します 。

これで、デプロイを再試行できます。

契約したコストが実際のコストよりも低い

^{重要度: 警告}

ContractedCost (ネゴシエートされた割引に基づく) は、Cost Management のデータの EffectiveCost (コミットメント割引後) 未満です。コミットメント割引が既存の交渉済み割引よりも少ない割引を提供しない限り、この問題は発生しません。これにより、節約計算が正確に加算されなくなります。

軽減策: コストデータの ContractedUnitPrice が価格データの内容と一致したことを確認します。契約価格が正しい場合は、Cost Management チームにサポートリクエストを提出して、 x_EffectiveUnitPrice と EffectiveCost が正しいことを確認します。正しい場合は、コミットメント割引の返却を検討してください。

テナント間アクセスポリシーでは、このユーザーは許可されません

^{重大度: メジャー}

次のエラーが発生した場合は、他のテナントのユーザーが現在のテナントにサインインできないように Microsoft Entra ID が構成されていることを意味します。

メッセージ: AADSTS500213: リソーステナントのクロステナントアクセスポリシーでは、このユーザーがこのテナントにアクセスできません。

このエラーメッセージは、FinOps ツールキットに関連していません。

軽減策: 正しいアカウントにサインインしていること、およびターゲットディレクトリ経由でサインインしていることを確認します。さらにサポートが必要な場合は、ディレクトリ管理者に問い合わせてください。

データエクスプローラーの取り込みに失敗しました

^{重大度: 重大}

データエクスプローラーの取り込みに失敗しました。新しいデータはレポートに使用できません。

一般的なエラー: SEM0080 assert() が "インジェストに失敗しました" というメッセージで失敗しました

Azure Data Factory パイプラインに次のセマンティックエラーが表示される場合:

セマンティックエラー: リロップセマンティックエラー: SEM0080: assert() が失敗し、「インジェストの失敗」というメッセージが発生しました

このエラーは、データエクスプローラー .ingest コマンドがインジェストプロセス中にエラーを検出したことを示します。インジェストコマンドには、コマンド結果のassert(iff(toscalar($command_results | project-keep HasErrors) == false, true, false), "Ingestion Failed")列を検証するアサーションチェック (HasErrors) が含まれています。 HasErrorsがtrueされると、アサーションは失敗し、このエラーがトリガーされます。

一般的な根本原因:

空の Parquet ファイル: Parquet ファイルにデータ行が含まれていません。これが最も一般的な原因です。
- Cost Management エクスポートで空のファイルが生成されました (期間のデータなし)
- ETL パイプラインによって、変換中に空の Parquet ファイルが作成されました
- ファイルが作成されましたが、データ書き込み操作に失敗しました
スキーマの不一致: Parquet ファイルスキーマがターゲットテーブルのインジェストマッピング参照と一致しません。
- Parquet ファイル内の列の名前またはデータ型が予想と異なる場合があります
- インジェストマッピング (例: <table>_mapping) が古いか、正しくない可能性があります
- マッピングに含まれていない新しい列がエクスポートスキーマに追加されました
破損または無効な Parquet ファイル: ソースファイルの形式が正しくないか、破損しているか、有効な Parquet ファイルではない可能性があります。
インジェストマッピングが見つからないか、正しくない: 参照されるマッピング ( Costs_raw_mapping など) が存在しないか、列定義が正しくありません。
データ型変換エラー: Parquet ファイル内のデータは、テーブルスキーマで定義されているターゲット列の型に変換できません。
ファイルアクセスの問題: アクセス許可またはネットワークの問題により、データエクスプローラーはストレージ内の Parquet ファイルにアクセスできません。

軽減策の手順:

データエクスプローラーでインジェストエラーを確認します。
- Data Explorer クラスター/データベースに接続する
- 次のクエリを実行して、詳細なエラー情報を表示します。
```
.show ingestion failures
| where FailedOn > ago(4h) and Database == "<YourDatabaseName>"
| project FailedOn, Table, IngestionSourcePath, ErrorCode, Details
```
- 空のファイル、スキーマの不一致、またはデータの問題に関する特定のエラーメッセージについては、 Details 列を確認します
- 空のファイルを示す BadRequest_NoRecordsOrWrongFormat などのエラーコードを探します
Parquet ファイルが空かどうかを確認します。
- 問題のある Parquet ファイルをインジェストコンテナーからダウンロードします (パスはエラーメッセージにあります)
- Parquet ビューアーツールまたは Azure Storage Explorer を使用してファイルを検査する
- ファイルサイズを確認する - 非常に小さい場合 (< 1 KB)、空である可能性があります
- ファイルにデータ行が含まれていることを確認する
- 空の場合: これは、期間のデータがない場合に予期される動作です。ファイルは、インジェストコンテナーから安全に削除できます。 Cost Management では、何か月も空のファイルがエクスポートされ、使用しない場合があります。
インジェストマッピングが存在し、正しいことを確認します。
- データエクスプローラーで次のクエリを実行して、マッピングが存在するかどうかを確認します。
```
.show table <TableName> ingestion mappings
```
- マッピングが見つからない場合は、再作成する必要があります。 FinOps ハブのデプロイログでマッピング作成エラーを確認します。
- マッピングが存在する場合は、データソースの予想されるスキーマと一致するかどうかを確認します
スキーマの変更を確認します。
- Cost Management のエクスポートを最近更新した場合、またはエクスポートバージョンを変更した場合 (例: FOCUS 1.0 から 1.2)、スキーマが変更されている可能性があります
- msexports コンテナー内の manifest.json ファイル内のエクスポートデータセットのバージョンを確認する
- FinOps ハブでデータセットのバージョンがサポートされていることを確認する - サポートされているデータセットを参照してください
データエクスプローラーの診断を確認します。
- Azure portal で、Data Explorer クラスターに移動します
- 監視>診断設定へ移動します
- まだ有効になっていない場合 FailedIngestion 診断ログを有効にする
- Log Analytics のログで詳細なエラー情報を確認する
マッピングがない場合は、FinOps ハブを再デプロイします。
- インジェストマッピングが見つからないか破損している場合は、FinOps ハブを再デプロイして再作成します
- これにより、すべてのテーブル、マッピング、および関数がデータ損失なしで再作成されます
Azure Data Explorer のメトリックを確認します。
- Azure Monitor で インジェスト結果 メトリックを確認する
- 状態でフィルター処理して成功率と失敗率を確認する
- 詳細については、キューに登録されたインジェストの監視を参照してください
問題を修正した後、インジェストを再実行します。
- 根本原因を解決した後、 ingestion_ExecuteETL パイプラインを再実行します
- エラーメッセージのフォルダーパスをパラメーターとして指定する
- パイプラインの実行を監視して、インジェストが成功したことを確認する
- 注: 空のファイルは再移行する必要はありません。無視しても問題ありません

その他のリソース:

これらの手順に従った後もこのエラーが引き続き発生する場合は、次の情報に関する問題を報告してください。

ADF パイプラインからの完全なエラーメッセージ
.show ingestion failures クエリからの出力
manifest.json ファイルのデータセットの種類とバージョン
FinOps ハブバージョン

データエクスプローラーのインジェスチョンマッピングに失敗しました

^{重大度: 重大}

指定したテーブルに対してデータエクスプローラーのインジェストマッピングを作成できませんでした。

軽減策の: エラーを修正し、指定したフォルダーパスのインジェストを再実行してください。このエラーが引き続き表示される場合は、https://aka.ms/ftk/ideasで問題を報告してください。

データエクスプローラーのインジェストタイムアウト

^{重大度: 重大}

データエクスプローラーのインジェストは、使用可能な容量を待機している間、2 時間後にタイムアウトしました。

軽減策の: インジェストを再試行するには、このパイプラインを再実行してください。このエラーが引き続き表示される場合は、https://aka.ms/ftk/ideasで問題を報告してください。

データエクスプローラー処理後の削除に失敗しました

^{重大度: 重大}

データエクスプローラーのインジェスト後のクリーンアップ (最終的なテーブルからのエクステントの削除) に失敗しました。以前のインジェストのデータがレポートに存在する可能性があり、その結果、重複して不正確なコストが発生する可能性があります。

このエラーは、以下のような場合に発生します。

Data Explorer クラスターで容量の問題または高いリソース使用率が発生している
drop extents コマンドで、無効な式または構文エラーが発生しました
データエクスプローラーデータベースへのアクセスに関するアクセス許可の問題がある
Data Factory と Data Explorer の間のネットワーク接続の問題

対応策:

詳細なエラーメッセージを確認します。Azure Data Factoryの>モニター>パイプラインの実行に移動し>、失敗した実行をクリックします>。「取り込み後のドロップ失敗エラー」アクティビティを表示して、特定のData Explorerエラーコードとメッセージを確認します。
エラーの種類に基づく一般的な解決策:
- "取り込み後のドロップ失敗エラーの解釈に失敗しました" というエラーメッセージまたはエラーコードが表示された場合: これは、Fail アクティビティの動的な式を評価できなかったことを示します。これは通常、次のことを意味します。
  - Post-Ingest Cleanup アクティビティは失敗しましたが、予期された形式でエラーの詳細が返されませんでした
  - 実際のデータエクスプローラーエラーの確認には、Post-Ingest Cleanup アクティビティの出力をチェックしてください。
  - この特定のエラーパターンの詳細については、 ErrorCodeNotString を参照してください
- 容量/リソースの問題の場合:
  - 数分待ってからパイプラインを再実行します
  - Azure Monitor で Data Explorer クラスターメトリックを確認する
  - 容量制限に一貫して達している場合は、クラスターのスケールアップを検討してください
- アクセス許可の問題の場合:
  - Data Factory マネージド ID に Data Explorer データベースに対する適切なアクセス許可があることを確認する
  - マネージド ID に少なくとも "Database Ingestor" ロールと "Database Admin" ロールがあることを確認します
- 構文/式エラーの場合:
  - Data Explorer クエリエディターで .show commands を使用して Data Explorer コマンドログを確認する
  - ドロップエクステントクエリに影響する可能性がある最近のスキーマ変更を確認する
インジェストの再実行: 問題が解決したら、Azure Data Factory の ingestion_ExecuteETL パイプラインを使用して、指定したフォルダーのデータインジェストを再実行します。
データの重複を防ぐ: エラーが解決しない場合は、インジェストを再実行する前に、Data Explorer コマンドを使用して重複するエクステントを手動でクリーンアップすることが必要になる場合があります。サポートに問い合わせてください。

詳細については、以下を参照してください。

https://aka.ms/ftk/ideasで未解決の問題を報告します。

データエクスプローラー事前インジェスション削除失敗

^{重大度: 重大}

データエクスプローラーのインジェスト前のクリーンアップ (生テーブルからのエクステントの削除) に失敗しました。インジェストが完了していません。

このエラーは、新しいデータを取り込む前に実行されるデータエクスプローラーのクリーンアップ手順が失敗した場合に発生します。このクリーンアップは、生テーブル内のデータの重複を防ぐために必要です。

対応策:

詳細なエラーメッセージを確認します。Azure Data Factory の > モニター > パイプラインの実行に移動し、> 失敗した実行をクリックします。> "事前インジェストドロップ失敗エラー" アクティビティを表示して、特定の Data Explorer エラーコードとメッセージを確認します。
エラーの種類に基づく一般的な解決策:
- "取り込み前のドロップ失敗エラーメッセージまたはエラーコードの解釈に失敗しました" と表示される場合: トラブルシューティングの手順については、 ErrorCodeNotString を参照してください。
- 容量/リソースの問題の場合:
  - 数分待ってからパイプラインを再実行します
  - Azure Monitor で Data Explorer クラスターメトリックを確認する
- アクセス許可の問題の場合:
  - Data Factory マネージド ID に Data Explorer データベースに対する "データベース管理者" ロールがあることを確認する
- 構文/式エラーの場合:
  - Data Explorer クエリエディターで .show commands を使用して Data Explorer コマンドログを確認する
インジェストの再実行: 問題が解決したら、Azure Data Factory の ingestion_ExecuteETL パイプラインを使用して、指定したフォルダーのデータインジェストを再実行します。

詳細については、 DataExplorerPostIngestionDropFailed の軽減手順を参照してください。

https://aka.ms/ftk/ideasで未解決の問題を報告します。

デプロイメント出力評価失敗

^{重大度: メジャー}

FinOps Hubs 0.8 では、Azure Data Explorer の "trustedExternaltenants" セキュリティ設定を設定して、クラスターをロックダウンして、特定の信頼されたテナントからのみアクセスできるようにします。この設定は最初の展開に対して設定できますが、2 番目の展開では再び設定することはできません。既存の 0.8 デプロイの上に FinOps Hubs 0.8 を再デプロイしようとすると、次のエラーが表示されることがあります。

テンプレート出力 'clusterUri' が無効です。言語式プロパティ 'uri' が存在しません。使用可能なプロパティは 'trustedExternalTenants、enableStreamingIngest、publicNetworkAccess、enableAutoStop、provisioningState' です。

Azure Data Explorer チームにフォローアップして、正しい解決策を特定しています。

軽減策: FinOps ハブ 0.9 をデプロイします。この設定はテンプレートから削除されました。

エクスポートデータが見つかりません

^{重大度: 重大}

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

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

エクスポートタイプ未定義

^{重大度: 重大}

この課金スコープの種類は、マネージドエクスポートではサポートされていません。

軽減策: settings.jsonからサポートされていない課金スコープを削除し、FinOps ハブで課金スコープがサポートされていることを確認し、課金スコープの新しいコスト管理エクスポートを手動で作成します。

エクスポートタイプサポートされていません

^{重大度: 重大}

Microsoft 顧客契約は、マネージドエクスポートではサポートされていません。

軽減策: settings.json から MCA 課金スコープを削除し、FOCUS コスト、価格シート、予約の詳細、予約トランザクション、および予約の推奨事項について、MCA 課金プロファイルごとに新しい Cost Management エクスポートを手動で作成します。

ErrorCodeNotString

^{重大度: 重大}

このエラーは、Azure Data Factory Fail アクティビティが動的エラーメッセージまたはエラーコード式を有効な文字列に評価できない場合に発生します。エラーメッセージは、通常、エラーコードがされた "ErrorCodeNotString 失敗メッセージまたはエラーコードを解釈できませんでした" と表示されます。

一般的なシナリオ:

親アクティビティ ( Post-Ingest Cleanup、 Pre-Ingest Cleanup、 Ingest Dataなど) が失敗しましたが、予期された形式でエラー出力が生成されませんでした
動的式は、アクティビティ出力に存在しないプロパティへのアクセスを試みます
アクティビティの出力が null、空、または予想される JSON 構造にない

対応策:

根本原因アクティビティを特定する: 失敗アクティビティをトリガーしたアクティビティを確認します (たとえば、"取り込み後のドロップ失敗エラー" が表示された場合は、"取り込み後のクリーンアップ" アクティビティを確認します)。
親アクティビティの出力を確認します。
- Azure Data Factory > Monitor > のパイプライン実行に移動します
- 「失敗したパイプラインの実行をクリックしてください」
- 失敗アクティビティの直前に実行されたアクティビティを見つけてクリックします
- [出力] タブを確認して、実際のエラーの詳細を確認します
- アクティビティが失敗した理由を説明するエラーメッセージまたはコードを探します
データエクスプローラー固有の問題 (インジェストパイプラインエラーの場合) を確認します。
- リソース容量: Data Explorer クラスターの容量が不足している可能性があります。 Azure Monitor でクラスターメトリックを確認します。
- コマンド構文エラー: クエリエディターで .show commands を使用して、データエクスプローラーのコマンド履歴を確認します。
- アクセス許可の問題: マネージド ID に適切なデータベースアクセス許可があることを確認します。
- ネットワーク接続: Data Factory が Data Explorer クラスターに到達できることを確認します。

一般的なデータエクスプローラーのトラブルシューティングコマンド:

// Check recent failed operations
.show operations
| where StartedOn > ago(4h) and State == "Failed"

// Check ingestion failures
.show ingestion failures
| where FailedOn > ago(4h)

// Check command history
.show commands
| where StartedOn > ago(4h)

基になる問題を解決した後:失敗したパイプラインを Azure Data Factory から再実行します。

関連エラー: このエラーは、多くの場合、次のエラーと組み合わせて表示されます。

データエクスプローラー後処理ドロップ失敗
DataExplorerPreIngestionDropFailed
データエクスプローラー取り込み失敗

詳細については、以下を参照してください。

https://aka.ms/ftk/ideasで未解決の問題を報告します。

ハブデータが見つかりません

^{重大度: 重大}

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

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

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

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

ファイル不在エラー（IngestionFilesNotFound）

^{重大度: 重大}

指定したフォルダーパスから取り込む Parquet ファイルを見つけることができません。

軽減策: フォルダーパスが完全なパスであることを確認します。これには、インジェスト コンテナが含まれており、スラッシュ (/) で始まったり終わったりしていないことを確認します。最後に成功した ingestion_ExecuteETL パイプライン実行のパスをコピーします。

内部サービスエラー

Microsoft Fabric Real-Time Intelligence は、データの取り込み時に "InternalServiceError (520-UnknownError)" エラーコードを返す場合があります。詳細なエラーメッセージは次のように表示されます。

Kusto クライアントがサービスに要求を送信できませんでした:"トランスポート接続からデータを読み取ることができません: 既存の接続がリモートホストによって強制的に閉じられました。"`

このエラーの正確な理由は不明です。この問題が発生した場合は、Microsoft Fabric にサポートリクエストを提出して、さらに調査してください。

軽減策: 回避策として、Fabric イベントハウスの最小消費量を Medium (18 CU) に変更し、30 分待ってから、そのデータセットと月の ingestion_ExecuteETL パイプラインを再実行します。最小消費量の詳細については、イベントハウスの概要の最小消費量を参照してください。

無効な有効コスト

^{重大度: メジャー}

2024 年 11 月の時点で、コスト管理には、節約計画の購入が実績コストと償却コストの両方として内部的に追跡されるという既知のバグがあります。このため、FOCUS には、EffectiveCostの計算に節約プランの購入が含まれているため、FinOps ツールキットレポートの数値が不正確になります。

軽減策の: 基になるデータを修正するための問題の詳細を Microsoft Cost Management チームに要求します。 2024 年 11 月の時点で、チームはこの問題を認識していますが、修正プログラムはまだ優先されていません。この間、FinOps ツールキット 0.7 に更新します。これには、FinOps ハブとストレージベースの Power BI レポートの回避策が含まれています。

無効なエクスポートコンテナ

^{重大度: 重大}

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

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

無効なエクスポートバージョン

^{重大度: 重大}

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

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

無効なハブバージョン

^{重大度: 重大}

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

無効なスコープID (InvalidScopeId)

^{重大度: 情報}

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

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

レガシーフォーカスバージョン

^{重大度: 情報}

このエラーコードは、取り込まれたデータが古いバージョンの FOCUS を使用している場合に表示されます。 x_SourceChanges 列で見つかった場合、コードは情報提供のみを行います。 Costs クエリの読み込みに失敗したときに Power BI ストレージレポートに表示される場合は、Deprecated: Perform Extra Query Optimizations パラメーターが無効になっていることを意味します。

FinOps ハブはデータを最新の FOCUS バージョンに変換するため、問題が発生することはありません。ただし、モダン化変換はすべてのシナリオを考慮することができず、場合によっては予期しない結果になる可能性があります。既知の問題については、ドキュメントを参照してください。

軽減策の: 使用しているツールに応じて、このメッセージを軽減する方法はいくつかあります。

データエクスプローラーで FinOps ハブを使用していて、Costs テーブルまたは関連関数の x_SourceChanges 列に表示される場合は、最新の FOCUS バージョンを使用するように Cost Management コストのエクスポートを更新します。追加の変更を加える必要はありません。データエクスプローラーの取り込み中にすべてのデータがマージされます。

ストレージレポートを使用していて、Costs クエリの x_SourceChanges 列に表示される場合、このメッセージは、今後の更新でこの FOCUS バージョンが削除されることを示す警告です。このメッセージは無視しても問題ありませんが、今後のリリースでは更新が必要になります。このメッセージを回避するには、Cost Management のエクスポートを最新の FOCUS バージョンに更新し、古い FOCUS バージョンを使用して古いデータを削除または移動し、履歴データを再エクスポートします。 FinOps ハブを使用している場合は、インジェスト コンテナーの外部でデータを削除または移動します。ストレージで独自のエクスポートをホストする場合は、ストレージ URL パラメーターを、古い FOCUS バージョンを含まない別のフォルダーパスに変更します。

FinOps Toolkit 0.7 の時点で、パフォーマンスとスケーラビリティを向上させるために、以前の FOCUS バージョンのサポートは非推奨になりました。エクスペリエンスを向上させるために、最新の FOCUS バージョンに更新し、データを再エクスポートすることをお勧めします。を実行するパラメーターを設定して、古い FOCUS バージョンがサポートされていることを確認し、パフォーマンスを向上させ、より多くのコストや時間をカバーする大規模なデータセットをサポートするように TRUE に設定します。 0.7 の時点で、このパラメーターは旧バージョンとの互換性のために既定で有効になっています。 FinOps ツールキット 0.8 では、既定では無効になりますが、2025 年 6 月以降まで下位互換性のために使用できます。古い FOCUS バージョンから移行できない場合、またはより大きなアカウントや長期間の最適なパフォーマンスとサポートを得られない場合は、データエクスプローラーで FinOps ハブを使用することをお勧めします。

リスト価格が契約コストより安い

^{重要度: 警告}

ListCost (パブリック、小売価格に基づく) は、Cost Management のデータの ContractedCost (交渉された割引に基づく) 未満です。これは決して起こってはいけません。これにより、節約計算が正確に加算されなくなります。

軽減策: コストデータの ListUnitPrice が価格データの内容と一致したことを確認します。定価が正しい場合は、Cost Management チームにサポートリクエストを提出して、 ListUnitPrice と ContractedUnitPrice の両方が正しいことを確認し、割引交渉後の価格がパブリックの小売料金よりも高くなる理由を説明します。

データ品質の問題が節約計算に与える影響の詳細については、「節約計算について」を参照してください。

マニフェストの読み込みに失敗しました

^{重大度: 重大}

パイプライン 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 パイプラインがあります。パイプラインは、<your-supported-api-version>、exportConfig.resourceId、およびexportConfig.typeのプロパティが一貫して配信されることを期待する API バージョンexportConfig.dataVersionに基づいて構築されました。これらのファイルは、 <your-export-date>で実行されたエクスポート用のこの API バージョンのマニフェストファイルに含まれていないことに気付きました。私の期待は、マニフェストファイルが既存の API バージョンに対して変更されることは決してないことです。これらの変更を元に戻すことができますか?
  
  トラブルシューティングを支援するために、マニフェストファイル {your-manifest-json} を次に示します。

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

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

3営業日以内に問題や議論に対応するよう努めます。ライブヘルプが必要ですか? 隔週の勤務時間にご参加ください。

契約コスト未入力

^{重大度: 情報}

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

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

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

契約単価の欠落

^{重大度: 情報}

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

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

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

欠損価格が節約額の計算に与える影響の詳細については、「節約額の計算について」を参照してください。

MissingListCost

^{重大度: 情報}

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

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

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

一覧の単価が不足しています

^{重大度: 情報}

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

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

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

欠損価格が節約額の計算に与える影響の詳細については、「節約額の計算について」を参照してください。

プロバイダー名がありません

^{重大度: 情報}

このエラーコードは、x_SourceChanges が null の場合に ProviderName 列に表示されます。このエラーは、データセットのプロバイダー (Microsoft Cost Management など) に、指定された行の ProviderName 値が含まれていないことを示します。

軽減策の: 不足しているデータへの回避策として、FinOps ツールキットのレポートは、使用可能な列に基づいてプロバイダーの識別を試みます。

クエリ '...'他のクエリまたはステップを参照する

^{重大度: マイナー}

このエラーの原因は不明です。このエラーは、Power BI データを更新するときにランダムに表示される可能性があります。

対策: このエラーが発生した場合は、もう一度 [変更適用] を選択します。

このエラーは、ストレージレポートでのみ報告されています。データの更新時間が長い場合や、このエラーが頻繁に発生する場合は、データエクスプローラーを使用して FinOps ハブに切り替えることを検討してください。データエクスプローラーでは、スケジュール設定や増分更新を必要としない KQL レポートが使用されます。データはレポートを開くとプルされるため、レポートには常に最新のデータが表示されます。

ResourceAccessForbiddenException（リソースアクセス禁止例外）

^{重大度: メジャー}

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

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

応答ペイロードのサイズは...制限を超えています。

^{重大度: メジャー}

ガバナンスとワークロードの最適化 Power BI レポートの Azure Resource Graph クエリでは、次のようなエラーが返される場合があります。

OLE DB または ODBC エラー: [Expression.Error] サポートを求める場合は、次の情報を入力してください: timestamp = {timestamp}、correlationId = {guid}。詳細: 応答ペイロードのサイズは {number} で、16777216の制限を超えています。一度にクエリを実行するデータを減らすことを検討し、必要に応じてページ分割された呼び出しを行ってください。

このエラーは、フィルター処理されていない Resource Graph クエリでサポートされているリソースよりも多くのリソースがあることを意味します。これは、FinOps ツールキットレポートがリソースレベルの詳細を表示するように設計されており、集計されないために発生します。これらは中小規模の環境向けに設計されており、何百万ものリソースを持つ組織をサポートするようには設計されていません。

軽減策: このエラーが発生した場合は、いくつかのオプションがあります。

ニーズに合わない列を削除します。
クエリをフィルター処理して、最も重要なもの (サブスクリプション、タグなど) に基づいて返されるリソースを減らします。
クエリを無効にして、他のクエリの実行をブロックしないようにします。

ロール割り当ての更新は許可されていません

^{重大度: マイナー}

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

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

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

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

役割割り当てが存在します

^{重大度: マイナー}

FinOps ハブをあるバージョンから別のバージョンにアップグレードするときに、以前のデプロイで作成されたロールの割り当てがまだ存在する場合、次のエラーが発生する可能性があります。

"code": "RoleAssignmentExists",
"message": "The role assignment already exists."

これは、マネージド ID が最初にすべてのロールの割り当てを削除せずに明示的に削除されたことが原因である可能性があります。

軽減策: この問題を解決するには、Azure portal で孤立したロールの割り当てを削除します。

リソースグループまたは影響を受けるリソース (Data Explorer クラスターなど) に移動します。
メニューで [アクセス制御 (IAM)] を選択します。
[ロールの割り当て] タブを選択します。
不明な ID を持つロールの割り当てを見つけて削除します。

スキーマの読み込みに失敗しました

^{重大度: 重大}

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

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

スキーマが見つかりません

^{重大度: 重大}

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

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

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

ストレージのインポート URL がエクスポートと一致しない

^{重大度: メジャー}

FinOps Toolkit 0.8 レポートでこれが発生している場合、エラーは存在しないパラメーターへの参照が原因です。

軽減策: これは FinOps ツールキット 0.9 で修正されました。修正プログラムを適用するには、最新のリリースに更新します。修正プログラムを 0.8 レポートに直接適用する必要がある場合は、詳細エディターで ftk_DemoFilter 関数を編集し、内容を () => "" に変更します。保存し、閉じてすべての変更を適用します。

不明なエクスポートファイル

^{重大度: 情報}

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

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

不明フォーカスバージョン

^{重大度: 情報}

このエラーコードは、FOCUS バージョンを識別できなかった場合に x_SourceChanges 列に表示されます。

軽減策の: FOCUS データセットがサポートされている FOCUS バージョンを使用していることを検証します。さらに調査するために、https://aka.ms/ftk/ideas のデータの匿名化されたサンプルでこの問題を報告します。

不明なハブバージョン

^{重大度: 重大}

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

サポートされていないエクスポートファイルタイプ

^{重大度: 重大}

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

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

サポートされていないエクスポートタイプ

^{重要度: 警告}

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

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

^{重大度: マイナー}

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

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

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 で修正)

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

^{重大度: 重大}

このエラーは、必要な Data Lake Storage (DFS) エンドポイントではなく、BLOB エンドポイントを使用して Power BI ストレージレポートをストレージアカウントに接続するときに発生する可能性があります。

軽減策: Data Lake Storage エンドポイントを使用するように Storage URL パラメーターを更新します。

.blob.core.windows.netをストレージ URL の.dfs.core.windows.netに変更します。
Azure portal を使用している場合:
- ストレージアカウントを開く
- [設定]>Endpoints の選択
- Data Lake Storage の URL (BLOB サービスの URL ではなく) をコピーする

例えば次が挙げられます。

❌ 正しくない: https://mystorageaccount.blob.core.windows.net/container
✅ そうです： https://mystorageaccount.dfs.core.windows.net/container

正しいエンドポイントを使用した後も問題が発生する場合は、「 FinOps Hubs: 追加のトラブルシューティング手順については、値 null を Table 型に変換できません」を参照してください。

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

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

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

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

フィードバックを送る

クイックレビューを使用して、どのように取り組んでいるかをお知らせください。これらのレビューを使用して、FinOps のツールとリソースを改善および拡張します。

フィードバック

特定の情報をお探しの場合は、既存のアイデアに投票するか、新しいアイデアを作成してください。他のユーザーとアイデアを共有して、投票を増やしましょう。投票数が最も多いアイデアに焦点を当てています。

アイデアに投票または提案

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-02-12

次の方法で共有

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

リソースへのアクセスが禁止されています

アカウントのプロパティを更新できません

バッドハブバージョン

テーブル 'Resources' の列 'id' に重複する値が含まれています

競合エラー

契約したコストが実際のコストよりも低い

テナント間アクセス ポリシーでは、このユーザーは許可されません

データエクスプローラーの取り込みに失敗しました

一般的なエラー: SEM0080 assert() が "インジェストに失敗しました" というメッセージで失敗しました

データエクスプローラーのインジェスチョンマッピングに失敗しました

データエクスプローラーのインジェストタイムアウト

データエクスプローラー処理後の削除に失敗しました

データエクスプローラー事前インジェスション削除失敗

デプロイメント出力評価失敗

エクスポートデータが見つかりません

エクスポートタイプ未定義

エクスポートタイプサポートされていません

ErrorCodeNotString

ハブデータが見つかりません

ファイル不在エラー（IngestionFilesNotFound）

内部サービスエラー

無効な有効コスト

無効なエクスポートコンテナ

無効なエクスポートバージョン

無効なハブバージョン

無効なスコープID (InvalidScopeId)

レガシーフォーカスバージョン

リスト価格が契約コストより安い

マニフェストの読み込みに失敗しました

契約コスト未入力

契約単価の欠落

MissingListCost

一覧の単価が不足しています

プロバイダー名がありません

クエリ '...'他のクエリまたはステップを参照する

ResourceAccessForbiddenException（リソースアクセス禁止例外）

応答ペイロードのサイズは...制限を超えています。

ロール割り当ての更新は許可されていません

役割割り当てが存在します

スキーマの読み込みに失敗しました

スキーマが見つかりません

ストレージのインポート URL がエクスポートと一致しない

不明なエクスポートファイル

不明フォーカスバージョン

不明なハブバージョン

サポートされていないエクスポートファイルタイプ

サポートされていないエクスポートタイプ

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

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

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

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

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

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

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

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

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

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

フィードバックを送る

関連するコンテンツ

フィードバック

その他のリソース

テナント間アクセスポリシーでは、このユーザーは許可されません

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

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

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