Dela via

Felsöka vanliga Fel med FinOps-verktyg

  • Artikel

Den här artikeln beskriver vanliga Fel med FinOps-verktyg och innehåller information om lösningar. Om du får ett fel när du använder FinOps-verktygslösningar som du inte förstår eller inte kan lösa hittar du följande motsvarande felkod med åtgärdssteg för att lösa problemet.

Här är en lista över vanliga felkoder med åtgärdsinformation.

Om den angivna informationen inte löser problemet kan du prova felsökningsguiden.


BadHubVersion

Allvarlighetsgrad: Kritisk

FinOps Hubs 0.2 fungerar inte. Uppgradera till version 0.3 eller senare.

Åtgärd: Uppgradera till den senaste versionen av FinOps-hubbar.


InvalidExportContainer

Allvarlighetsgrad: Kritisk

Den här filen ser ut att kunna exporteras från Cost Management, men den finns inte i rätt container.

Åtgärd: Uppdatera Cost Management-exporten så att den pekar på lagringscontainern "msexports". Containern "inmatning" används endast för att köra frågor mot inmatade kostnadsdata.


InvalidExportVersion

Allvarlighetsgrad: Kritisk

FinOps-hubbar kräver FOCUS-kostnadsexporter, men den här filen ser ut som en äldre Cost Management-export.

Åtgärd: Skapa en ny Cost Management-export för FOCUS-kostnaden och stoppa antingen den aktuella exporten eller ändra den så att den exporteras till en annan lagringscontainer.


InvalidHubVersion

Allvarlighetsgrad: Kritisk

FinOps Hubs 0.1.1 och tidigare fungerar inte med Power BI-rapporten för datainmatning.

Åtgärd: Uppgradera till den senaste versionen av FinOps-hubbar eller ladda ned Power BI-rapporter från version 0.1.1.


InvalidScopeId

Allvarlighetsgrad: Information

Exportsökvägen är inte ett giltigt omfångs-ID. FinOps-hubbar förväntar sig att exportsökvägen ska vara ett Azure-resurs-ID för det omfång som exporten skapades för att förenkla hanteringen. Det bör inte orsaka fel, men kan leda till förvirrande resultat för omfångsrelaterade rapporter.

Åtgärd: Uppdatera lagringssökvägen för Cost Management-exporten för att använda det fullständiga Azure-resurs-ID:t för omfånget.


ExportDataNotFound

Allvarlighetsgrad: Kritisk

Exporter hittades inte i den angivna lagringssökvägen.

Åtgärd: Bekräfta att en Cost Management-export har skapats och konfigurerats med rätt lagringskonto, container och lagringssökväg. När du har skapat väljer du Kör nu för att starta exportprocessen. Exporten kan ta 15–30 minuter att slutföra beroende på kontots storlek. Om du avsåg att använda FinOps-hubbar korrigerar du lagrings-URL:en så att den pekar på containern "inmatning". storageUrlForPowerBI Se utdata från FinOps Hub-distributionen för den fullständiga URL:en.


HubDataNotFound

Allvarlighetsgrad: Kritisk

FinOps-hubbdata hittades inte i det angivna lagringskontot.

Åtgärd: Det här felet förutsätter att du ansluter till en FinOps Hub-distribution. Om du använder råexport korrigerar du lagringssökvägen så att den inte refererar till containern ingestion . Bekräfta följande information:

  1. Lagrings-URL:en ska matcha StorageUrlForPowerBI utdata i FinOps Hub-distributionen.
  2. Cost Management-exporter ska konfigureras så att de pekar på samma lagringskonto med containern msexports .
  3. Cost Management-exporter bör visa en lyckad export i körningshistoriken.
  4. FinOps Hub-datafabriksutlösare bör alla startas.
  5. FinOps-hubbens datafabrikspipelines bör lyckas.

Mer information och felsökningssteg finns i Verifiera din FinOps Hub-distribution.


MissingContractedCost

Allvarlighetsgrad: Information

Den här felkoden visas i kolumnen när ContractedCost den x_DatasetChanges är null eller 0 och EffectiveCost är större än 0. Felet anger att Microsoft Cost Management inte inkluderade ContractedCost för de angivna raderna, vilket innebär att besparingar inte kan beräknas.

