Delen via

Veelvoorkomende FinOps-toolkitfouten oplossen

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.


Toegang tot de bron is verboden

Ernst: Kritiek

Deze fout betekent in het algemeen dat het account waarmee u bent verbonden geen toegang heeft tot de resource die u probeert te gebruiken.

Risicobeperking: Controleer of u het juiste account gebruikt in de juiste Microsoft Entra ID-tenant.


AccountEigenschapKanNietWordenBijgewerkt

Ernst: Kritiek

Deze fout treedt meestal op bij het bijwerken van een FinOps-hubimplementatie met een andere configuratie van het opslagaccount dan oorspronkelijk is gebruikt tijdens het maken. Hoewel de meeste eigenschappen kunnen worden gewijzigd, zijn er enkele eigenschappen die slechts eenmaal kunnen worden ingesteld wanneer het opslagaccount wordt gemaakt en die niet kunnen worden gewijzigd. Het enige bekende geval hiervan voor FinOps-hubs is de eigenschap 'requireInfrastructureEncryption'. Als deze eigenschap is ingeschakeld of uitgeschakeld tijdens de eerste FinOps-hubimplementatie, kan deze niet worden gewijzigd. U ziet de volgende fout wanneer dit gebeurt:

De eigenschap 'requireInfrastructureEncryption' is opgegeven in de invoer, maar kan niet worden bijgewerkt omdat deze alleen-lezen is.

Risicobeperking: als u deze instelling niet wilt wijzigen, controleert u of uw opslagaccount is geconfigureerd voor het gebruik van infrastructuurversleuteling en implementeert u de FinOps-hubsjabloon opnieuw met dezelfde waarde (in of uit). Als u de instelling wilt wijzigen, raden we u aan een nieuw FinOps Hub-exemplaar te implementeren, omdat hiervoor alle gegevens opnieuw moeten worden opgenomen.

U kunt proberen het bestaande opslagaccount te verwijderen en de sjabloon opnieuw te implementeren nadat de infrastructuurversleuteling is gewijzigd; we hebben dit echter niet grondig getest. Hoewel we geen problemen verwachten, kunnen we niet bevestigen of dit problemen veroorzaakt.


VerkeerdeHubVersie

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.


Kolom 'id' in tabel 'Resources' bevat een dubbele waarde

Ernst: Kritiek

Als de volgende fout optreedt, betekent dit dat Azure Resource Graph rijen retourneert met dezelfde logische waarde voor de id-kolom . Dit kan gebeuren wanneer de resource-id-waarden inconsistent zijn of wanneer een andere kolom over rijen wordt uitgevouwen.

Kolom -id in tabel Resources bevat een dubbele waarde {resource-id} en dit is niet toegestaan voor kolommen aan de ene kant van een veel-op-een-relatie of voor kolommen die worden gebruikt als primaire sleutel van een tabel.

Risicobeperking: zorg ervoor dat u de nieuwste versie van het rapport gebruikt. Identificeer de oorzaak van de dubbele waarden en werk de query bij om de dubbele waarden te omzeilen. Meld dit probleem ook in GitHub , zodat dit in een toekomstige release kan worden opgelost. Hiervoor zijn mogelijk aanvullende details of een vergadering vereist om de oorzaak van de fout op te lossen.


ConflictError

Ernst: Kritiek

Er kunnen meerdere exemplaren van deze fout zijn. Het ene bekende exemplaar is wanneer Key Vault de volgende fout retourneert:

Er bestaat al een kluis met dezelfde naam in de status Verwijderd. U moet de bestaande sleutelkluis herstellen of verwijderen. Volg deze koppeling https://go.microsoft.com/fwlink/?linkid=2149745 voor meer informatie over voorlopig verwijderen.

Dit betekent over het algemeen dat u bovenop een oude implementatie plaatst die is verwijderd, maar Key Vault de oude kluisinstantie in een herstelbare verwijderingsstatus heeft behouden.

