針對常見的 FinOps 工具組錯誤進行疑難解答

2025-05-08

本文說明常見的 FinOps 工具組錯誤，並提供解決方案的相關信息。如果您在使用您不瞭解或無法解決的 FinOps 工具組解決方案時收到錯誤，請尋找下列對應的錯誤碼，並採取緩和步驟解決問題。

以下是常見的錯誤碼清單及風險降低資訊。

如果提供的資訊無法解決問題，請嘗試疑難解答指南。

禁止存取資源

^嚴重性：嚴重

此錯誤通常表示您連接的帳戶無法存取您嘗試使用的資源。

緩解措施：確認您在正確的 Microsoft Entra ID 租使用者中使用正確的帳戶。

帳戶屬性無法更新

^嚴重性：嚴重

使用與建立期間原本使用的不同記憶體帳戶組態來更新 FinOps 中樞部署時，通常會發生此錯誤。雖然大部分的屬性都可以變更，但有幾個屬性只能在建立記憶體帳戶且無法變更時設定一次。 FinOps 中樞的其中一個已知案例是「requireInfrastructureEncryption」屬性。如果在第一個 FinOps 中樞部署期間啟用或停用此屬性，則無法變更此屬性。發生這種情況時，您會看到下列錯誤：

屬性 'requireInfrastructureEncryption' 已在輸入中指定，但無法更新為只讀。

風險降低：如果您不打算變更此設定，請確認您的記憶體帳戶是否已設定為使用基礎結構加密，並使用相同的值重新部署 FinOps 中樞範本（開啟或關閉）。如果您想要變更設定，建議您部署新的 FinOps 中樞實例，因為這會需要重新擷取所有數據。

您可以嘗試刪除現有的記憶體帳戶，並在基礎結構加密變更后重新部署範本;不過，我們還沒有徹底測試過這個問題。雖然我們不預期問題，但無法確認問題是否會造成問題。

錯誤的Hub版本

^嚴重性：嚴重

FinOps 中樞 0.2 無法運作。升級至 0.3 版或更新版本。

緩解措施：升級至最新版的 FinOps 樞紐。

數據表 'Resources' 中的數據行 'id' 包含重複的值

^嚴重性：嚴重

如果您遇到下列錯誤，這表示 Azure Resource Graph 傳回具有相同邏輯值的 id 欄的資料列。這種情況可能發生在資源標識碼值的大小寫不一致時，或者當另一個數據列橫跨多行展開時。

數據表 'Resources' 中的數據行 'id' 包含重複值 '{resource-id}'，而且在多對一關聯性的一端或做為數據表主鍵的數據行不允許這樣做。

緩解措施：請確保您使用的是最新版本的報表。識別重複值的原因，並更新查詢以解決重複值。您也可以在 GitHub 中回報此問題，以便在未來的版本中加以修正。這可能需要額外的詳細數據或會議，才能針對錯誤的原因進行疑難解答。

衝突錯誤

^嚴重性：嚴重

此錯誤可能會有多個實例。其中一個已知實例是在 Key Vault 傳回下列錯誤時：

具有相同名稱的保存庫已處於已刪除狀態。您必須復原或清除現有的金鑰保存庫。請點擊此連結 https://go.microsoft.com/fwlink/?linkid=2149745 以獲取虛刪除的詳細資訊。

這通常表示您要在已刪除的舊部署之上部署，但 Key Vault 會將舊保存庫實例保持在可復原的刪除狀態。

緩解措施：若要修正此問題，請在 Azure 入口網站中清除已刪除的 Key Vault。

在 Azure 入口網站中開啟 Key Vault 實例清單。
選取頁面頂端的 [管理已刪除的保存庫] 命令。
在下拉式清單中選取訂閱。
檢查要移除的保管庫。
在飛出視窗的底部選擇清除。
在確認對話框中選取 [ 刪除 ]。

您現在可以重試部署。

合約成本低於實際成本

^嚴重性：警告

ContractedCost（根據談判折扣）在成本管理的數據中，低於 EffectiveCost（承諾折扣之後）。除非承諾折扣提供的優惠比您現有的協商折扣少，否則不應該發生這種情況。這會導致您的節省計算總和不準確。

緩解：確認 ContractedUnitPrice 成本數據是否匹配價格數據中的內容。如果合約價格正確，請向成本管理小組提出支援要求，以確認 x_EffectiveUnitPrice 且 EffectiveCost 正確無誤。如果正確的話，請考慮傳回承諾折扣。

跨租戶存取政策不允許此使用者

^{嚴重性：主要}

