Delen via

Veelvoorkomende FinOps-toolkitfouten oplossen

  • Artikel

In dit artikel worden veelvoorkomende FinOps-toolkitfouten beschreven en vindt u informatie over oplossingen. Als er een fout optreedt bij het gebruik van FinOps Toolkit-oplossingen die u niet begrijpt of niet kunt oplossen, zoekt u de volgende bijbehorende foutcode met oplossingen voor het probleem.

Hier volgt een lijst met veelvoorkomende foutcodes met risicobeperkingsinformatie.

Als de verstrekte informatie het probleem niet oplost, probeert u de gids voor probleemoplossing.


BadHubVersion

Ernst: Kritiek

FinOps-hubs 0.2 is niet operationeel. Voer een upgrade uit naar versie 0.3 of hoger.

Risicobeperking: Upgrade uitvoeren naar de nieuwste versie van FinOps-hubs.


InvalidExportContainer

Ernst: Kritiek

Dit bestand lijkt erop dat het kan worden geëxporteerd vanuit Cost Management, maar het is niet in de juiste container.

Risicobeperking: Werk uw Cost Management-export bij zodat deze verwijst naar de opslagcontainer msexports. De container 'opname' wordt alleen gebruikt voor het opvragen van opgenomen kostengegevens.


InvalidExportVersion

Ernst: Kritiek

Voor FinOps-hubs zijn FOCUS-kostenexports vereist, maar dit bestand ziet eruit als een verouderde Cost Management-export.

Risicobeperking: Maak een nieuwe Cost Management-export voor FOCUS-kosten en stop de huidige export of wijzig deze om te exporteren naar een andere opslagcontainer.


InvalidHubVersion

Ernst: Kritiek

FinOps-hubs 0.1.1 en eerder werken niet met het Power BI-rapport gegevensopname.

Risicobeperking: Voer een upgrade uit naar de nieuwste versie van FinOps-hubs of download Power BI-rapporten van release 0.1.1.


InvalidScopeId

Ernst: informatie

Het exportpad is geen geldige bereik-id. FinOps-hubs verwachten dat het exportpad een Azure-resource-id is voor het bereik dat de export is gemaakt om het beheer te vereenvoudigen. Het mag geen fouten veroorzaken, maar kan leiden tot verwarrende resultaten voor bereikgerelateerde rapporten.

Risicobeperking: werk het opslagpad voor de Cost Management-export bij om de volledige Azure-resource-id voor het bereik te gebruiken.


ExportDataNotFound

Ernst: Kritiek

Exports zijn niet gevonden in het opgegeven opslagpad.

Risicobeperking: Controleer of er een Cost Management-export is gemaakt en geconfigureerd met het juiste opslagaccount, de juiste container en het opslagpad. Nadat u het bestand hebt gemaakt, selecteert u Nu uitvoeren om het exportproces te starten. Het uitvoeren van exports kan 15-30 minuten duren, afhankelijk van de grootte van het account. Als u FinOps-hubs wilt gebruiken, corrigeert u de opslag-URL zodat deze verwijst naar de container 'opname'. Raadpleeg de uitvoer van de storageUrlForPowerBI FinOps Hub-implementatie voor de volledige URL.


HubDataNotFound

Ernst: Kritiek

FinOps-hubgegevens zijn niet gevonden in het opgegeven opslagaccount.

Risicobeperking: Bij deze fout wordt ervan uitgegaan dat u verbinding maakt met een FinOps-hubimplementatie. Als u onbewerkte exports gebruikt, corrigeert u het opslagpad om niet naar de ingestion container te verwijzen. Bevestig de volgende gegevens:

  1. De opslag-URL moet overeenkomen met de StorageUrlForPowerBI uitvoer van de FinOps-hubimplementatie.
  2. Cost Management-exports moeten worden geconfigureerd om naar hetzelfde opslagaccount te verwijzen met behulp van de msexports container.
  3. Cost Management-exports moeten een geslaagde export in de uitvoeringsgeschiedenis weergeven.
  4. FinOps Hub Data Factory-triggers moeten allemaal worden gestart.
  5. FinOps Hub Data Factory-pijplijnen moeten succesvol zijn.