Mitigatie: Om dit op te lossen, verwijder de verwijderde Sleutelkluis in de Azure-portal.

  1. Open de lijst met Key Vault-exemplaren in Azure Portal.
  2. Selecteer de opdracht Verwijderde kluizen beheren boven aan de pagina.
  3. Selecteer het abonnement in de vervolgkeuzelijst.
  4. Controleer de kluizen die verwijderd moeten worden.
  5. Kies Opschonen onderaan het uitklapmenu.
  6. Selecteer Verwijderen in het bevestigingsvenster.

U kunt de implementatie nu opnieuw proberen.


GecontracteerdeKostenMinderDanWerkelijkeKosten

Niveau: Waarschuwing

ContractedCost (gebaseerd op onderhandelde kortingen) is kleiner dan EffectiveCost (na toezeggingskortingen) in de gegevens van Cost Management. Dit zou nooit moeten gebeuren, tenzij de toezeggingskorting minder korting biedt dan uw bestaande onderhandelde kortingen. Dit zorgt ervoor dat uw besparingsberekeningen niet precies optellen.

Risicobeperking: controleer of de ContractedUnitPrice kostengegevens overeenkomen met wat er in de prijsgegevens staat. Als de gecontracteerde prijs juist is, dient u een ondersteuningsaanvraag in bij het Cost Management-team om te bevestigen dat de x_EffectiveUnitPrice en EffectiveCost juist zijn. Als ze juist zijn, kunt u overwegen de toezeggingskorting te retourneren.


Toegangsbeleid voor meerdere tenants staat deze gebruiker niet toe

ernstigheid: ernstig

Als de volgende fout optreedt, betekent dit dat Microsoft Entra-id is geconfigureerd om gebruikers van andere tenants niet toe te staan zich aan te melden bij de huidige tenant.

Bericht: AADSTS500213: het toegangsbeleid voor meerdere tenants van de resourcetenant staat deze gebruiker geen toegang tot deze tenant toe.

Dit foutbericht is niet gerelateerd aan de FinOps-toolkit.

Risicobeperking: Controleer of u bent aangemeld bij het juiste account en of u zich hebt aangemeld via de doeldirectory. Neem contact op met de adreslijstbeheerder als u meer hulp nodig hebt.


DataVerkennerInvoerMislukt

Ernst: Kritiek

Opname van Data Explorer is mislukt. De nieuwe gegevens zijn niet beschikbaar voor rapportage.

Risicobeperking: bekijk het foutbericht van Data Explorer en los het probleem op. Voer gegevensopname opnieuw uit voor de opgegeven map met behulp van de ingestion_ExecuteETL-pijplijn in Azure Data Factory. Onopgeloste problemen melden op https://aka.ms/ftk/ideas.


DataExplorerInvoegmappingMislukt

Ernst: Kritiek

De gegevensinvoer mapping kon niet worden aangemaakt voor de opgegeven tabel.

Mitigation: Corrigeer de fout en voer de gegevensinvoer opnieuw uit voor het opgegeven mappad. Als u deze fout blijft zien, meldt u een probleem op https://aka.ms/ftk/ideas.


DataExplorerIngestionTimeout

Ernst: Kritiek

Gegevensverkennerverwerking verliep na 2 uur in een time-out terwijl er werd gewacht op beschikbare capaciteit.

Risicobeperking: voer deze pijplijn opnieuw uit om de invoer opnieuw te proberen. Als u deze fout blijft zien, meldt u een probleem op https://aka.ms/ftk/ideas.


DataverkennerPostInnameVerwijderingMislukt

Ernst: Kritiek

Het opschonen na opname in Data Explorer (het verwijderen van extents uit de uiteindelijke tabel) is mislukt. Gegevens van een eerdere opname kunnen aanwezig zijn in rapportage, wat kan leiden tot dubbele en onnauwkeurige kosten.

Risicobeperking: bekijk het foutbericht van Data Explorer en los het probleem op. Voer gegevensopname opnieuw uit voor de opgegeven map met behulp van de ingestion_ExecuteETL-pijplijn in Azure Data Factory. Onopgeloste problemen melden op https://aka.ms/ftk/ideas.


DataExplorerPreInvoerverwijderingMislukt

Ernst: Kritiek