如果您遇到下列錯誤，表示Microsoft Entra ID 設定為不允許來自其他租用戶的使用者登入目前的租使用者。

訊息：AADSTS500213：資源租戶的跨租戶存取政策不允許此使用者存取此租戶。

此錯誤訊息與 FinOps 工具組無關。

緩解：確認您已登入正確的帳戶，並確保登入方式是通過目標目錄。如果您需要進一步的協助，請連絡目錄管理員。

資料探勘器資料導入失敗

^嚴重性：嚴重

數據總管擷取失敗。新的數據將無法用於報告。

減輕措施：檢閱 Data Explorer 錯誤訊息並解決問題。使用 Azure Data Factory 中的ingestion_ExecuteETL管線，重新執行指定資料夾的數據擷取。請回報未解決的問題到 https://aka.ms/ftk/ideas。

資料探索器導入映射失敗

^嚴重性：嚴重

無法為指定的數據表建立數據總管擷取對應。

處理：請修正錯誤，並重新執行指定資料夾路徑的匯入。如果您繼續看到此錯誤，請在回報問題。https://aka.ms/ftk/ideas

DataExplorerIngestionTimeout

^嚴重性：嚴重

在等待可用容量過程中，Data Explorer 的數據導入超過 2 小時後逾時。

風險降低：請重新執行此管線以重新嘗試擷取。如果您繼續看到此錯誤，請在回報問題。https://aka.ms/ftk/ideas

DataExplorer後置佇列移除失敗

^嚴重性：嚴重

數據總管擷取後清除（從最終數據表卸除範圍）失敗。來自先前導入的數據可能會出現在報告中，這可能會導致成本的重複計算和不正確。

減輕措施：檢閱 Data Explorer 錯誤訊息並解決問題。使用 ingestion_ExecuteETL Azure Data Factory 中的管線，重新執行指定資料夾的數據擷取。請回報未解決的問題到 https://aka.ms/ftk/ideas。

資料探索器預處理移除失敗

^嚴重性：嚴重

資料管理器的預處理清理失敗（從原始資料表中刪除範圍失敗）。資料導入尚未完成。

部署輸出評估失敗

^{嚴重性：主要}

FinOps 中心 0.8 會將 Azure 數據總管的「trustedExternaltenants」安全性設定設置為鎖定叢集，使其只能從特定的信任租戶進行存取。此設定可以針對第一個部署進行設定，但無法在第二個部署中再次設定。如果您嘗試在現有的 0.8 部署之上重新部署 FinOps 中樞 0.8，您可能會看到下列錯誤：

範本輸出 'clusterUri' 無效：語言表達式屬性 'uri' 不存在，可用屬性為 'trustedExternalTenants、enableStreamingIngest、publicNetworkAccess、enableAutoStop、provisioningState'。

我們會與 Azure 數據總管小組進行後續追蹤，以找出正確的解決方案。

緩解：部署 FinOps 中心 0.9。此設定已從範本中移除。

未找到匯出資料

^嚴重性：嚴重

在指定的儲存路徑中找不到匯出的文件。

風險降低：確認已建立成本管理匯出，並使用正確的記憶體帳戶、容器和記憶體路徑進行設定。建立之後，選取 [立即執行] 以啟動導出程式。視帳戶大小而定，導出可能需要 15-30 分鐘才能完成。如果您打算使用 FinOps 中樞，請更正儲存 URL 以指向「擷取」容器。請參閱 FinOps 中樞部署的輸出以獲得完整的 URL。

匯出類型未定義 (ExportTypeNotDefined)

^嚴重性：嚴重

受控導出不支援此計費範圍類型。

風險降低：從 settings.json移除不支援的計費範圍、確認 FinOps 中樞支援計費範圍，並手動為計費範圍建立新的成本管理導出。

匯出類型不支援

^嚴重性：嚴重

受管理的導出不支援 Microsoft 客戶協議。

緩解措施：從 settings.json 移除 MCA 計費範圍，並針對 FOCUS 成本、價格表、預訂詳細數據、預訂交易和預訂建議，為每個 MCA 帳單設定檔手動建立新的成本管理匯出。

中樞資料未找到

^嚴重性：嚴重

在指定的記憶體帳戶中找不到 FinOps 中樞數據。

緩解：此錯誤假設您正在連線到 FinOps 中心部署。如果使用原始匯出，請更正記憶體路徑，不要參考 ingestion 容器。確認下列項目：

儲存 URL 應該符合 FinOps 中樞部署的輸出。
成本管理匯出應該設定為使用 msexports 容器指向相同的記憶體帳戶。
成本管理匯出應該會在執行歷程記錄中顯示成功的匯出。
應全部啟動 FinOps 中樞數據處理站觸發程式。
FinOps 中樞的數據工廠管線應當運作成功。