Zie Uw FinOps-hubimplementatie valideren voor meer informatie en foutopsporingsstappen.


MissingContractedCost

Ernst: informatie

Deze foutcode wordt weergegeven in de x_DatasetChanges kolom wanneer ContractedCost null of 0 is en EffectiveCost groter is dan 0. De fout geeft aan dat Microsoft Cost Management niet is opgenomen ContractedCost voor de opgegeven rijen, wat betekent dat er geen besparingen kunnen worden berekend.

Risicobeperking: Als tijdelijke oplossing voor de ontbrekende gegevens kopieert FinOps Toolkit de EffectiveCost kolom naar de ContractedCost kolom voor rijen die zijn gemarkeerd met deze foutcode. Er zijn geen besparingen beschikbaar voor deze records.

Als u volledige besparingen wilt berekenen, kunt u kosten- en gebruiksgegevens samenvoegen met prijzen. Zie probleem 873 voor meer informatie.


MissingContractedUnitPrice

Ernst: informatie

Deze foutcode wordt weergegeven in de x_DatasetChanges kolom wanneer ContractedUnitPrice null of 0 is en EffectiveUnitPrice groter is dan 0. De fout geeft aan dat Microsoft Cost Management niet is opgenomen ContractedUnitPrice voor de opgegeven rijen, wat betekent dat er geen besparingen kunnen worden berekend.

Risicobeperking: Als tijdelijke oplossing voor de ontbrekende gegevens kopieert FinOps Toolkit de EffectiveUnitPrice kolom naar de ContractedUnitPrice kolom voor rijen die zijn gemarkeerd met deze foutcode. Er zijn geen besparingen beschikbaar voor deze records.

Als u volledige besparingen wilt berekenen, kunt u kosten- en gebruiksgegevens samenvoegen met prijzen. Zie probleem 873 voor meer informatie.


MissingListCost

Ernst: informatie

Deze foutcode wordt weergegeven in de x_DatasetChanges kolom wanneer ListCost null of 0 is en ContractedCost groter is dan 0. De fout geeft aan dat Microsoft Cost Management niet is opgenomen ListCost voor de opgegeven rijen, wat betekent dat er geen besparingen kunnen worden berekend.

Risicobeperking: Als tijdelijke oplossing voor de ontbrekende gegevens kopieert FinOps Toolkit de ContractedCost kolom naar de ListCost kolom voor rijen die zijn gemarkeerd met deze foutcode. Er zijn geen besparingen beschikbaar voor deze records.

Als u volledige besparingen wilt berekenen, kunt u kosten- en gebruiksgegevens samenvoegen met prijzen. Zie probleem 873 voor meer informatie.


MissingListUnitPrice

Ernst: informatie

Deze foutcode wordt weergegeven in de x_DatasetChanges kolom wanneer ListUnitPrice null of 0 is en ContractedUnitPrice groter is dan 0. De fout geeft aan dat Microsoft Cost Management niet is opgenomen ListUnitPrice voor de opgegeven rijen, wat betekent dat er geen besparingen kunnen worden berekend.

Risicobeperking: Als tijdelijke oplossing voor de ontbrekende gegevens kopieert FinOps Toolkit de ContractedUnitPrice kolom naar de ListUnitPrice kolom voor rijen die zijn gemarkeerd met deze foutcode. Er zijn geen besparingen beschikbaar voor deze records.

Als u volledige besparingen wilt berekenen, kunt u kosten- en gebruiksgegevens samenvoegen met prijzen. Zie probleem 873 voor meer informatie.


ManifestReadFailed

Ernst: Kritiek

De FinOps-hub msexports_ExecuteETL-pijplijn kan het Manifestbestand van Cost Management niet lezen.

Oplossing:

  1. Als de fout is opgetreden in een werkhub-exemplaar wanneer er geen wijzigingen zijn aangebracht in de hub of export, heeft Cost Management mogelijk het manifestschema voor een bestaande API-versie gewijzigd.
  2. Als de fout is opgetreden nadat u een nieuwe export hebt gemaakt of een bestaande export hebt gewijzigd, gebruikt de export-API-versie mogelijk een nieuw, niet-ondersteund manifestschema.
  3. Als de fout is opgetreden na een hubimplementatie (eerste installatie of upgrade), is de implementatie mogelijk mislukt of is er een fout in de pijplijn.