Åtgärd: Som en lösning på de data som saknas kopierar EffectiveCost FinOps toolkit-rapporter till ContractedCost kolumnen för rader som har flaggats med den här felkoden. Besparingar är inte tillgängliga för dessa poster.

Om du vill beräkna fullständiga besparingar kan du koppla kostnads- och användningsdata till priser. Mer information finns i problem #873.


MissingContractedUnitPrice

Allvarlighetsgrad: Information

Den här felkoden visas i kolumnen när ContractedUnitPrice den x_DatasetChanges är null eller 0 och EffectiveUnitPrice är större än 0. Felet anger att Microsoft Cost Management inte inkluderade ContractedUnitPrice för de angivna raderna, vilket innebär att besparingar inte kan beräknas.

Åtgärd: Som en lösning på de data som saknas kopierar EffectiveUnitPrice FinOps toolkit-rapporter till ContractedUnitPrice kolumnen för rader som har flaggats med den här felkoden. Besparingar är inte tillgängliga för dessa poster.

Om du vill beräkna fullständiga besparingar kan du koppla kostnads- och användningsdata till priser. Mer information finns i problem #873.


MissingListCost

Allvarlighetsgrad: Information

Den här felkoden visas i kolumnen när ListCost den x_DatasetChanges är null eller 0 och ContractedCost är större än 0. Felet anger att Microsoft Cost Management inte inkluderade ListCost för de angivna raderna, vilket innebär att besparingar inte kan beräknas.

Åtgärd: Som en lösning på de data som saknas kopierar ContractedCost FinOps toolkit-rapporter till ListCost kolumnen för rader som har flaggats med den här felkoden. Besparingar är inte tillgängliga för dessa poster.

Om du vill beräkna fullständiga besparingar kan du koppla kostnads- och användningsdata till priser. Mer information finns i problem #873.


MissingListUnitPrice

Allvarlighetsgrad: Information

Den här felkoden visas i kolumnen när ListUnitPrice den x_DatasetChanges är null eller 0 och ContractedUnitPrice är större än 0. Felet anger att Microsoft Cost Management inte inkluderade ListUnitPrice för de angivna raderna, vilket innebär att besparingar inte kan beräknas.

Åtgärd: Som en lösning på de data som saknas kopierar ContractedUnitPrice FinOps toolkit-rapporter till ListUnitPrice kolumnen för rader som har flaggats med den här felkoden. Besparingar är inte tillgängliga för dessa poster.

Om du vill beräkna fullständiga besparingar kan du koppla kostnads- och användningsdata till priser. Mer information finns i problem #873.


ManifestReadFailed

Allvarlighetsgrad: Kritisk

FinOps Hub msexports_ExecuteETL pipeline kunde inte läsa Cost Management-manifestfilen.

Riskreducering:

  1. Om felet uppstod på en instans av en fungerande hubb när inga ändringar gjordes i hubben eller exporten ändrade Cost Management eventuellt manifestschemat för en befintlig API-version.
  2. Om felet uppstod när du har skapat en ny eller ändrat en befintlig export kan export-API-versionen använda ett nytt manifestschema som inte stöds.
  3. Om felet uppstod efter en hubbdistribution (inledande installation eller uppgradering) misslyckades distributionen eller så kan det finnas ett fel i pipelinen.