如需詳細資訊和偵錯步驟，請參閱驗證您的 FinOps 中樞部署。

找不到匯入檔案

^嚴重性：嚴重

無法從指定的資料夾路徑匯入 parquet 檔案。

減輕影響：確認資料夾路徑是完整路徑，包括匯入容器，且路徑不以斜線開頭或結尾。/ 從上次成功的 ingestion_ExecuteETL 管線執行中複製路徑。

內部服務錯誤

Microsoft Fabric Real-Time Intelligence 可能會在匯入數據時傳回「InternalServiceError （520-UnknownError）」錯誤碼。詳細的錯誤訊息可能會說：

Kusto 用戶端無法傳送要求給服務：「無法從傳輸連線讀取數據：遠端主機強制關閉現有的連線。」`

此錯誤的確切原因不明。如果您遇到，請向 Microsoft Fabric 提出支援要求，以進一步調查。

緩解措施：因應措施是，將 Fabric 事件存放區的最低耗用量變更為 中（18 個 CUs），等候 30 分鐘，然後重新執行該數據集和月份的 ingestion_ExecuteETL 管線。若要深入瞭解最低耗用量，請參閱 Eventhouse 概觀中的最小耗用量。

無效的有效成本

^{嚴重性：主要}

自 2024 年 11 月起，成本管理有一個已知的 Bug，其中節省方案購買會在內部追蹤為實際成本和攤銷成本。因此，FOCUS 在計算 EffectiveCost 時包含節約計劃的購買，這會導致 FinOps 工具組報告中的數字不準確。

減輕：提交包含問題詳細資訊的支援要求給 Microsoft 成本管理小組，以修正基礎數據。自 2024 年 11 月起，小組知道問題，但修正尚未排定優先順序。在過渡期間，更新為 FinOps 工具組 0.7，其中包含對於 FinOps 中樞和儲存基礎 Power BI 報表的因應措施。

無效的匯出容器

^嚴重性：嚴重

此檔案看起來像是從成本管理匯出，但不是在正確的容器中。

風險緩解：更新您的成本管理匯出設定以指向 'msexports' 儲存體容器。「擷取」容器僅用於查詢擷取的成本數據。

無效的導出版本

^嚴重性：嚴重

FinOps 中樞需要FOCUS成本匯出，但此檔案看起來像是舊版成本管理匯出。

風險降低：為FOCUS成本創建新的成本管理匯出，同時選擇停止現有的匯出或更改其匯出至不同的存儲容器。

無效的 Hub 版本

^嚴重性：嚴重

FinOps 中樞 0.1.1 和更早版本不適用於數據擷取 Power BI 報表。

風險降低：升級至最新版的 FinOps 中樞，或從 0.1.1 版下載 Power BI 報表。

無效的範圍ID

^{嚴重性：僅供參考}

匯出路徑不是有效的範圍標識碼。 FinOps 中樞預期匯出路徑會是建立匯出範圍的 Azure 資源識別碼，以簡化管理。它不應該造成失敗，但可能會導致與範圍相關的報告產生令人混淆的結果。

風險降低：更新成本管理導出的記憶體路徑，以針對範圍使用完整的 Azure 資源識別符。

LegacyFocusVersion

^{嚴重性：僅供參考}

當內嵌的數據使用舊版FOCUS時，會顯示此錯誤碼。在數據行中找到 x_SourceChanges 時，程式代碼僅供參考。當 Power BI 記憶體報表中當成本查詢無法載入時，這表示已 淘汰：執行額外的查詢優化 參數已停用。

FinOps 中樞會將數據轉換成最新的 FOCUS 版本，因此這不應該造成問題;不過，現代化轉換無法考慮所有案例，而且在某些情況下可能會導致非預期的結果。如需已知問題，請參閱檔。

緩解：根據您使用的工具，可以採取幾種不同方式來緩解此訊息的影響。

如果您在使用 FinOps 中心與數據探查器時，在成本表或相關功能的 x_SourceChanges 欄中看到此情況，請更新成本管理的成本匯出以使用最新版本的 FOCUS。不需要進行其他變更，所有數據都會在數據總管擷取期間合併。

如果使用記憶體報告並在成本查詢的數據行中看到此 x_SourceChanges 情況，則此訊息是警告，指出未來更新中將會移除此 FOCUS 版本。雖然您可以放心地忽略此訊息，但未來版本將會需要更新。若要避免訊息，請更新成本管理匯出至最新的FOCUS版本、使用舊版FOCUS刪除或行動任何較舊的數據，以及重新匯出歷程記錄數據。如果使用 FinOps 中樞，請在匯入容器外部刪除或移動資料。如果在儲存空間中裝載您自己的匯出，請將 儲存空間 URL 參數變更為另一個不包含舊 FOCUS 版本的資料夾路徑。

從 FinOps 工具組 0.7 開始，舊版 FOCUS 版本的支援已被取代，以改善效能和延展性。建議您更新至最新的FOCUS版本並重新匯出數據，以改善您的體驗。設定 已淘汰：執行額外的查詢優化 參數為 TRUE 以確保支援較舊的FOCUS版本；將參數設定為 FALSE 則可以提高效能，並支持處理包含更多成本或更長時間的大型數據集。自 0.7 起，預設會啟用此參數以提供回溯相容性。在 FinOps 工具組 0.8 中，預設會停用它，但仍可在 2025 年 6 月前後提供回溯相容性。如果您無法升級或遷移舊版 FOCUS，或是為了提升效能及更好地支援大型帳戶或長期使用，我們建議您使用 FinOps 中樞與數據總管。

列表成本低於合約成本

^嚴重性：警告

ListCost （根據公眾零售價格）在成本管理數據中，低於 ContractedCost （根據談判折扣）。這不應該發生。這會導致您的節省計算總和不準確。

緩解：確認 ListUnitPrice 成本數據是否匹配價格數據中的內容。如果價目表正確，請向成本管理小組提出支援要求，以確認 ListUnitPrice 和 ContractedUnitPrice 都正確無誤，並說明談判折扣之後的價格為何會高於公用零售費率。

清單讀取失敗

^嚴重性：嚴重

FinOps 中樞 msexports_ExecuteETL 管線無法讀取成本管理指令清單檔案。

避免方法：

如果在沒有對中樞或匯出進行變更時，工作中樞實例發生錯誤，則成本管理可能會變更現有 API 版本的指令清單架構。
如果您在建立新的或變更現有的匯出之後發生錯誤，則匯出 API 版本可能會使用新的不支援的指令清單架構。
如果在中樞部署之後發生錯誤（初始安裝或升級），則部署可能會失敗，或管線中可能有錯誤。

若要確認指令清單架構（#1）或 API 版本（#2）：

在 Azure 入口網站或儲存體總管中開啟中樞儲存帳戶。
如果您在 Azure 入口網站，請移至 功能表中的 [儲存體] 瀏覽器。
選取 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 可以是任何範圍標識符和任何匯出名稱，但必須存在「Microsoft.CostManagement/export」資源類型。不區分大小寫。
- 類型必須存在，但不應該因為任何非空值而發生此錯誤。
- dataVersion 必須存在，但不應該因為任何非空值而發生此錯誤。
- apiVersion 不會明確使用，但可以表示指令清單架構的變更。如需詳細資訊，請參閱支援的 API 版本。
如果您使用較新的 API 版本：
1. 若要追蹤新 API 版本的新增支援，請在 GitHub 中建立變更要求問題。
2. 刪除成本管理中的匯出。
3. 使用支援的 API 版本，使用 New-FinOpsCostExport PowerShell 命令來建立導出。
  
  提示
  
  如果您認為自己是強大的使用者，建議您嘗試自行更新管線，以取得最快的解決方案。若要這樣做，請開啟 Data Factory，導航到 [撰寫>管線>] msexports_ExecuteETL，然後選取適用的「Set」活動，並視需要更新設定>值屬性。如果您這樣做，就不需要使用舊版重新建立導出。請仍然回報問題，並考慮從管線設計介面的右上角圖示中共用新的 JSON。
如果您注意到支援 API 版本的屬性已變更：
1. 若要追蹤重大變更，請在 GitHub 中建立變更要求問題。請包含 type、dataVersion 和 apiVersion，它們來自你的 manifest.json 檔案。
2. 向 Cost Management 提出支援請求，要求恢復更改，因為此更改會影響所有使用 FinOps 平台或其他自訂解決方案的人。包含下列詳細數據，以協助成本管理支援小組找出其系統內的問題。成本管理對於 FinOps 樞紐缺乏上下文理解，因此您應該將詳細資訊集中在成本管理功能上。以下是範例：
  
  我使用成本管理匯出將成本數據提取到ADLS。我有一個ADF管線，它在清單檔案寫入時處理數據。我的管線是以 API 版本 <your-supported-api-version> 為基礎所建置，預期 exportConfig.resourceId、 exportConfig.type和 exportConfig.dataVersion 屬性會一致地傳遞。我注意到這些檔案未包含在此 API 版本的清單檔中，而我的匯出是在<your-export-date>上進行的。我的期許是，manifest 檔案不應更改既有的 API 版本。您可以還原這些變更嗎？
  
  為了協助您進行疑難解答，以下是我的指令清單檔案： {your-manifest-json}

如果清單屬性看起來良好，並且它是新的或升級的 FinOps 中樞實例，請確認部署：

在 Azure 入口網站中開啟中樞資源群組。
在左側功能表中選取設定>和部署。
確認所有部署都成功。具體來說，尋找下列部署名稱：
- 主要
- 中樞
- dataFactoryResources
- 儲存
- 金鑰保險庫
如果有任何部署失敗，請檢閱錯誤訊息，以判斷其是否為您可以自行解決的專案（例如名稱衝突、可修正的原則違規）。
如果錯誤看似暫時性，請嘗試再次部署。
如果錯誤持續發生，請建立討論，以查看是否有其他人遇到問題或知道可能的因應措施（特別是針對原則問題）。
如果錯誤顯然是 Bug 或功能差距，請在 GitHub 中建立 Bug 或功能要求問題。

我們嘗試在兩個工作天內回應問題和討論。

缺少合同成本

^{嚴重性：僅供參考}

當x_SourceChanges為 Null 或 0 且ContractedCost大於 0 時，EffectiveCost列中會顯示此錯誤碼。錯誤顯示 Microsoft 成本管理未包含指定數據列的 ContractedCost，這表示無法計算節省。

緩解措施：為了因應遺漏數據，FinOps 工具組報告會將 EffectiveCost 複製到 ContractedCost 欄，針對標示為此錯誤碼的數據列。這些記錄無法節省成本。

要計算完整的節省金額，您可以將成本和使用量數據與價格結合起來。如需詳細資訊，請參閱問題 #873。

缺少合約單位價格

^{嚴重性：僅供參考}

當x_SourceChanges為 Null 或 0 且ContractedUnitPrice大於 0 時，EffectiveUnitPrice列中會顯示此錯誤碼。錯誤顯示 Microsoft 成本管理未包含指定數據列的 ContractedUnitPrice，這表示無法計算節省。

緩解措施：為了因應遺漏數據，FinOps 工具組報告會將 EffectiveUnitPrice 複製到 ContractedUnitPrice 欄，針對標示為此錯誤碼的數據列。這些記錄無法節省成本。

要計算完整的節省金額，您可以將成本和使用量數據與價格結合起來。如需詳細資訊，請參閱問題 #873。

遺漏清單成本

^{嚴重性：僅供參考}

當x_SourceChanges為 Null 或 0 且ListCost大於 0 時，ContractedCost列中會顯示此錯誤碼。錯誤顯示 Microsoft 成本管理未包含指定數據列的 ListCost，這表示無法計算節省。

緩解措施：為了因應遺漏數據，FinOps 工具組報告會將 ContractedCost 複製到 ListCost 欄，針對標示為此錯誤碼的數據列。這些記錄無法節省成本。

要計算完整的節省金額，您可以將成本和使用量數據與價格結合起來。如需詳細資訊，請參閱問題 #873。

缺少清單單價

^{嚴重性：僅供參考}

當x_SourceChanges為 Null 或 0 且ListUnitPrice大於 0 時，ContractedUnitPrice列中會顯示此錯誤碼。錯誤顯示 Microsoft 成本管理未包含指定數據列的 ListUnitPrice，這表示無法計算節省。

緩解措施：為了因應遺漏數據，FinOps 工具組報告會將 ContractedUnitPrice 複製到 ListUnitPrice 欄，針對標示為此錯誤碼的數據列。這些記錄無法節省成本。

要計算完整的節省金額，您可以將成本和使用量數據與價格結合起來。如需詳細資訊，請參閱問題 #873。

缺少提供者名稱

^{嚴重性：僅供參考}

當x_SourceChanges為 null 時，這個錯誤碼會顯示在ProviderName欄中。錯誤指出數據集的提供者（例如，Microsoft成本管理）不包含 ProviderName 指定數據列的值。

緩解措施：作為缺失數據的解決方案，FinOps 工具包報告會根據可用的欄位嘗試識別供應商。

查詢 '...' 引用其他查詢或步驟

^{嚴重性：次要}

此錯誤的來源未知。重新整理 Power BI 資料時，可能會隨機顯示此錯誤。

緩解措施：如果您收到此錯誤，請再次選取 [ 套用變更 ]。

此錯誤只會在記憶體報告中回報。如果您的資料更新時間過長或經常遇到此錯誤，請考慮使用 Data Explorer 切換至 FinOps 中樞。數據總管會使用不需要排程或累加式重新整理的 KQL 報表。開啟報表時會提取數據，因此報表一律會顯示最新的數據。

ResourceAccessForbiddenException（資源存取被禁止例外）

^{嚴重性：主要}

Power BI：擲回 'Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException' 類型的例外狀況

指出在Power BI 中載入資料的帳戶沒有記憶體 Blob 資料讀取者角色。將此角色授權給 Power BI 中載入資料的帳戶。

回應承載大小為...和已超過限制

^{嚴重性：主要}

治理和工作負載優化 Power BI 報表中的 Azure Resource Graph 查詢可能會傳回類似下列的錯誤：

OLE DB 或 ODBC 錯誤： [Expression.Error] 當要求支持時，請提供下列資訊： timestamp = {timestamp}， correlationId = {guid}。詳細數據：響應承載大小為 {number}，且已超過16777216的限制。請考慮一次查詢較少的數據，並視需要進行編頁呼叫。

此錯誤表示您的資源比未篩選的 Resource Graph 查詢中支援的資源還多。這是因為 FinOps 工具組報告是設計來顯示資源層級的詳細數據，而且不會匯總。它們專為中小型環境所設計，並非設計為支援具有數百萬個資源的組織。

緩解措施：如果您遇到此錯誤，有數個選項：

移除您不需要的欄。
根據您認為最重要的內容過濾查詢以返回較少的資源（例如訂閱、標籤）。
停用查詢，使其不會封鎖其他查詢執行。

不允許更新角色分配

^{嚴重性：次要}

如果您已刪除 FinOps 中樞，並嘗試使用相同的值重新部署，包括受控識別名稱，您可能會遇到下列已知問題：

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

緩解：若要修正此問題，您必須移除過時的身份：

流覽至記憶體帳戶，然後選取 功能表中的 [存取控制][IAM ]。
選取 [角色指派] 索引標籤。
尋找具有「未知」身分識別的任何角色指派，並加以刪除。

角色指派已存在

^{嚴重性：次要}

將 FinOps 中樞從某個版本升級為另一個版本時，如果先前部署中建立的角色指派仍然存在，您可能會遇到下列錯誤：

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

這可能是因為已明確刪除受控識別，而不需要先移除其所有角色指派。

緩解措施：若要修正此問題，請在 Azure 入口中刪除孤立的角色指派：

流覽至資源群組或受影響的資源（例如數據總管叢集）。
在功能表中選取 存取控制 (IAM)。
選取 [角色指派] 索引標籤。
尋找具有未知身分識別的任何角色指派，並加以刪除。

Schema載入失敗

^嚴重性：嚴重

FinOps 中樞 msexports_ETL_ingestion 管線無法載入架構檔案。

緩解措施：檢閱錯誤訊息以記下數據集類型和版本，其格式為底線符號（例如 <type>_<version> 或 FocusCost_1.0）。確認已部署的 FinOps 中樞版本都支援數據集和類型。如需詳細資訊，請參閱支持的數據集。

Schema 未找到

^嚴重性：嚴重

FinOps 中樞 msexports_ExecuteETL 管線找不到匯出數據集的架構對應檔案。

風險降低：確認數據集類型和版本是否被支持。如需詳細資訊，請參閱支持的數據集。如果數據集受到支持，請使用數據擷取報表確認中樞版本。

若要新增對另一個資料集的支援，請建立自訂對應檔案，並將它儲存至 config/schemas/<dataset-type>_<dataset-version>.json。這些<dataset-type><dataset-version>值與成本管理所使用的值非常相符。若要識別每個數據行的數據類型，請使用現有的架構檔案作為範本。某些數據集針對 EA 和 Microsoft 客戶合約（MCA）有不同的架構。您無法透過這些屬性來識別它們，而且如果您有這兩種帳戶類型，可能會造成問題。我們正在調整並新增數據集，以校準 EA 和 MCA 之間的差異，對齊 FOCUS。

匯入的儲存位置 URL 未匹配任何匯出

^{嚴重性：主要}

如果您在 FinOps 工具組 0.8 中遇到此問題，則錯誤是因為參考不存在的參數。

風險降低：這是在 FinOps 工具組 0.9 中修正的。更新至最新版本以套用修正程式。如果您需要將修正直接套用至 0.8 報表，請在進階編輯器中編輯 ftk_DemoFilter 函式，並將內容變更為： () => ""。儲存，然後關閉並套用所有變更。

未知的匯出文件

^{嚴重性：僅供參考}

中樞記憶體中的檔案看起來不像是從成本管理導出。會忽略檔案。

風險降低： msexports 容器僅適用於成本管理導出。在另一個記憶體容器中移動其他檔案。

未知焦點版本

^{嚴重性：僅供參考}

當無法識別 FOCUS 版本時，此錯誤碼會顯示在 x_SourceChanges 資料行中。

緩解措施：驗證 FOCUS 數據集是否使用支援的 FOCUS 版本。使用匿名 https://aka.ms/ftk/ideas 數據範例回報此問題，以進一步調查。

UnknownHubVersion

^嚴重性：嚴重

無法從配置檔中識別 FinOps 中樞的版本。確認設定正確無誤。 FinOps 中樞 0.1.1 和更早版本無法使用此 Power BI 報表。

風險降低：升級至最新版 FinOps 中樞，或從 FinOps 工具組 v0.1.1 版下載 Power BI 報表。

不支援的匯出檔案類型

^嚴重性：嚴重

無法擷取指定的導出檔案，因為不支援檔類型。

緩解措施：將檔案轉換成支援的檔格式，然後新增至 msexports 容器，或新增支援以將新檔類型轉換為 msexports_ETL_ingestion 管線。

不支持的匯出類型（UnsupportedExportType）

^嚴重性：警告

中樞記憶體中的匯出指令清單表示匯出是針對不支持的數據集。匯出的數據會回報為擷取錯誤。

風險降低：為FOCUS成本創建新的成本管理匯出，同時選擇停止現有的匯出或更改其匯出至不同的存儲容器。

{name} 資源提供者未在訂用帳戶 {guid} 中註冊

^{嚴重性：次要}

在 Azure 入口網站中開啟訂用帳戶，然後選取 [設定>資源提供者]、選取資源提供者數據列（例如，Microsoft.EventGrid），然後選取頁面頂端的 [註冊] 命令。註冊可能需要幾分鐘的時間。

x_PricingSubcategory顯示承諾折扣標識碼

在 2024 年 2 月 28 日之前，成本管理匯出有一個錯誤，其中 x_PricingSubcategory 附加到認可使用量時設定不正確。您應該會看到像Committed Spend和Committed Usage這樣的值。相反地，您可能會看到如下的值：

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

如果您看到這些值，請重新匯出該月份的成本數據。如果您需要匯出無法使用的較舊月份數據，請連絡支持人員以要求匯出數據，以便解決先前匯出執行的數據質量問題。

Power BI：報表遺漏特定日期的數據

如果您的報表遺失一或多個月的所有數據，請檢查月份數、 RangeStart 和 RangeEnd 參數，以確保數據不會被篩選掉。

若要檢查參數，請選取功能區中的 [轉換數據>編輯參數]，或從查詢編輯器視窗中選取 [ 設定🛠

如果您想要一律顯示最近幾個月的特定數目，請將 [月數] 設定為 [已關閉（已完成）月數]。除了關閉的月數之外，當月是額外的月份。
如果您想要固定的日期範圍不會隨著時間變更（例如會計年度報告），請設定 RangeStart 和 RangeEnd。
如果您想要報告所有可用的數據，請確認這三個日期參數都是空的。

如需詳細資訊，請參閱設定您的第一個報表。

Power BI：報表是空的（沒有數據）

如果您在 Power BI 或其他報表或工具中看不到任何數據，請根據您的數據源嘗試下列專案：

如果在 Power BI 中使用成本管理連接器，請檢查 Billing Account ID 和 Number of Months 參數，以確保它們已正確設定。請記住，最近幾個月，舊的計費帳戶可能沒有數據。
如果使用 FinOps 中樞，請檢查記憶體帳戶，以確保數據已填入擷取容器中。您應該會看到提供者或訂用帳戶資料夾。使用下列各節進一步進行疑難解答。

FinOps 中樞：擷取容器是空的

如果引入容器是空的，請在 Data Factory Studio 中開啟 Data Factory 實例，然後選取 [管理]、[作者]、[觸發程式]，並確認 msexports_FileAdded 觸發程式是否已啟動。如果沒有，就啟動它。

如果觸發程式無法以「資源提供者未註冊」錯誤啟動，請在 Azure 入口網站中開啟訂用帳戶，然後選取 >]，選取 [Microsoft.EventGrid] 數據列，然後選取頁面頂端的 [註冊] 命令。註冊可能需要幾分鐘的時間。

註冊完成之後，請再次啟動 msexports_FileAdded 觸發程式。

啟動觸發程式之後，請重新執行所有連線的成本管理匯出。數據應該在 10-20 分鐘內完整擷取，視帳戶大小而定。

如果問題持續發生，請檢查成本管理匯出是否設定為已啟用檔案分割。如果您發現它已停用，請開啟並重新執行導出。

確認匯入容器已包含內容，並重新整理報表或其他連接的工具。

FinOps 中樞：在擷取容器中可用的檔案

如果擷取容器不是空的，請鑽研資料夾來確認您是否有 parquet 或 csv.gz 檔案。

一旦知道，請確認 FileType 參數已設定為 .parquet 或 .gz Power BI 報表中的。如需詳細資訊，請參閱連線至您的資料。

如果您使用另一個工具，請確定它支援您使用的檔案類型。

Power BI：無法解析遠端名稱：「<storage-account.dfs.core.windows.net>」

指出記憶體帳戶名稱不正確。如果使用 FinOps 中樞，請從部署確認 StorageUrl 參數。如需詳細資訊，請參閱連線至您的資料。

Power BI：我們無法將 null 值轉換成邏輯類型

表示計費帳戶標識碼參數是空的。如果使用 FinOps 中樞，請將值設定為所需的計費帳戶標識碼。如果您沒有計費帳戶的存取權，或不想包含承諾用量購買和退款，請將值設定為 0 ，並在進階編輯器中開啟 CostDetails 查詢，並將變更 2 為 1。它會通知報表不要從成本管理連接器載入實際/計費的成本數據。如需詳細資訊，請參閱連線至您的資料。

適用版本：0.1 - 0.1.1（已在0.2 修正）

FinOps 中樞：我們無法將 null 值轉換成 Table 類型

此錯誤通常表示數據未內嵌至擷取容器。

如果您剛升級至 FinOps 中樞 0.2，問題可能是因為 Power BI 報表舊了（從 0.1.x 起），或是因為您未使用 FOCUS 導出。如需詳細資訊，請參閱升級指南。

如需更多疑難解答步驟，請參閱報表是空的（沒有數據）。

提供意見反應

請寫下您的快速評價，讓我們知道我們的表現如何。我們會使用這些評論來改善及擴充 FinOps 工具和資源。

提供意見

如果您要尋找特定專案，請投票給現有專案或建立新想法。與其他人分享想法，以獲得更多的選票。我們專注於擁有最多選票的想法。

對想法進行投票或提出建議

如果您沒有看到您遇到的錯誤，請逐步檢查疑難解答指南。如果您有任何問題，請在 GitHub 中開始討論或建立問題。

共用方式為

針對常見的 FinOps 工具組錯誤進行疑難解答

禁止存取資源

帳戶屬性無法更新

錯誤的Hub版本

數據表 'Resources' 中的數據行 'id' 包含重複的值

衝突錯誤

合約成本低於實際成本

跨租戶存取政策不允許此使用者

資料探勘器資料導入失敗

資料探索器導入映射失敗

DataExplorerIngestionTimeout

DataExplorer後置佇列移除失敗

資料探索器預處理移除失敗

部署輸出評估失敗

未找到匯出資料

匯出類型未定義 (ExportTypeNotDefined)

匯出類型不支援

中樞資料未找到

找不到匯入檔案

內部服務錯誤

無效的有效成本

無效的匯出容器

無效的導出版本

無效的 Hub 版本

無效的範圍ID

LegacyFocusVersion

列表成本低於合約成本

清單讀取失敗

缺少合同成本

缺少合約單位價格

遺漏清單成本

缺少清單單價

缺少提供者名稱

查詢 '...' 引用其他查詢或步驟

ResourceAccessForbiddenException（資源存取被禁止例外）

回應承載大小為...和已超過限制

不允許更新角色分配

角色指派已存在

Schema載入失敗

Schema 未找到

匯入的儲存位置 URL 未匹配任何匯出

未知的匯出文件

未知焦點版本

UnknownHubVersion

不支援的匯出檔案類型

不支持的匯出類型（UnsupportedExportType）

{name} 資源提供者未在訂用帳戶 {guid} 中註冊

x_PricingSubcategory顯示承諾折扣標識碼

Power BI：報表遺漏特定日期的數據

Power BI：報表是空的（沒有數據）

FinOps 中樞：擷取容器是空的

FinOps 中樞：在擷取容器中可用的檔案

Power BI：無法解析遠端名稱：「<storage-account.dfs.core.windows.net>」

Power BI：我們無法將 null 值轉換成邏輯類型

FinOps 中樞：我們無法將 null 值轉換成 Table 類型

提供意見反應

相關內容

意見反應

其他資源