Het manifestschema (#1) of api-versie (#2) bevestigen:

  1. Open het hub-opslagaccount in Azure Portal of Storage Explorer.
  2. Als u zich in Azure Portal bevindt, gaat u in het menu naar de opslagbrowser .
  3. Selecteer de msexports-container .
  4. Navigeer omlaag in de bestandshiërarchie voor de export met het probleem (zie de manifestlocatie in het foutbericht).
  5. Zoek het bestand manifest.json en selecteer het menu (⋯) en selecteer vervolgens Weergeven/bewerken.
  6. Identificeer de volgende eigenschappen: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Controleer of ze zijn ingesteld op de volgende ondersteunde waarden:
    • resourceId kan elke bereik-id en elke exportnaam zijn, maar moet bestaan met het resourcetype Microsoft.CostManagement/exports. Dit is hoofdlettergevoelig.
    • het type moet bestaan, maar mag niet mislukken met deze fout voor een niet-null-waarde.
    • dataVersion moet bestaan, maar mag niet mislukken met deze fout voor een niet-null-waarde.
    • apiVersion wordt niet expliciet gebruikt, maar kan wijzigingen in het manifestschema ondertekenen. Zie ondersteunde API-versies voor meer informatie.
  8. Als u een nieuwere API-versie gebruikt:
    1. Als u ondersteuning voor de nieuwe API-versie wilt bijhouden, maakt u een probleem met een wijzigingsaanvraag in GitHub.
    2. Verwijder de export in Cost Management.
    3. Maak een export met behulp van de PowerShell-opdracht New-FinOpsCostExport met behulp van een ondersteunde API-versie.

      Tip

      Als u uzelf een power user beschouwt, kunt u proberen de pijplijn zelf bij te werken voor de snelste oplossing. Hiervoor opent u Data Factory, gaat u naar de msexports_ExecuteETL Author Pipelines > en selecteert u de toepasselijke 'Set'-activiteiten en werkt u de eigenschap Instellingenwaarde> indien nodig bij.> Als u dit doet, hoeft u de export niet opnieuw te maken met een oudere versie. Meld het probleem nog steeds en overweeg om de nieuwe JSON te delen vanaf het {} pictogram rechtsboven in de pijplijn designer._

  9. Als u ziet dat de eigenschappen zijn gewijzigd voor een ondersteunde API-versie:
    1. Als u de wijziging die fouten veroorzaakt wilt bijhouden, maakt u een probleem met een wijzigingsaanvraag in GitHub. Neem het type, dataVersion en apiVersion op uit uw manifest.json-bestand.
    2. Dien een ondersteuningsaanvraag in met Cost Management om de wijziging aan te vragen, worden teruggedraaid omdat iedereen die FinOps-hubs of andere aangepaste oplossingen gebruikt, wordt onderbroken. Neem de volgende informatie op om het ondersteuningsteam van Cost Management te helpen het probleem in hun systeem te identificeren. Cost Management heeft geen context over FinOps-hubs, dus u moet de details gericht houden op de functionaliteit van Cost Management. Hier volgt een voorbeeld:

      Ik gebruik Cost Management-exports om mijn kostengegevens op te halen in ADLS. Ik heb een ADF-pijplijn die de gegevens verwerkt wanneer manifestbestanden worden geschreven. Mijn pijplijn is gebouwd op API-versie <your-supported-api-version> die verwacht exportConfig.resourceId, exportConfig.typeen exportConfig.dataVersion eigenschappen die consistent worden geleverd. Ik zag dat deze bestanden niet worden opgenomen in het manifestbestand voor deze API-versie voor mijn export die werd uitgevoerd.<your-export-date> Mijn verwachting is dat het manifestbestand nooit moet worden gewijzigd voor een bestaande API-versie. Kunt u deze wijzigingen herstellen?

      Om u te helpen bij het oplossen van problemen, is dit mijn manifestbestand: {your-manifest-json}

Als de manifesteigenschappen er goed uitzien en het een nieuw of bijgewerkt FinOps Hub-exemplaar was, bevestigt u de implementatie:

  1. Open de hubresourcegroep in Azure Portal.
  2. Selecteer Instellingenimplementaties> in het menu aan de linkerkant.
  3. Controleer of alle implementaties zijn geslaagd. Zoek met name naar de volgende implementatienamen:
    • main
    • naaf
    • dataFactoryResources
    • opslag
    • keyVault
  4. Als er implementaties zijn mislukt, bekijkt u het foutbericht om te bepalen of dit iets is dat u zelf kunt oplossen (bijvoorbeeld naamconflict, herstelbare beleidsschending).
  5. Als de fout tijdelijk lijkt, probeert u opnieuw te implementeren.
  6. Als de fout zich blijft voordoen, maakt u een discussie om te zien of iemand anders een probleem ondervindt of een mogelijke tijdelijke oplossing kent (met name voor beleidsproblemen).
  7. Als de fout duidelijk een fout of een functiefout is, maakt u een probleem met een bug of functieaanvraag in GitHub.

We proberen binnen twee werkdagen op problemen en discussies te reageren.


ResourceAccessForbiddenException

Power BI: Er is een uitzondering op het type Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException gegenereerd

Geeft aan dat het laden van gegevens van het account in Power BI niet de rol Opslagblobgegevenslezer heeft. Verdeel deze rol aan het laden van gegevens van het account in Power BI.


RoleAssignmentUpdateNotPermitted

Als u FinOps Hubs hebt verwijderd en deze opnieuw probeert te implementeren met dezelfde waarden, met inbegrip van de naam van de beheerde identiteit, kan het volgende bekende probleem optreden:

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

U kunt dit probleem oplossen door de verouderde identiteit te verwijderen:

  • Navigeer naar het opslagaccount en selecteer Toegangsbeheer (IAM) in het menu.
  • Selecteer het tabblad Roltoewijzingen.
  • Zoek roltoewijzingen met een onbekende identiteit en verwijder deze.

SchemaLoadFailed

Ernst: Kritiek

De FinOps-hub msexports_ETL_ingestion pijplijn kan het schemabestand niet laden.

Risicobeperking: bekijk het foutbericht om het type en de versie van de gegevensset te noteren, die zijn opgemaakt met een onderstrepingsteken (bijvoorbeeld <type>_<version> of FocusCost_1.0). Controleer of de gegevensset en het type beide worden ondersteund door de geïmplementeerde versie van FinOps-hubs. Zie ondersteunde gegevenssets voor meer informatie.


SchemaNotFound

Ernst: Kritiek

De FinOps-hub msexports_ExecuteETL-pijplijn kan het schematoewijzingsbestand voor de geëxporteerde gegevensset niet vinden.

Risicobeperking: controleer of het type en de versie van de gegevensset worden ondersteund. Zie ondersteunde gegevenssets voor meer informatie. Als de gegevensset wordt ondersteund, controleert u de hubversie met het rapport Gegevensopname.

Als u ondersteuning voor een andere gegevensset wilt toevoegen, maakt u een aangepast toewijzingsbestand en slaat u het config/schemas/<dataset-type>_<dataset-version>.jsonop. De <dataset-type> <dataset-version> waarden komen veel overeen met wat Cost Management gebruikt. Als u het gegevenstype voor elke kolom wilt identificeren, gebruikt u een bestaand schemabestand als sjabloon. Sommige gegevenssets hebben verschillende schema's voor EA en Microsoft-klantovereenkomst (MCA). Ze kunnen niet worden geïdentificeerd via deze kenmerken en kunnen een probleem veroorzaken als u beide accounttypen hebt. We werken aan het toevoegen van gegevenssets en het account voor de EA- en MCA-verschillen door uit te lijnen op FOCUS.


UnknownExportFile

Ernst: informatie

Het bestand in de hubopslag ziet er niet uit alsof het is geëxporteerd vanuit Cost Management. Bestand wordt genegeerd.

Risicobeperking: De msexports-container is alleen bedoeld voor Cost Management-exports. Verplaats andere bestanden in een andere opslagcontainer.


UnknownHubVersion

Ernst: Kritiek

Kan de versie van FinOps-hubs niet identificeren vanuit het instellingenbestand. Controleer of de instellingen juist zijn. FinOps-hubs 0.1.1 en eerder werken niet met dit Power BI-rapport.

Risicobeperking: Voer een upgrade uit naar de nieuwste versie van FinOps-hubs of download Power BI-rapporten uit de Versie van de FinOps-toolkit v0.1.1.


UnsupportedExportFileType

Ernst: Kritiek

Kan het opgegeven exportbestand niet opnemen omdat het bestandstype niet wordt ondersteund.

Risicobeperking: converteer het bestand naar een ondersteunde bestandsindeling voordat u het toevoegt aan de msexports-container of voeg ondersteuning toe voor het converteren van het nieuwe bestandstype naar de msexports_ETL_ingestion-pijplijn .


UnsupportedExportType

Ernst: waarschuwing

Het exportmanifest in hubopslag geeft aan dat de export was voor een niet-ondersteunde gegevensset. Geëxporteerde gegevens worden gerapporteerd als opnamefouten.

Risicobeperking: Maak een nieuwe Cost Management-export voor FOCUS-kosten en stop de huidige export of wijzig deze om te exporteren naar een andere opslagcontainer.


De <naamresourceprovider> is niet geregistreerd in de abonnements-GUID <>

Open het abonnement in Azure Portal en selecteer vervolgens Resourceproviders>instellingen, selecteer de rij resourceprovider (bijvoorbeeld Microsoft.EventGrid) en selecteer vervolgens de opdracht Registreren boven aan de pagina. Registratie kan enkele minuten duren.


x_PricingSubcategory toont de toezeggingskortings-id

Cost Management-exports vóór 28 februari 2024 hadden een fout waarbij x_PricingSubcategory onjuist werd ingesteld voor vastgelegd gebruik. U zou moeten verwachten dat waarden worden weergegeven zoals Committed Spend en Committed Usage. In plaats daarvan ziet u mogelijk waarden zoals:

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

Als u deze waarden ziet, exporteert u de kostengegevens voor die maand opnieuw. Als u gegevens wilt exporteren voor een oudere maand die niet beschikbaar is, neemt u contact op met de ondersteuning om de gegevens op te vragen die voor u worden geëxporteerd om het probleem met de gegevenskwaliteit van de vorige exportuitvoeringen op te lossen.


Power BI: Rapporten ontbreken gegevens voor specifieke datums

Als in uw rapport alle gegevens voor een of meer maanden ontbreken, controleert u de parameters Aantal maanden, RangeStart en RangeEnd om ervoor te zorgen dat de gegevens niet worden gefilterd.

Als u parameters wilt controleren, selecteert u Parameters bewerken van gegevens>op het lint of selecteert u de afzonderlijke parameters in de 🛠map Setup in het venster van de queryeditor.

  • Als u altijd een bepaald aantal recente maanden wilt weergeven, stelt u het aantal maanden in op het aantal gesloten (voltooide) maanden. De huidige maand is een extra maand naast het gesloten aantal maanden.
  • Als u een vast datumbereik wilt dat na verloop van tijd niet verandert (bijvoorbeeld rapportage over fiscaal jaar), stelt u RangeStart en RangeEnd in.
  • Als u wilt rapporteren over alle beschikbare gegevens, controleert u of alle drie de datumparameters leeg zijn.

Zie Uw eerste rapport instellen voor meer informatie.


Power BI: Rapporten zijn leeg (geen gegevens)

Als u geen gegevens in uw Power BI- of andere rapporten of hulpprogramma's ziet, kunt u het volgende proberen op basis van uw gegevensbron:

  1. Als u de Cost Management-connector in Power BI gebruikt, controleert u de Billing Account ID en Number of Months parameters om ervoor te zorgen dat deze correct zijn ingesteld. Houd er rekening mee dat oude factureringsrekeningen mogelijk geen gegevens bevatten in de afgelopen maanden.
  2. Als u FinOps-hubs gebruikt, controleert u het opslagaccount om ervoor te zorgen dat de gegevens worden ingevuld in de opnamecontainer . U ziet nu een map met providers of abonnementen . Gebruik de volgende secties om problemen verder op te lossen.

FinOps-hubs: Opnamecontainer is leeg

Als de opnamecontainer leeg is, opent u het Data Factory-exemplaar in Data Factory Studio en selecteert u Ontwerptriggers> beheren>en controleert u of de msexports_FileAdded trigger is gestart. Zo niet, start het.

Als de trigger niet kan worden gestart met de fout 'resourceprovider is niet geregistreerd', opent u het abonnement in Azure Portal en selecteert u Resourceproviders voor instellingen>, selecteert u de rij Microsoft.EventGrid en selecteert u vervolgens de opdracht Registreren boven aan de pagina. Registratie kan enkele minuten duren.

Nadat de registratie is voltooid, start u de msexports_FileAdded trigger opnieuw.

Nadat de trigger is gestart, voert u alle verbonden Cost Management-exports opnieuw uit. Gegevens moeten binnen 10-20 minuten volledig worden opgenomen, afhankelijk van de grootte van het account.

Als het probleem zich blijft voordoen, controleert u of Cost Management-exports zijn geconfigureerd met bestandspartitionering ingeschakeld. Als deze optie is uitgeschakeld, schakelt u deze in en voert u de exports opnieuw uit.

Controleer of de opnamecontainer is gevuld en vernieuw uw rapporten of andere verbonden hulpprogramma's.

FinOps-hubs: bestanden die beschikbaar zijn in de opnamecontainer

Als de opnamecontainer niet leeg is, controleert u of u parquet- of csv.gz-bestanden hebt door in te zoomen op de mappen.

Controleer zodra u weet of de parameter FileType is ingesteld op .parquet of .gz in het Power BI-rapport. Zie Verbinding maken met uw gegevens voor meer informatie.

Als u een ander hulpprogramma gebruikt, moet u ervoor zorgen dat het bestandstype wordt ondersteund dat u gebruikt.


Power BI: De externe naam kan niet worden omgezet: '<storage-account.dfs.core.windows.net>'

Geeft aan dat de naam van het opslagaccount onjuist is. Als u FinOps-hubs gebruikt, controleert u de storageUrl-parameter van de implementatie. Zie Verbinding maken met uw gegevens voor meer informatie.


Power BI: De waarde null kan niet worden geconverteerd naar het type Logisch

Geeft aan dat de parameter Factureringsrekening-id leeg is. Als u FinOps-hubs gebruikt, stelt u de waarde in op de gewenste factureringsrekening-id. Als u geen toegang hebt tot het factureringsaccount of geen toezeggingsaankopen en restituties wilt opnemen, stelt u de waarde 0 in op en opent u de CostDetails-query in de geavanceerde editor en wijzigt u het 2 in een 1. Het rapport informeert het rapport niet over het laden van werkelijke/gefactureerde kostengegevens van de Cost Management-connector. Zie Verbinding maken met uw gegevens voor meer informatie.

Toepasselijke versies: 0.1 - 0.1.1 (vast in 0.2)


FinOps-hubs: de waarde null kan niet worden geconverteerd naar het type Tabel

Deze fout geeft meestal aan dat gegevens niet zijn opgenomen in de opnamecontainer .

Als u net een upgrade hebt uitgevoerd naar FinOps-hubs 0.2, kan het probleem ertoe leiden dat het Power BI-rapport oud is (van 0.1.x) of omdat u geen FOCUS-exports gebruikt. Zie de upgradehandleiding voor meer informatie.

Zie Rapporten zijn leeg (geen gegevens) voor meer stappen voor probleemoplossing.


Gerelateerde inhoud

Als u de fout die u ondervindt niet ziet, doorloopt u de gids voor probleemoplossing. Als u vragen hebt, start u een discussie of maakt u een probleem in GitHub.