Opschoning voorafgaand aan het binnenhalen van gegevens in Data Explorer (verwijderen van extents uit de onbewerkte tabel) is mislukt. Invoer is niet voltooid.

Risicobeperking: bekijk het foutbericht van Data Explorer en los het probleem op. Voer gegevensopname opnieuw uit voor de opgegeven map met behulp van de ingestion_ExecuteETL-pijplijn in Azure Data Factory. Onopgeloste problemen melden op https://aka.ms/ftk/ideas.


Evaluatie van implementatie-uitvoer mislukt

ernstigheid: ernstig

Met FinOps Hubs 0.8 stelt u de beveiligingsinstelling trustedExternaltenants van Azure Data Explorer in om het cluster te vergrendelen, zodat het alleen toegang kan hebben vanaf specifieke vertrouwde tenants. Deze instelling kan worden ingesteld voor de eerste implementatie, maar kan niet opnieuw worden ingesteld in een tweede implementatie. Mogelijk ziet u de volgende fout als u FinOps-hubs 0.8 opnieuw wilt implementeren boven op een bestaande 0.8-implementatie:

De sjabloonuitvoer clusterUri is ongeldig: de taalexpressieeigenschap 'URI' bestaat niet, beschikbare eigenschappen zijn 'trustedExternalTenants, enableStreamingIngest, publicNetworkAccess, enableAutoStop, provisioningState'.

We volgen het Azure Data Explorer-team op om de juiste oplossing te identificeren.

Risicobeperking: FinOps-hubs 0.9 implementeren. Deze instelling is verwijderd uit de sjabloon.


ExporteergegevensNietGevonden

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 van plan bent om FinOps-hubs te gebruiken, corrigeert u de opslag-URL zodat deze verwijst naar de container 'inname'. Raadpleeg de uitvoer van de storageUrlForPowerBI FinOps Hub-implementatie voor de volledige URL.


ExporttypeNietGedefinieerd

Ernst: Kritiek

Dit type factureringsbereik wordt niet ondersteund door beheerde exports.

Risicobeperking: verwijder het niet-ondersteunde factureringsbereik uit settings.json, controleer of het factureringsbereik wordt ondersteund door FinOps-hubs en maak handmatig nieuwe Kostenbeheer-exports voor het factureringsbereik.


ExportTypeNietOndersteund

Ernst: Kritiek

Microsoft-klantovereenkomsten worden niet ondersteund voor beheerde exports.

Risicobeperking: verwijder het MCA-factureringsbereik uit settings.json en maak handmatig nieuwe Cost Management-exporten voor elk MCA-factureringsprofiel voor FOCUS-kosten, prijslijst, reserveringsgegevens, reserveringstransacties en reserveringsaanbevelingen.


HubDataNotFound (HubgegevensNietGevonden)

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 te verwijzen naar de ingestion-container. Bevestig het volgende:

  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.

Voor meer informatie en foutopsporing, zie Uw FinOps Hub-implementatie valideren.


InslagBestandenNietGevonden

Ernst: Kritiek

Kon geen parquet-bestanden vinden om in te lezen vanuit het opgegeven mappad.

Risicobeperking: Controleer of het mappad het volledige pad is, inclusief de verwerkingscontainer en niet begint met of eindigt op een slash (/). Kopieer het pad van de laatste geslaagde ingestion_ExecuteETL pijplijnuitvoering.


InternalServiceError

Microsoft Fabric Real-Time Intelligence retourneert mogelijk de foutcode InternalServiceError (520-UnknownError) bij het opnemen van gegevens. Het gedetailleerde foutbericht kan het volgende zeggen:

Kusto-client kan geen aanvraag verzenden naar de service: 'Kan geen gegevens lezen uit de transportverbinding: een bestaande verbinding is geforceerd gesloten door de externe host.' `

De exacte reden voor deze fout is onbekend. Als u dit ondervindt, dient u een ondersteuningsaanvraag in bij Microsoft Fabric om verder te onderzoeken.

Risicobeperking: Wijzig als tijdelijke oplossing het minimale verbruik voor de Fabric eventhouse in Gemiddeld (18 CUs), wacht 30 minuten en voer de ingestion_ExecuteETL pijplijn opnieuw uit voor die gegevensset en maand. Ga naar Minimumverbruik in het eventhouse-overzicht voor meer informatie over minimumverbruik.


Ongeldige Effectieve Kosten

ernstigheid: ernstig

Vanaf november 2024 heeft Cost Management een bekende fout waarbij aankopen van spaarplannen intern worden bijgehouden als zowel werkelijke als afgeschreven kosten. Als gevolg hiervan omvat FOCUS aankopen van spaarplannen in de berekening voor EffectiveCost, wat leidt tot onnauwkeurige getallen in FinOps Toolkit-rapporten.

Risicobeperking: dien een ondersteuningsaanvraag in bij het Microsoft Cost Management-team met details over het probleem om de onderliggende gegevens op te lossen. Vanaf november 2024 is het team op de hoogte van het probleem, maar de oplossing heeft nog geen prioriteit gekregen. Werk in de tussentijd bij naar FinOps Toolkit 0.7, inclusief een tijdelijke oplossing voor FinOps-hubs en power BI-rapporten op basis van opslag.


InvalidExportContainer

Ernst: Kritiek

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

Afwikkelingsmaatregel: Werk uw Cost Management-export bij om te verwijzen naar de opslagcontainer 'msexports'. De container 'opname' wordt alleen gebruikt voor het opvragen van opgenomen kostengegevens.


OngeldigeExportVersie

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 zijn niet compatibel met het Data-inname Power BI-rapport.

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 de scope waarvoor 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 de scope te gebruiken.


LegacyFocusVersion

Ernst: informatie

Deze foutcode wordt weergegeven wanneer de opgenomen gegevens een oudere versie van FOCUS gebruiken. Wanneer u deze in de kolom x_SourceChanges vindt, is de code alleen informatief. Wanneer in Power BI-opslagrapporten de melding verschijnt dat de kostenquery niet kan worden geladen, betekent dit dat de parameter Verouderd: Extra queryoptimalisaties is uitgeschakeld.

Met FinOps-hubs worden gegevens geconverteerd naar de nieuwste FOCUS-versie, dus dit kan geen probleem veroorzaken; De moderniseringstransformatie kan echter niet rekening houden met alle scenario's en kan leiden tot onverwachte resultaten in sommige gevallen. Raadpleeg de documentatie voor bekende problemen.

Risicobeperking: er zijn verschillende manieren om dit bericht te beperken, afhankelijk van het hulpprogramma dat u gebruikt.

Als u FinOps-hubs gebruikt met Data Explorer en dit ziet in de kolom x_SourceChanges van de tabel Kosten of gerelateerde functies, werkt u Cost Management-kostenexports bij om de nieuwste FOCUS-versie te gebruiken. Er hoeven geen extra wijzigingen te worden aangebracht om alle gegevens samen te voegen tijdens de opname van Data Explorer.

Als u opslagrapporten gebruikt en deze ziet in de kolom x_SourceChanges van de query Kosten, is dit bericht een waarschuwing dat deze FOCUS-versie wordt verwijderd in een toekomstige update. Hoewel u dit bericht veilig kunt negeren, is een update in een toekomstige release vereist. Als u het bericht wilt voorkomen, werkt u Cost Management-exports bij naar de nieuwste FOCUS-versie, verwijdert of verplaatst u oudere gegevens met een oudere FOCUS-versie en exporteert u historische gegevens opnieuw. Als u FinOps-hubs gebruikt, verwijdert of verplaatst u gegevens buiten de opname container. Als u uw eigen exports in de opslag host, wijzigt u de Storage-URL parameter in een ander mappad dat geen oudere FOCUS-versies bevat.

Vanaf FinOps Toolkit 0.7 is ondersteuning voor oudere FOCUS-versies afgeschaft om de prestaties en schaalbaarheid te verbeteren. We raden u aan om bij te werken naar de nieuwste FOCUS-versie en gegevens opnieuw te exporteren om uw ervaring te verbeteren. Stel de Verouderd: Voer extra queryoptimalisaties uit parameter in op TRUE om ervoor te zorgen dat oudere FOCUS-versies worden ondersteund en stel deze in op FALSE om de prestaties te versnellen en grotere datasets te ondersteunen die meer kosten of tijd dekken. Vanaf 0.7 is deze parameter standaard ingeschakeld voor compatibiliteit met eerdere versies. In FinOps Toolkit 0.8 wordt deze standaard uitgeschakeld, maar nog steeds beschikbaar voor compatibiliteit met eerdere versies tot of na juni 2025. Als u niet kunt overstappen van oude FOCUS-versies of voor de beste prestaties en ondersteuning voor grotere accounts of langere periodes, raden we aan FinOps-hubs te gebruiken met Data Explorer.


LijstkostLagerDanGecontracteerdeKost

Niveau: Waarschuwing

ListCost (gebaseerd op openbare, detailhandelsprijzen) is kleiner dan ContractedCost (op basis van overeengekomen kortingen) in de gegevens van Cost Management. Dit zou nooit moeten gebeuren. Dit zorgt ervoor dat uw besparingsberekeningen niet precies optellen.

Risicobeperking: controleer of de ListUnitPrice kostengegevens overeenkomen met wat er in de prijsgegevens staat. Als de catalogusprijs juist is, dient u een ondersteuningsaanvraag in bij het Cost Management-team om te controleren of de ListUnitPrice prijs ContractedUnitPrice juist is en verklaart u waarom de prijs na onderhandelde kortingen hoger is dan de openbare retailtarieven.


ManifestLezenMislukt

Ernst: Kritiek

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

Mitigatie:

  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. Het is niet hoofdlettergevoelig.
    • het type moet bestaan, maar mag met deze fout niet falen voor een niet-nul waarde.
    • dataVersion moet bestaan, maar mag bij geen enkele niet-nul-waarde met deze fout mislukken.
    • 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. Om het toevoegen van ondersteuning voor de nieuwe API-versie bij te houden, maakt u een wijzigingsverzoek 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.

      Aanbeveling

      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 Author > Pipelines > msexports_ExecuteETL, selecteert u de toepasselijke 'Set'-activiteiten en werkt u de Instellingen>Waarde-eigenschap indien nodig bij. Als u dit doet, hoeft u de export niet opnieuw te maken met een oudere versie. Meld het probleem en overweeg om de nieuwe JSON te delen via het {} pictogram rechtsboven in de pijplijndesigner.

  9. Als u ziet dat de eigenschappen zijn gewijzigd voor een ondersteunde API-versie:
    1. Om de incompatibele wijziging bij te houden, registreer een wijzigingsverzoek in GitHub. Neem het type, dataVersion en apiVersion op uit uw manifest.json-bestand.
    2. ** Dien een ondersteuningsaanvraag in bij Cost Management om te verzoeken de wijziging terug te draaien, omdat deze problemen veroorzaakt voor iedereen die FinOps-hubs of andere aangepaste oplossingen gebruikt. 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 de consistente levering van de eigenschappen exportConfig.resourceId, exportConfig.type en exportConfig.dataVersion vereist. Ik zag dat deze bestanden niet worden opgenomen in het manifestbestand voor deze API-versie voor mijn export die op <your-export-date> werd uitgevoerd. 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:
    • voornaamste
    • knooppunt
    • 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 bug of functieprobleem is, maakt u een bug- of functieaanvraag op GitHub.

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


OntbrekendeGecontracteerdeKosten

Ernst: informatie

Deze foutcode wordt weergegeven in de x_SourceChanges kolom wanneer ContractedCost null of 0 is en EffectiveCost groter is dan 0. De fout geeft aan dat Microsoft Cost Management ContractedCost niet omvat voor de opgegeven rijen, wat betekent dat besparingen niet 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.


OntbrekendeContractueleEenheidsprijs

Ernst: informatie

Deze foutcode wordt weergegeven in de x_SourceChanges kolom wanneer ContractedUnitPrice null of 0 is en EffectiveUnitPrice groter is dan 0. De fout geeft aan dat Microsoft Cost Management ContractedUnitPrice niet omvat voor de opgegeven rijen, wat betekent dat besparingen niet 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_SourceChanges kolom wanneer ListCost null of 0 is en ContractedCost groter is dan 0. De fout geeft aan dat Microsoft Cost Management ListCost niet omvat voor de opgegeven rijen, wat betekent dat besparingen niet 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.


OntbrekendeLijstEenheidsprijs

Ernst: informatie

Deze foutcode wordt weergegeven in de x_SourceChanges kolom wanneer ListUnitPrice null of 0 is en ContractedUnitPrice groter is dan 0. De fout geeft aan dat Microsoft Cost Management ListUnitPrice niet omvat voor de opgegeven rijen, wat betekent dat besparingen niet 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.


Probleem: OntbrekendeProviderNaam

Ernst: informatie

Deze foutcode wordt weergegeven in de kolom x_SourceChanges wanneer ProviderName null is. De fout geeft aan dat de provider van de gegevensset (bijvoorbeeld Microsoft Cost Management) geen ProviderName waarde voor de opgegeven rijen bevat.

Risicobeperking: Als tijdelijke oplossing voor de ontbrekende gegevens probeert FinOps Toolkit de provider te identificeren op basis van de beschikbare kolommen.


Query '...' verwijst naar andere query's of stappen

ernst: klein

De bron van deze fout is onbekend. Deze fout kan willekeurig worden weergegeven bij het vernieuwen van Power BI-gegevens.

Risicobeperking: als u deze fout ontvangt, selecteert u Wijziging opnieuw toepassen.

Deze fout is alleen gerapporteerd in opslagrapporten. Als u lange vernieuwingstijden voor gegevens hebt of deze fout vaak ondervindt, kunt u overwegen om over te schakelen naar FinOps-hubs met Data Explorer. Data Explorer maakt gebruik van KQL-rapporten waarvoor geen planning of incrementeel vernieuwen is vereist. Gegevens worden opgehaald wanneer het rapport wordt geopend, zodat rapporten altijd de meest recente gegevens weergeven.


ResourceToegangVerbodenUitzondering

ernstigheid: ernstig

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

Geeft aan dat de gegevens van het account in Power BI niet worden geladen omdat deze niet de Storage Blob Data Reader rol heeft. Geef deze rol aan de account die gegevens laadt in Power BI.


Grootte van nettolading van antwoord is... en heeft de limiet overschreden

ernstigheid: ernstig

Azure Resource Graph-queries in de Power BI-rapporten over governance en workloadoptimalisatie kunnen een fout retourneren die vergelijkbaar is met:

OLE DB- of ODBC-fout: [Expression.Error] Geef onderstaande informatie op bij het vragen om ondersteuning: tijdstempel = {timestamp}, correlationId = {guid}. Details: De nettoladinggrootte van het antwoord is {number} en heeft de limiet van 16777216 overschreden. Overweeg om minder gegevens tegelijk op te vragen en indien nodig gepagineerde aanroepen uit te voeren.

Deze fout betekent dat u meer resources hebt dan wordt ondersteund in een niet-gefilterde Resource Graph-query. Dit gebeurt omdat FinOps-toolkitrapporten zijn ontworpen om details op resourceniveau weer te geven en niet worden samengevoegd. Ze zijn ontworpen voor kleine en middelgrote omgevingen en zijn niet ontworpen ter ondersteuning van organisaties met miljoenen resources.

Probleemoplossing: Als u deze fout tegenkomt, zijn er verschillende opties:

  • Verwijder kolommen die niet nodig zijn voor uw behoeften.
  • Filter de query om minder resources te retourneren op basis van wat voor u het belangrijkst is (bijvoorbeeld abonnementen, tags).
  • Schakel de query uit, zodat andere query's niet kunnen worden uitgevoerd.

RoltoewijzingsupdateNietToegestaan

ernst: klein

Als u FinOps-hubs hebt verwijderd en deze opnieuw probeert te implementeren met dezelfde waarden, inclusief 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."

Oplossing: Als u dit probleem wilt oplossen, moet u de verouderde identiteit 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.

RoltoewijzingBestaat

ernst: klein

Bij het upgraden van FinOps-hubs van de ene versie naar een andere, kan de volgende fout optreden als roltoewijzingen die in een vorige implementatie zijn gemaakt, nog steeds bestaan:

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

Dit komt waarschijnlijk doordat een beheerde identiteit expliciet is verwijderd zonder eerst alle roltoewijzingen te verwijderen.

Oplossing: Verwijder de zwevende roltoewijzingen in Azure Portal om dit probleem op te lossen:

  • Navigeer naar de resourcegroep of de betrokken resource (zoals een Data Explorer-cluster).
  • Selecteer Toegangsbeheer (IAM) in het menu.
  • Selecteer het tabblad Roltoewijzingen.
  • Zoek roltoewijzingen met een onbekende identiteit en verwijder ze.

SchemaLadenMislukt

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.


SchemaNietGevonden

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, bevestigt u de hubversie met het Data-invoerrapport.

Als u ondersteuning voor een andere dataset wilt toevoegen, maakt u een aangepast toewijzingsbestand en slaat u het config/schemas/<dataset-type>_<dataset-version>.json op. 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 datasets en houden rekening met de EA- en MCA-verschillen door af te stemmen op FOCUS.


De importopslag-URL komt met geen enkele export overeen

ernstigheid: ernstig

Als u dit ondervindt in FinOps Toolkit 0.8-rapporten, wordt de fout veroorzaakt door een verwijzing naar een parameter die niet bestaat.

Risicobeperking: Dit is opgelost in FinOps Toolkit 0.9. Werk bij naar de nieuwste versie om de oplossing toe te passen. Als u de fix rechtstreeks op de 0.8-rapporten wilt toepassen, bewerkt u de functie ftk_DemoFilter in de geavanceerde editor en wijzigt u de inhoud in: () => "". Sla op, sluit en pas alle wijzigingen toe.


OnbekendExportbestand

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.


OnbekendeFocusVersie

Ernst: informatie

Deze foutcode wordt weergegeven in de kolom x_SourceChanges wanneer een FOCUS-versie niet kan worden geïdentificeerd.

Risicobeperking: controleer of de FOCUS-gegevensset een ondersteunde FOCUS-versie gebruikt. Meld dit probleem met een geanonimiseerde steekproef van de gegevens op https://aka.ms/ftk/ideas om verder te onderzoeken.


OnbekendeHubVersie

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 .


Niet-ondersteund exporttype

Niveau: 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 resourceprovider {name} is niet geregistreerd in abonnement {guid}

ernst: klein

Open het abonnement in de Azure-portal en selecteer Instellingen>Resourceproviders, selecteer de rij resourceprovider (bijvoorbeeld Microsoft.EventGrid) en selecteer vervolgens de opdracht Registreren bovenaan de pagina. Registratie kan enkele minuten duren.


x_PricingSubcategory toont de ID van de toezeggingskorting

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 Gegevens transformeren>Parameters bewerken in het lint of selecteert u de individuele 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 zou een providersmap of een abonnementenmap moeten zien. Gebruik de volgende secties om problemen verder op te lossen.

FinOps-knooppunten: Het opslagcontainer is leeg

Als de opnamecontainer leeg is, opent u het Data Factory-exemplaar in Data Factory Studio en selecteert u Beheren>Ontwerpen>Triggers en controleert u of de msexports_FileAdded trigger is gestart. Als dat niet het geval is, start het.

Als de trigger niet kan worden gestart vanwege de fout 'resourceprovider is niet geregistreerd', opent u het abonnement in de Azure-portal en selecteert u Instellingen>Resourceproviders, 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 de mappen te kijken.

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 opgelost: '<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 instrueert het rapport om geen werkelijke/gefactureerde kostengegevens van de Cost Management-connector te laden. 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.


Feedback geven

Laat ons weten hoe we het doen met een korte beoordeling. We gebruiken deze beoordelingen om FinOps-hulpprogramma's en -resources te verbeteren en uit te breiden.

feedback geven

Als u op zoek bent naar iets specifieks, stem dan op een bestaande of maak een nieuw idee. Deel ideeën met anderen om meer stemmen te krijgen. We richten ons op ideeën met de meeste stemmen.

stemmen of ideeën voorstellen


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.


  • Last updated on