Bekräfta manifestschemat (#1) eller API-versionen (#2):

  1. Öppna hubblagringskontot i Azure Portal eller lagringsutforskaren.
  2. Om du är i Azure Portal går du till Lagringswebbläsaren på menyn.
  3. Välj containern msexports .
  4. Navigera nedåt i filhierarkin för exporten med problemet (se manifestplatsen i felmeddelandet).
  5. Leta upp filen manifest.json och välj menyn (⋯) och välj sedan Visa/redigera.
  6. Identifiera följande egenskaper: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Bekräfta att de är inställda på följande värden som stöds:
    • resourceId kan vara valfritt omfångs-ID och valfritt exportnamn, men det måste finnas med resurstypen "Microsoft.CostManagement/exports". Det är skiftlägeskänsligt.
    • måste finnas, men får inte misslyckas med det här felet för alla värden som inte är null.
    • dataVersion måste finnas, men bör inte misslyckas med det här felet för något värde som inte är null.
    • apiVersion används inte explicit men kan innebära ändringar i manifestschemat. Mer information finns i API-versioner som stöds.
  8. Om du använder en nyare API-version:
    1. Om du vill spåra tilläggsstöd för den nya API-versionen skapar du ett problem med ändringsbegäran i GitHub.
    2. Ta bort exporten i Cost Management.
    3. Skapa en export med kommandot New-FinOpsCostExport PowerShell med hjälp av en API-version som stöds.

      Dricks

      Om du anser dig själv vara en energianvändare kanske du vill prova att uppdatera pipelinen själv för den snabbaste lösningen. Om du vill göra det öppnar du Data Factory, navigerar till Skapa pipelines > msexports_ExecuteETL och väljer tillämpliga "Ange"-aktiviteter och uppdaterar egenskapen Inställningsvärde> efter behov.> Om du gör det behöver du inte återskapa exporten med en äldre version. Rapportera fortfarande problemet och överväg att dela den nya JSON-filen från {} ikonen längst upp till höger i pipelinen designer._

  9. Om du märker att egenskaperna har ändrats för en API-version som stöds:
    1. Om du vill spåra den icke-bakåtkompatibla ändringen skapar du ett problem med ändringsbegäran i GitHub. Inkludera typen, dataVersion och apiVersion från din manifest.json-fil.
    2. Skicka en supportbegäran till Cost Management för att begära att ändringen ska återställas eftersom den bryter alla med hjälp av FinOps-hubbar eller andra anpassade lösningar. Ta med följande information för att hjälpa Cost Management-supportteamet att identifiera problemet i systemet. Cost Management har ingen kontext om FinOps-hubbar, så du bör hålla informationen fokuserad på Cost Management-funktioner. Här är ett exempel:

      Jag använder Cost Management-exporter för att hämta mina kostnadsdata till ADLS. Jag har en ADF-pipeline som bearbetar data när manifestfiler skrivs. Min pipeline byggdes på EN API-version <your-supported-api-version> som förväntar sig exportConfig.resourceIdatt egenskaperna , exportConfig.typeoch exportConfig.dataVersion ska levereras konsekvent. Jag har märkt att dessa filer inte ingår i manifestfilen för den här API-versionen för min export som kördes på <your-export-date>. Jag förväntar mig att manifestfilen aldrig ska ändras för en befintlig API-version. Kan du återställa ändringarna?

      För att hjälpa dig att felsöka, här är min manifestfil: {your-manifest-json}

Om manifestegenskaperna ser bra ut och det var en ny eller uppgraderad FinOps-hubbinstans bekräftar du distributionen:

  1. Öppna hubbresursgruppen i Azure Portal.
  2. Välj Inställningar>Distributioner i menyn till vänster.
  3. Bekräfta att alla distributioner har slutförts. Mer specifikt letar du efter följande distributionsnamn:
    • main
    • nav
    • dataFactoryResources
    • storage
    • keyVault
  4. Om några distributioner misslyckades granskar du felmeddelandet för att avgöra om det är något du kan lösa själv (till exempel namnkonflikt, korrigeringsbar principöverträdelse).
  5. Om felet verkar tillfälligt kan du försöka distribuera igen.
  6. Om felet kvarstår skapar du en diskussion för att se om någon annan har problem eller känner till en möjlig lösning (särskilt för principproblem).
  7. Om felet helt klart är ett fel eller funktionsgap skapar du ett problem med en bugg eller funktionsbegäran i GitHub.

Vi försöker svara på problem och diskussioner inom två arbetsdagar.


ResourceAccessForbiddenException

Power BI: Ett undantag för typen "Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException" utlöstes

Anger att kontot som läser in data i Power BI inte har rollen Storage Blob Data Reader. Bevilja den här rollen till kontots inläsningsdata i Power BI.


RoleAssignmentUpdateNotPermitted

Om du har tagit bort FinOps Hubs och försöker distribuera om dem med samma värden, inklusive namnet på den hanterade identiteten, kan du stöta på följande kända problem:

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

För att åtgärda problemet måste du ta bort den inaktuella identiteten:

  • Gå till lagringskontot och välj Åtkomstkontroll (IAM) på menyn.
  • Välj fliken Rolltilldelningar.
  • Hitta eventuella rolltilldelningar med en "okänd" identitet och ta bort dem.

SchemaLoadFailed

Allvarlighetsgrad: Kritisk

FinOps Hub msexports_ETL_ingestion pipeline kunde inte läsa in schemafilen.

Åtgärd: Granska felmeddelandet för att notera datamängdstypen och versionen, som är formaterad med ett understreck (till exempel <type>_<version> eller FocusCost_1.0). Bekräfta att både datauppsättningen och typen stöds av den distribuerade versionen av FinOps-hubbar. Mer information finns i datauppsättningar som stöds.


SchemaNotFound

Allvarlighetsgrad: Kritisk

FinOps Hub msexports_ExecuteETL pipeline kunde inte hitta schemamappningsfilen för den exporterade datauppsättningen.

Åtgärd: Bekräfta att datamängdstypen och versionen stöds. Mer information finns i datauppsättningar som stöds. Om datauppsättningen stöds bekräftar du hubbversionen med datainmatningsrapporten.

Om du vill lägga till stöd för en annan datauppsättning skapar du en anpassad mappningsfil och sparar den i config/schemas/<dataset-type>_<dataset-version>.json. Värdena <dataset-type> <dataset-version> matchar mycket vad Cost Management använder. Om du vill identifiera datatypen för varje kolumn använder du en befintlig schemafil som en mall. Vissa datauppsättningar har olika scheman för EA och Microsoft-kundavtal (MCA). De kan inte identifieras via dessa attribut och kan orsaka problem om du har båda kontotyperna. Vi arbetar med att lägga till datauppsättningar och ta hänsyn till EA- och MCA-skillnaderna genom att anpassa till FOCUS.


UnknownExportFile

Allvarlighetsgrad: Information

Filen i hubblagringen ser inte ut som om den exporterades från Cost Management. Filen ignoreras.

Åtgärd: Containern msexports är endast avsedd för Cost Management-exporter. Flytta andra filer i en annan lagringscontainer.


UnknownHubVersion

Allvarlighetsgrad: Kritisk

Det går inte att identifiera versionen av FinOps-hubbar från inställningsfilen. Kontrollera att inställningarna är korrekta. FinOps hubs 0.1.1 och tidigare fungerar inte med den här Power BI-rapporten.

Åtgärd: Uppgradera till den senaste versionen av FinOps-hubbar eller ladda ned Power BI-rapporter från FinOps toolkit v0.1.1-versionen.


ExportFileType stöds inte

Allvarlighetsgrad: Kritisk

Det går inte att mata in den angivna exportfilen eftersom filtypen inte stöds.

Åtgärd: Konvertera filen till ett filformat som stöds innan du lägger till i containern msexports eller lägg till stöd för att konvertera den nya filtypen till msexports_ETL_ingestion pipeline.


ExportType stöds inte

Allvarlighetsgrad: Varning

Exportmanifestet i hubblagringen anger att exporten var för en datauppsättning som inte stöds. Exporterade data rapporteras som inmatningsfel.

Åtgärd: Skapa en ny Cost Management-export för FOCUS-kostnaden och stoppa antingen den aktuella exporten eller ändra den så att den exporteras till en annan lagringscontainer.


Namnresursprovidern <> är inte registrerad i prenumerations-GUID <>

Öppna prenumerationen i Azure Portal och välj sedan Inställningar>Resursproviders, välj resursproviderraden (till exempel Microsoft.EventGrid) och välj sedan kommandot Registrera överst på sidan. Registreringen kan ta några minuter.


x_PricingSubcategory visar åtaganderabatt-ID

Cost Management-exporter före den 28 februari 2024 hade en bugg där x_PricingSubcategory det angavs felaktigt för den incheckade användningen. Du bör förvänta dig att se värden som Committed Spend och Committed Usage. I stället kan du se värden som:

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

Om du ser dessa värden exporterar du kostnadsdata för den månaden igen. Om du behöver exportera data för en äldre månad som inte är tillgänglig kontaktar du supporten för att begära att data exporteras så att du kan lösa datakvalitetsproblemet från tidigare exportkörningar.


Power BI: Rapporter saknar data för specifika datum

Om rapporten saknar alla data i en eller flera månader kontrollerar du parametrarna Antal månader, RangeStart och RangeEnd för att se till att data inte filtreras bort.

Om du vill kontrollera parametrar väljer du Transformera data>Redigera parametrar i menyfliksområdet eller väljer de enskilda parametrarna i 🛠mappen ️ Installationsmapp från frågeredigerarens fönster.

  • Om du alltid vill visa ett visst antal senaste månader anger du Antal månader till antalet stängda (slutförda) månader. Den aktuella månaden är en extra månad utöver det stängda antalet månader.
  • Om du vill ha ett fast datumintervall som inte ändras över tid (till exempel räkenskapsårsrapportering) anger du RangeStart och RangeEnd.
  • Om du vill rapportera om alla tillgängliga data kontrollerar du att alla tre datumparametrarna är tomma.

Mer information finns i Konfigurera din första rapport.


Power BI: Rapporter är tomma (inga data)

Om du inte ser några data i Power BI eller andra rapporter eller verktyg kan du prova följande baserat på din datakälla:

  1. Om du använder Cost Management-anslutningsappen i Power BI kontrollerar du parametrarna Billing Account ID och Number of Months för att säkerställa att de är korrekt inställda. Tänk på att gamla faktureringskonton kanske inte har data under de senaste månaderna.
  2. Om du använder FinOps-hubbar kontrollerar du lagringskontot för att se till att data fylls i i inmatningscontainern . Du bör se antingen en leverantörs - eller prenumerationsmapp . Använd följande avsnitt för att felsöka ytterligare.

FinOps-hubbar: Inmatningscontainern är tom

Om inmatningscontainern är tom öppnar du Data Factory-instansen i Data Factory Studio och väljer Hantera>upphovsutlösare> och kontrollerar att msexports_FileAdded utlösaren har startats. Annars startar du det.

Om utlösaren inte börjar med felet "resursprovidern är inte registrerad" öppnar du prenumerationen i Azure Portal och väljer sedan Inställningar>Resursproviders, väljer raden Microsoft.EventGrid och väljer sedan kommandot Registrera överst på sidan. Registreringen kan ta några minuter.

När registreringen är klar startar du msexports_FileAdded utlösaren igen.

När utlösaren har startats kör du alla anslutna Cost Management-exporter igen. Data bör matas in helt inom 10–20 minuter, beroende på kontots storlek.

Om problemet kvarstår kontrollerar du om Cost Management-exporter har konfigurerats med filpartitionering aktiverat. Om du upptäcker att den är inaktiverad aktiverar du den och kör exporterna igen.

Bekräfta att inmatningscontainern är ifylld och uppdatera dina rapporter eller andra anslutna verktyg.

FinOps-hubbar: Filer som är tillgängliga i inmatningscontainern

Om inmatningscontainern inte är tom kontrollerar du om du har parquet eller csv.gz filer genom att gå in i mapparna.

När du vet kontrollerar du att parametern FileType är inställd på eller .gz i Power BI-rapporten..parquet Mer information finns i Ansluta till dina data .

Om du använder ett annat verktyg kontrollerar du att det stöder den filtyp som du använder.


Power BI: Det gick inte att matcha fjärrnamnet: "<storage-account.dfs.core.windows.net>"

Anger att namnet på lagringskontot är felaktigt. Om du använder FinOps-hubbar kontrollerar du parametern StorageUrl från distributionen. Mer information finns i Ansluta till dina data .


Power BI: Vi kan inte konvertera värdet null till typen Logisk

Anger att parametern Faktureringskonto-ID är tom. Om du använder FinOps-hubbar anger du värdet till önskat faktureringskonto-ID. Om du inte har åtkomst till faktureringskontot eller inte vill inkludera åtagandeköp och återbetalningar anger du värdet till och öppnar CostDetails-frågan i den avancerade redigeraren och ändrar 2 till en 1.0 Den informerar rapporten om att inte läsa in faktiska/fakturerade kostnadsdata från Cost Management-anslutningsappen. Mer information finns i Ansluta till dina data .

Tillämpliga versioner: 0.1– 0.1.1 (fast i 0.2)


FinOps-hubbar: Vi kan inte konvertera värdet null till att skriva Tabell

Det här felet anger vanligtvis att data inte matades in i inmatningscontainern .

Om du precis har uppgraderat till FinOps Hubs 0.2 kan problemet bero på att Power BI-rapporten är gammal (från 0.1.x) eller att du inte använder FOCUS-exporter. Mer information finns i uppgraderingsguiden.

Mer felsökningssteg finns i Rapporter är tomma (inga data ).


Relaterat innehåll

Om du inte ser det fel du upplever går du igenom felsökningsguiden. Om du har några frågor kan du starta en diskussion eller skapa ett problem i GitHub.