Udostępnij przez

Rozwiązywanie typowych błędów zestawu narzędzi FinOps

W tym artykule opisano typowe błędy zestawu narzędzi FinOps i przedstawiono informacje o rozwiązaniach. Jeśli wystąpi błąd podczas korzystania z rozwiązań zestawu narzędzi FinOps, które nie są zrozumiałe lub nie można go rozwiązać, znajdź następujący kod błędu z krokami ograniczania ryzyka, aby rozwiązać ten problem.

Oto lista typowych kodów błędów z informacjami dotyczącymi ograniczania ryzyka.

Jeśli podane informacje nie rozwiążą problemu, wypróbuj przewodnik rozwiązywania problemów.


Dostęp do zasobu jest zabroniony

Ważność: Krytyczne

Ten błąd zazwyczaj oznacza, że konto, z którym masz połączenie, nie ma dostępu do zasobu, którego próbujesz użyć.

Środki zaradcze: Upewnij się, że używasz poprawnego konta w prawidłowej dzierżawie identyfikatora Entra firmy Microsoft.


Nie można zaktualizować właściwości konta

Ważność: Krytyczne

Ten błąd występuje zwykle podczas aktualizowania wdrożenia centrum zarządzania FinOps przy użyciu konfiguracji konta magazynu innej niż pierwotnie używana podczas tworzenia. Chociaż większość właściwości można zmieniać, istnieje kilka takich, które można ustawić tylko raz podczas tworzenia konta magazynu i których nie można potem zmienić. Jednym znanym przypadkiem tego dla ośrodków FinOps jest właściwość "requireInfrastructureEncryption". Jeśli ta właściwość została włączona lub wyłączona podczas pierwszego wdrożenia centrum FinOps, nie można jej zmienić. W takim przypadku zostanie wyświetlony następujący błąd:

Właściwość "requireInfrastructureEncryption" została określona w danych wejściowych, ale nie można jej zaktualizować, ponieważ jest tylko do odczytu.

Środki zaradcze: Jeśli nie zamierzasz zmienić tego ustawienia, upewnij się, czy konto magazynu jest skonfigurowane do używania szyfrowania infrastruktury i ponownie wdroż szablon centrum FinOps z taką samą wartością ustawienia szyfrowania (włączone lub wyłączone). Jeśli chcesz zmienić ustawienie, zalecamy wdrożenie nowego wystąpienia centrum FinOps, ponieważ będzie to wymagało ponownego wczytywania wszystkich danych.

Możesz spróbować usunąć istniejące konto magazynu i ponownie wdrożyć szablon ze zmienionym szyfrowaniem infrastruktury; jednak nie przetestowaliśmy tego dokładnie. Chociaż nie przewidujemy problemów, nie możemy potwierdzić, czy spowoduje to problemy.


BadHubVersion

Ważność: Krytyczne

Centra FinOps 0.2 nie działają. Uaktualnij do wersji 0.3 lub nowszej.

Środki zaradcze: Zaktualizuj do najnowszej wersji centrów FinOps.


Kolumna "id" w tabeli "Resources" zawiera zduplikowaną wartość

Ważność: Krytyczne

Jeśli wystąpi następujący błąd, oznacza to, że usługa Azure Resource Graph zwraca wiersze o tej samej wartości logicznej dla kolumny id . Może się tak zdarzyć, gdy wartości identyfikatora zasobu mają niespójną wielkość liter lub gdy kolejna kolumna jest rozszerzana w poprzek wierszy.

Kolumna "id" w tabeli "Resources" zawiera zduplikowaną wartość "{resource-id}" i nie jest dozwolona dla kolumn po jednej stronie relacji wiele-do-jednego lub kolumn, które są używane jako klucz podstawowy tabeli.

Środki zaradcze: upewnij się, że korzystasz z najnowszej wersji raportu. Zidentyfikuj przyczynę zduplikowanych wartości i zaktualizuj zapytanie, aby obejść zduplikowane wartości. Zgłoś również ten problem w usłudze GitHub , aby można go było rozwiązać w przyszłej wersji. Może to wymagać dodatkowych szczegółów lub spotkania w celu rozwiązania problemu z przyczyną błędu.


ConflictError

Ważność: Krytyczne

Może wystąpić wiele wystąpień tego błędu. Jedno znane wystąpienie jest wtedy, gdy usługa Key Vault zwraca następujący błąd:

Magazyn o tej samej nazwie już istnieje w stanie usunięcia. Musisz odzyskać lub przeczyścić istniejący magazyn kluczy. Aby uzyskać więcej informacji na temat miękkiego usuwania, kliknij ten link https://go.microsoft.com/fwlink/?linkid=2149745.

Zazwyczaj oznacza to, że wdrażasz w oparciu o stare wdrożenie, które zostało usunięte, ale usługa Key Vault przechowywała stare wystąpienie magazynu w stanie usuwania możliwego do odzyskania.

Zaradzanie: Aby rozwiązać problem, trwale usuń usunięty magazyn Key Vault w portalu Azure.

  1. Otwórz listę wystąpień usługi Key Vault w witrynie Azure Portal.
  2. Wybierz polecenie Zarządzaj usuniętymi magazynami na górze strony.
  3. Wybierz subskrypcję z listy rozwijanej.
  4. Sprawdź magazyny, które mają zostać usunięte.
  5. Wybierz pozycję Przeczyść w dolnej części okna wysuwanego.
  6. W oknie dialogowym z monitem o potwierdzenie wybierz Usuń.

Teraz możesz ponowić próbę wdrożenia.


KosztZakontraktowanyMniejszyNiżKosztEfektywny

Ważność: Ostrzeżenie

ContractedCost (na podstawie wynegocjowanych rabatów) jest mniejsza niż EffectiveCost (po rabatach na zobowiązania) w danych z usługi Cost Management. Nigdy nie powinno się tak zdarzyć, chyba że rabat za zobowiązanie zapewnia mniej rabatu niż istniejące wynegocjowane rabaty. Spowoduje to, że obliczenia oszczędności nie będą się dokładnie zgadzać.

Środki zaradcze: potwierdź ContractedUnitPrice, że dane dotyczące kosztów są zgodne z danymi dotyczącymi cen. Jeśli cena kontraktowa jest poprawna, prześlij wniosek o pomoc do zespołu Usługi Zarządzania Kosztami, aby potwierdzić, że x_EffectiveUnitPrice i EffectiveCost są poprawne. Jeśli są one poprawne, rozważ zwrócenie rabatu na zobowiązanie.


Polityka dostępu między dzierżawami nie umożliwia dostępu temu użytkownikowi

Ważność: główna

Jeśli wystąpi następujący błąd, oznacza to, że identyfikator Entra firmy Microsoft jest skonfigurowany tak, aby nie zezwalał użytkownikom z innych dzierżaw na logowanie się do bieżącej dzierżawy.

Komunikat: AADSTS500213: Zasady dostępu między dzierżawami zasobów nie zezwalają temu użytkownikowi na dostęp do tej dzierżawy.

Ten komunikat o błędzie nie jest związany z zestawem narzędzi FinOps.

Środki zaradcze: Sprawdź, czy jesteś zalogowany na właściwe konto i czy logowanie odbyło się przez katalog docelowy. Jeśli potrzebujesz dalszej pomocy, skontaktuj się z administratorem katalogu.


Błąd przetwarzania danych w DataExplorer

Ważność: Krytyczne

Eksploracja danych nie powiodła się. Nowe dane nie będą dostępne do raportowania.

Działania naprawcze: Przejrzyj komunikat o błędzie Eksploratora danych i rozwiąż problem. Ponownie wykonaj pozyskiwanie danych dla określonego folderu przy użyciu potoku ingestion_ExecuteETL w usłudze Azure Data Factory. Zgłoś nierozwiązane problemy pod adresem https://aka.ms/ftk/ideas.


Niepowodzenie mapowania danych w Data Explorer

Ważność: Krytyczne

Nie można utworzyć mapowania pobierania Eksploratora Danych dla określonej tabeli.

Środki zaradcze: Napraw błąd i ponownie uruchom pozyskiwanie dla określonej ścieżki folderu. Jeśli ten błąd będzie nadal wyświetlany, zgłoś problem pod adresem https://aka.ms/ftk/ideas.


DataExplorerIngestionTimeout

Ważność: Krytyczne

Upłynął limit czasu przetwarzania danych w Eksploratorze Danych po 2 godzinach oczekiwania na dostępną wydajność.

Mitigacja: Uruchom ponownie ten potok, aby spróbować ponownie zaimportować dane. Jeśli ten błąd będzie nadal wyświetlany, zgłoś problem pod adresem https://aka.ms/ftk/ideas.


Niepowodzenie usuwania w Data Explorer po przesłaniu danych

Ważność: Krytyczne

Czyszczenie po pozyskiwaniu danych w Eksploratorze danych (usuwanie segmentów z tabeli końcowej) nie powiodło się. Dane z poprzedniego pozyskiwania mogą być obecne w raportowaniu, co może spowodować zduplikowane i niedokładne koszty.

Działania naprawcze: Przejrzyj komunikat o błędzie Eksploratora danych i rozwiąż problem. Ponownie uruchom przetwarzanie danych dla określonego folderu przy użyciu potoku ingestion_ExecuteETL w usłudze Azure Data Factory. Zgłoś nierozwiązane problemy pod adresem https://aka.ms/ftk/ideas.


DataExplorerPreIngestionDropFailed

Ważność: Krytyczne

Wstępne czyszczenie danych przed ich pobraniem w Eksploratorze Danych (usunięcie rozciągłości z nieprzetworzonej tabeli) nie powiodło się. Importowanie nie zostało ukończone.

Działania naprawcze: Przejrzyj komunikat o błędzie Eksploratora danych i rozwiąż problem. Ponownie uruchom przetwarzanie danych dla określonego folderu przy użyciu potoku ingestion_ExecuteETL w usłudze Azure Data Factory. Zgłoś nierozwiązane problemy pod adresem https://aka.ms/ftk/ideas.


OcenaWynikuWdrażaniaNiepowodzenie

Ważność: główna

Usługa FinOps Hubs 0.8 ustawia ustawienie zabezpieczeń "trustedExternaltenants" w usłudze Azure Data Explorer, aby ograniczyć dostęp do klastra tylko dla określonych, zaufanych dzierżaw. To ustawienie można ustawić dla pierwszego wdrożenia, ale nie można go ustawić ponownie w drugim wdrożeniu. Jeśli spróbujesz ponownie wdrożyć koncentratory FinOps 0.8 oprócz istniejącego wdrożenia w wersji 0.8, może zostać wyświetlony następujący błąd:

Dane wyjściowe szablonu „clusterUri” są nieprawidłowe: właściwość wyrażenia języka „uri” nie istnieje, dostępne właściwości to „trustedExternalTenants”, „enableStreamingIngest”, „publicNetworkAccess”, „enableAutoStop”, „provisioningState”.

Obserwujemy zespół usługi Azure Data Explorer, aby zidentyfikować prawidłowe rozwiązanie.

Działania łagodzące: Wdrażanie centrów FinOps w wersji 0.9. To ustawienie zostało usunięte z szablonu.


DaneEksportuNieZnalezione

Ważność: Krytyczne

Nie znaleziono eksportów w wskazanej ścieżce przechowywania.

Środki zaradcze: Upewnij się, że utworzono i skonfigurowano eksport systemu Cost Management przy użyciu odpowiedniego konta magazynu, kontenera oraz ścieżki magazynu. Po utworzeniu wybierz pozycję "Uruchom teraz", aby rozpocząć proces eksportowania. Eksportowanie może potrwać od 15 do 30 minut w zależności od rozmiaru konta. Jeśli zamierzasz używać centrów FinOps, popraw adres URL magazynu, aby wskazać kontener "pozyskiwanie". Aby uzyskać pełny adres URL, odwołaj się do storageUrlForPowerBI danych wyjściowych z wdrożenia centrum FinOps.


TypEksportuNieZdefiniowany

Ważność: Krytyczne

Ten typ zakresu rozliczeniowego nie jest obsługiwany przez eksporty zarządzane.

Środki zaradcze: Usuń nieobsługiwany zakres rozliczeniowy z settings.json, upewnij się, że zakres rozliczeniowy jest obsługiwany przez centra FinOps i ręcznie utwórz nowe eksporty zarządzania kosztami dla zakresu rozliczeniowego.


Typ eksportu nieobsługiwany

Ważność: Krytyczne

Umowy klienta firmy Microsoft nie są obsługiwane w przypadku eksportów zarządzanych.

Środki zaradcze: Usuń zakres rozliczeniowy UMOWY MCA z settings.json i ręcznie utwórz nowe eksporty usługi Cost Management dla każdego profilu rozliczeniowego MCA dla kosztu FOKUS, arkusza cen, szczegółów rezerwacji, transakcji rezerwacji i zaleceń dotyczących rezerwacji.


HubDataNotFound

Ważność: Krytyczne

Nie znaleziono danych węzła FinOps na określonym koncie przechowywania.

Łagodzenie: Ten błąd zakłada, że nawiązujesz połączenie z wdrożeniem centrum FinOps. Jeśli używasz nieprzetworzonych eksportów, popraw ścieżkę przechowywania, aby nie odwoływać się do kontenera ingestion. Upewnij się, że:

  1. Adres URL magazynu powinien być zgodny z danymi wyjściowymi StorageUrlForPowerBI wdrożenia centrum FinOps.
  2. Eksporty usługi Cost Management należy skonfigurować tak, aby wskazywały na to samo konto magazynu z użyciem kontenera msexports.
  3. Eksporty usługi Cost Management powinny pokazywać udany eksport w historii operacji.
  4. Wyzwalacze w centrum FinOps w fabryce danych powinny być uruchomione.
  5. Potoki danych fabryki w centrum FinOps powinny odnieść sukces.

Aby uzyskać więcej szczegółów i kroków debugowania, zobacz Weryfikowanie wdrożenia centrum FinOps.


PlikiDoWczytaniaNieZnalezione

Ważność: Krytyczne

Nie można zlokalizować plików Parquet do wczytania z określonej ścieżki folderu.

Mitigacja: Upewnij się, że ścieżka folderu jest pełną ścieżką, w tym kontenerem danych wejściowych, i że nie zaczyna się ani nie kończy ukośnikiem (/). Skopiuj ścieżkę z ostatniego pomyślnego uruchomienia potoku ingestion_ExecuteETL .


BłądUsługiWewnętrznej

Usługa Microsoft Fabric Real-Time Intelligence może zwrócić kod błędu "InternalServiceError (520-UnknownError)" podczas wczytywania danych. Szczegółowy komunikat o błędzie może powiedzieć:

Klient Kusto nie wysłał żądania do usługi: "Nie można odczytać danych z połączenia transportowego: istniejące połączenie zostało wymuszone przez hosta zdalnego". `

Dokładna przyczyna tego błędu jest nieznana. Jeśli go doświadczysz, prześlij wniosek o pomoc techniczną w usłudze Microsoft Fabric, aby dokładniej zbadać problem.

Środki zaradcze: jako obejście problemu, zmień minimalne zużycie dla eventhouse Fabric na Średni (18 jednostek CUs), odczekaj 30 minut, i ponownie uruchom potok ingestion_ExecuteETL, dla tego zestawu danych i miesiąca. Aby dowiedzieć się więcej o minimalnym zużyciu, zobacz Minimalne zużycie w omówieniu magazynu zdarzeń.


NiepoprawnyEfektywnyKoszt

Ważność: główna

Od listopada 2024 r. usługa Cost Management ma znaną usterkę polegającą na tym, że zakupy planu oszczędnościowego są śledzone wewnętrznie jako koszty rzeczywiste i amortyzowane. W związku z tym FOCUS obejmuje zakupy planu oszczędnościowego w obliczeniach dla EffectiveCost, co prowadzi do nieprawidłowych danych liczbowych w raportach zestawu narzędzi FinOps.

Działania naprawcze: Prześlij wniosek o pomoc techniczną do zespołu Microsoft Cost Management, załączając szczegółowe informacje na temat problemu, aby rozwiązać dane źródłowe. Od listopada 2024 r. zespół zdaje sobie sprawę z problemu, ale poprawka nie została jeszcze priorytetowa. W międzyczasie zaktualizuj FinOps toolkit do wersji 0.7, który zawiera obejście dla hubów FinOps i raportów Power BI opartych na danych magazynowych.


Nieprawidłowy Kontener Eksportu

Ważność: Krytyczne

Ten plik wygląda na to, że może zostać wyeksportowany z usługi Cost Management, ale nie znajduje się on w poprawnym kontenerze.

Mitigacja: Zaktualizuj eksport Cost Management, aby wskazywał na kontener 'msexports'. Kontener "pozyskiwania" jest używany tylko do wykonywania zapytań dotyczących pozyskanych danych kosztów.


NiepoprawnaWersjaEksportu

Ważność: Krytyczne

Centra FinOps wymagają eksportu kosztów FOCUS, ale ten plik wygląda jak starszy eksport usługi Cost Management.

Środki zaradcze: Utwórz nowy eksport usługi Cost Management dla kosztów FOCUS i zatrzymaj bieżący eksport lub zmień jego lokalizację na inny kontener magazynowy.


NieprawidłowaWersjaHub

Ważność: Krytyczne

Centra FinOps 0.1.1 i starsze nie działają z raportem Power BI dotyczący pozyskiwania danych.

Środki zaradcze: uaktualnij do najnowszej wersji FinOps hubs lub pobierz raporty Power BI z wersji 0.1.1.


NieprawidłowyScopeId

Ważność: informacyjna

Podana ścieżka eksportu nie jest prawidłowym identyfikatorem zakresu. Centra FinOps oczekują, że ścieżka eksportu będzie identyfikatorem zasobu platformy Azure, który został utworzony dla danego obszaru w celu uproszczenia zarządzania. Nie powinno to powodować błędów, ale może spowodować mylące wyniki raportów związanych z zakresem.

Środki zaradcze: Zaktualizuj ścieżkę eksportu usługi Cost Management, aby użyć pełnego identyfikatora zasobu platformy Azure dotyczacego zakresu.


LegacyFocusVersion

Ważność: informacyjna

Ten kod błędu jest wyświetlany, gdy pozyskane dane używają starszej wersji programu FOCUS. W przypadku znalezienia w kolumnie x_SourceChanges kod jest tylko informacyjny. Kiedy jest pokazywane w raportach magazynowych Power BI, gdy zapytanie o Koszty nie ładuje się, oznacza to, że parametr Przestarzałe: Wykonywanie dodatkowych optymalizacji zapytań jest wyłączony.

Centra FinOps konwertują dane do najnowszej wersji FOCUS, więc nie powinno to powodować problemu; jednak proces modernizacji nie może uwzględniać wszystkich scenariuszy i może doprowadzić do nieoczekiwanych rezultatów w niektórych przypadkach. Sprawdź dokumentację, aby zapoznać się ze znanymi problemami.

Środki zaradcze: Istnieje kilka sposobów ograniczenia tego komunikatu, w zależności od tego, którego narzędzia używasz.

Jeżeli korzystasz z centrów FinOps z Eksploratorem danych i widzisz to w x_SourceChanges kolumnie tabeli Koszty lub w powiązanych funkcjach, zaktualizuj eksporty kosztów w usłudze Cost Management, aby używać najnowszej wersji FOCUS. Podczas pozyskiwania danych przez Eksploratora Danych wszelkie dane zostaną scalone i nie trzeba wprowadzać żadnych dodatkowych zmian.

W przypadku korzystania z raportów magazynu i wyświetlania tego w kolumnie x_SourceChanges zapytania o Koszty, ten komunikat jest ostrzeżeniem, że ta wersja FOCUS zostanie usunięta w przyszłej aktualizacji. Chociaż można bezpiecznie zignorować ten komunikat, będzie on wymagał aktualizacji w przyszłej wersji. Aby uniknąć tego komunikatu, zaktualizuj eksporty usługi Cost Management do najnowszej wersji fokusu, usuń lub przenieś wszystkie starsze dane przy użyciu starszej wersji fokusu i ponownie wyekseksportuj dane historyczne. Jeśli korzystasz z centrów FinOps, usuń lub przenieś dane poza kontener ingestji. Jeśli hostujesz własne eksporty w magazynie, zmień parametr Magazynu URL na inną ścieżkę folderu, który nie zawiera starszych wersji FOCUS.

Od zestawu narzędzi FinOps 0.7 obsługa starszych wersji FOCUS została wycofana w celu zwiększenia wydajności i skalowalności. Zalecamy zaktualizowanie do najnowszej wersji FOCUS i ponowne eksportowanie danych, aby poprawić Twoje doświadczenie. Ustaw parametr Deprecated: Perform Extra Query Optimizations na TRUE, aby zapewnić obsługę starszych wersji FOCUS, i ustaw na FALSE, aby przyspieszyć działanie oraz obsłużyć większe zestawy danych, obejmujące więcej aspektów kosztowych lub czasowych. Od wersji 0.7 ten parametr jest domyślnie włączony w celu zapewnienia zgodności z poprzednimi wersjami. W zestawie narzędzi FinOps w wersji 0.8 będzie ona domyślnie wyłączona, ale nadal dostępna dla zgodności z poprzednimi wersjami do czerwca 2025 r. lub później. Jeśli nie możesz przenieść się ze starych wersji FOCUS lub chcesz uzyskać najlepszą wydajność i obsługę większych kont lub dłuższych okresów czasu, zalecamy korzystanie z hubów FinOps z Eksploratorem Danych.


KosztListyMniejszyNiżKosztKontraktowy

Ważność: Ostrzeżenie

ListCost (na podstawie publicznych cen detalicznych) jest mniejsze niż ContractedCost (na podstawie wynegocjowanych rabatów) w danych dotyczących zarządzania kosztami. To nigdy nie powinno się zdarzyć. Spowoduje to, że obliczenia oszczędności nie będą się dokładnie zgadzać.

Środki zaradcze: potwierdź ListUnitPrice, że dane dotyczące kosztów są zgodne z danymi dotyczącymi cen. Jeśli cena katalogowa jest poprawna, złóż wniosek o pomoc techniczną do zespołu Cost Management, aby potwierdzić, że zarówno ListUnitPrice, jak i ContractedUnitPrice są poprawne, i wyjaśnić, dlaczego cena po negocjowanych rabatach byłaby wyższa niż ogólnodostępne, detaliczne stawki.


WczytywanieManifestuNiepowiodłoSię

Ważność: Krytyczne

Pipeline centrum FinOps msexports_ExecuteETL nie udało się odczytać pliku manifestu usługi Cost Management.

Działania łagodzące:

  1. Jeśli błąd wystąpił w działającym centrum, gdy nie dokonano żadnych zmian w centrum ani w eksporcie, to możliwe, że usługa "Cost Management" zmieniła schemat manifestu dla istniejącej wersji interfejsu API.
  2. Jeśli po utworzeniu nowego lub zmianie istniejącego eksportu wystąpił błąd, wersja eksportu interfejsu API może używać nowego nieobsługiwanego schematu manifestu.
  3. Jeśli wystąpił błąd po wdrożeniu koncentratora (początkowa instalacja lub uaktualnienie), wdrożenie mogło zakończyć się niepowodzeniem lub wystąpiła usterka w potoku.

Aby potwierdzić schemat manifestu (#1) lub wersję interfejsu API (#2):

  1. Otwórz konto magazynu Hub w portalu Azure lub Eksploratorze usługi Storage.
  2. Jeśli w portalu Azure, to przejdź do przeglądarki Storage w menu.
  3. Wybierz kontener msexports.
  4. Przejdź w dół hierarchii plików dla eksportu z problemem (zobacz lokalizację manifestu w komunikacie o błędzie).
  5. Znajdź plik manifest.json i wybierz menu (⋯), a następnie wybierz pozycję Wyświetl/edytuj.
  6. Zidentyfikuj następujące właściwości: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Upewnij się, że są one ustawione na następujące obsługiwane wartości:
    • resourceId może być dowolnym identyfikatorem zakresu i dowolną nazwą eksportu, ale musi istnieć z typem zasobu "Microsoft.CostManagement/export". Wielkość liter nie jest rozróżniana.
    • typ musi istnieć, ale nie powinien zakończyć się niepowodzeniem z powodu tego błędu dla żadnej wartości innej niż null.
    • DataVersion musi istnieć, ale nie powinien wywoływać tego błędu dla jakiejkolwiek wartości niebędącej null.
    • Usługa apiVersion nie jest używana jawnie, ale może oznaczać zmiany schematu manifestu. Aby uzyskać szczegółowe informacje, zobacz obsługiwane wersje interfejsu API.
  8. Jeśli używasz nowszej wersji interfejsu API:
    1. Aby śledzić dodawanie obsługi nowej wersji interfejsu API, utwórz problem z żądaniem zmiany w usłudze GitHub.
    2. Usuń eksport w usłudze Cost Management.
    3. Utwórz eksport przy użyciu polecenia New-FinOpsCostExport PowerShell przy użyciu obsługiwanej wersji interfejsu API.

      Napiwek

      Jeśli uważasz się za użytkownika zaawansowanego, możesz spróbować zaktualizować potok samodzielnie, aby uzyskać jak najszybsze rozwiązanie. W tym celu otwórz usługę Data Factory, przejdź do pozycji Tworzenie > potoków > msexports_ExecuteETL, a następnie wybierz odpowiednie działania "Ustaw" i zaktualizuj właściwość Wartośćpotrzebami. Jeśli to zrobisz, nie musisz ponownie tworzyć eksportu przy użyciu starszej wersji. Proszę nadal zgłaszać problem i rozważ udostępnienie nowego kodu JSON z ikony {} w prawym górnym rogu projektanta potoku.

  9. Jeśli zauważysz, że właściwości uległy zmianie dla obsługiwanej wersji interfejsu API:
    1. Aby śledzić zmianę powodującą przełamanie zgodności, utwórz zgłoszenie dotyczące żądania zmiany w usłudze GitHub. Uwzględnij typ, dataVersion i apiVersion z pliku manifest.json.
    2. Złóż wniosek o pomoc techniczną do działu zarządzania kosztami, aby zażądać cofnięcia ich zmiany, ponieważ powoduje problemy dla wszystkich użytkowników korzystających z centrów FinOps i innych rozwiązań niestandardowych. Dołącz następujące szczegóły, aby pomóc zespołowi pomocy technicznej usługi Cost Management zidentyfikować problem w swoim systemie. Cost Management nie ma kontekstu dotyczącego centrów FinOps, więc powinieneś skupić się na szczegółach dotyczących funkcjonalności zarządzania kosztami. Oto przykład:

      Używam eksportów usługi Cost Management w celu ściągnięcia danych kosztów do usługi ADLS. Mam potok danych ADF, który przetwarza dane, kiedy zapisywane są pliki manifestu. Mój potok został utworzony na podstawie wersji interfejsu API <your-supported-api-version>, która oczekuje, że właściwości exportConfig.resourceId, exportConfig.type i exportConfig.dataVersion będą dostarczane spójnie. Zauważyłem, że te pliki nie są uwzględniane w pliku manifestu dla tej wersji API dla mojego eksportu uruchomionego na <your-export-date>. Moim oczekiwaniem jest to, że plik manifestu nigdy nie powinien ulec zmianie dla istniejącej wersji interfejsu API. Czy można przywrócić te zmiany?

      Aby ułatwić rozwiązywanie problemów, oto mój plik manifestu: {your-manifest-json}

Jeśli właściwości manifestu wyglądają dobrze i było to nowe lub zaktualizowane wystąpienie hubu FinOps, potwierdź wdrożenie:

  1. Otwórz grupę zasobów centrum w witrynie Azure Portal.
  2. Wybierz pozycję Ustawienia>Wdrożenia w menu po lewej stronie.
  3. Upewnij się, że wszystkie wdrożenia zakończyły się pomyślnie. Szukaj w szczególności następujących nazw wdrożeń:
    • główny
    • węzeł
    • dataFactoryResources
    • magazyn
    • keyVault (Magazyn kluczy)
  4. Jeśli jakiekolwiek wdrożenia nie powiodły się, przejrzyj komunikat o błędzie, aby ustalić, czy jest to coś, co można rozwiązać samodzielnie (na przykład konflikt nazw, naruszenie zasad możliwych do naprawienia).
  5. Jeśli błąd wydaje się przejściowy, spróbuj wdrożyć ponownie.
  6. Jeśli błąd będzie się powtarzał, utwórz dyskusję, aby sprawdzić, czy ktoś inny również napotyka ten sam problem lub zna możliwe obejście (zwłaszcza w przypadku zagadnień dotyczących polityki).
  7. Jeśli błąd jest wyraźnie usterką lub luką funkcji, utwórz problem z usterką lub żądaniem funkcji w usłudze GitHub.

Staramy się reagować na problemy i dyskusje w ciągu dwóch dni roboczych.


BrakującyKosztZakontraktowany

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy ContractedCost ma wartość null lub 0 i EffectiveCost jest większy niż 0. Błąd wskazuje, że usługa Microsoft Cost Management nie uwzględniła ContractedCost określonych wierszy, co oznacza, że nie można obliczyć oszczędności.

Łagodzenie: Jako obejście problemu brakujących danych, raporty zestawu narzędzi FinOps kopiują EffectiveCost do ContractedCost kolumny dla wierszy oflagowanych z tym kodem błędu. Oszczędności nie są dostępne dla tych rekordów.

Aby obliczyć pełne oszczędności, możesz połączyć dane dotyczące kosztów i użycia wraz z cenami. Aby uzyskać więcej informacji, zobacz problem nr 873.


Brak skontraktowanej ceny jednostkowej

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy ContractedUnitPrice ma wartość null lub 0 i EffectiveUnitPrice jest większy niż 0. Błąd wskazuje, że usługa Microsoft Cost Management nie uwzględniła ContractedUnitPrice określonych wierszy, co oznacza, że nie można obliczyć oszczędności.

Łagodzenie: Jako obejście problemu brakujących danych, raporty zestawu narzędzi FinOps kopiują EffectiveUnitPrice do ContractedUnitPrice kolumny dla wierszy oflagowanych z tym kodem błędu. Oszczędności nie są dostępne dla tych rekordów.

Aby obliczyć pełne oszczędności, możesz połączyć dane dotyczące kosztów i użycia wraz z cenami. Aby uzyskać więcej informacji, zobacz problem nr 873.


MissingListCost

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy ListCost ma wartość null lub 0 i ContractedCost jest większy niż 0. Błąd wskazuje, że usługa Microsoft Cost Management nie uwzględniła ListCost określonych wierszy, co oznacza, że nie można obliczyć oszczędności.

Łagodzenie: Jako obejście problemu brakujących danych, raporty zestawu narzędzi FinOps kopiują ContractedCost do ListCost kolumny dla wierszy oflagowanych z tym kodem błędu. Oszczędności nie są dostępne dla tych rekordów.

Aby obliczyć pełne oszczędności, możesz połączyć dane dotyczące kosztów i użycia wraz z cenami. Aby uzyskać więcej informacji, zobacz problem nr 873.


BrakującaCenaJednostkowaNaLiście

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy ListUnitPrice ma wartość null lub 0 i ContractedUnitPrice jest większy niż 0. Błąd wskazuje, że usługa Microsoft Cost Management nie uwzględniła ListUnitPrice określonych wierszy, co oznacza, że nie można obliczyć oszczędności.

Łagodzenie: Jako obejście problemu brakujących danych, raporty zestawu narzędzi FinOps kopiują ContractedUnitPrice do ListUnitPrice kolumny dla wierszy oflagowanych z tym kodem błędu. Oszczędności nie są dostępne dla tych rekordów.

Aby obliczyć pełne oszczędności, możesz połączyć dane dotyczące kosztów i użycia wraz z cenami. Aby uzyskać więcej informacji, zobacz problem nr 873.


BrakNazwyDostawcy

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy ProviderName ma wartość null. Błąd wskazuje, że dostawca zestawu danych (na przykład Microsoft Cost Management) nie zawierał ProviderName wartości dla określonych wierszy.

Środki zaradcze: Jako obejście brakujących danych, raporty zestawu narzędzi FinOps próbują zidentyfikować dostawcę na podstawie dostępnych kolumn.


Kwerenda '...' odwołuje się do innych zapytań lub kroków

Stopień: Niewielki

Źródło tego błędu jest nieznane. Ten błąd może zostać wyświetlony losowo podczas odświeżania danych usługi Power BI.

Środki zaradcze: jeśli wystąpi ten błąd, wybierz ponownie Zastosuj zmianę.

Ten błąd został zgłoszony tylko w raportach przechowywania. Jeśli masz długi czas odświeżania danych lub często występuje ten błąd, rozważ przełączenie do centrów FinOps za pomocą Eksploratora danych. Eksplorator danych używa raportów KQL, które nie wymagają planowania ani odświeżania przyrostowego. Dane są pobierane po otwarciu raportu, dlatego raporty zawsze wyświetlają najnowsze dane.


WyjątekOdmowyDostępuDoZasobu

Ważność: główna

Power BI: został zgłoszony wyjątek typu "Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException"

Wskazuje, że konto ładujące dane w usłudze Power BI nie ma roli Czytelnik danych obiektów blob Storage. W usłudze Power BI przypisz tę rolę do konta ładującego dane.


Rozmiar ładunku odpowiedzi to... i przekroczył limit

Ważność: główna

Zapytania usługi Azure Resource Graph w raportach zarządzania i optymalizacji obciążenia usługi Power BI mogą zwracać błąd podobny do następującego:

Błąd OLE DB lub ODBC: [Expression.Error] Podaj poniższe informacje podczas prośby o wsparcie: znacznik czasu = {timestamp}, correlationId = {guid}. Szczegóły: Rozmiar ładunku odpowiedzi to {number} i przekroczył limit 16777216 bajtów. Rozważ zapytania o mniejsze ilości danych naraz i, w razie potrzeby, wykonywanie wywołań stronicowanych.

Ten błąd oznacza, że masz więcej zasobów niż są obsługiwane w niefiltrowanym zapytaniu usługi Resource Graph. Dzieje się tak, ponieważ raporty zestawu narzędzi FinOps są przeznaczone do wyświetlania szczegółów na poziomie zasobów i nie są agregowane. Są one przeznaczone dla środowisk małych i średnich i nie są przeznaczone do obsługi organizacji z milionami zasobów.

Złagodzenie skutków: jeśli wystąpi ten błąd, masz kilka opcji:

  • Usuń kolumny, które nie są niezbędne do Twoich potrzeb.
  • Przefiltruj zapytanie, aby zwrócić mniej zasobów, uwzględniając to, co jest dla Ciebie najważniejsze (np. subskrypcje, tagi).
  • Wyłącz zapytanie, aby nie blokowało uruchamiania innych zapytań.

AktualizacjaPrzypisaniaRólNiedozwolona

Stopień: Niewielki

Jeśli centra FinOps zostały usunięte i próbujesz ponownie wdrożyć je przy użyciu tych samych wartości, w tym nazwy tożsamości zarządzanej, może wystąpić następujący znany problem:

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

Złagodzenie: aby rozwiązać tę kwestię, musisz usunąć nieaktualną tożsamość:

  • Przejdź do konta magazynu i wybierz pozycję Kontrola dostępu (IAM) w menu.
  • Wybierz zakładkę Przypisania roli.
  • Znajdź wszystkie przypisania ról o "nieznanej" tożsamości i usuń je.

Przypisanie roli już istnieje

Stopień: Niewielki

Podczas uaktualniania centrów FinOps z jednej wersji do innej może wystąpić następujący błąd, jeśli przypisania ról utworzone w poprzednim wdrożeniu nadal istnieją:

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

Prawdopodobnie tożsamość zarządzana została wyraźnie usunięta bez najpierw usunięcia wszystkich przypisań ról.

Środki zaradcze: Aby rozwiązać ten problem, usuń osierocone przypisania ról w portalu Azure.

  • Przejdź do grupy zasobów lub zasobu, którego dotyczy problem (na przykład klastra usługi Data Explorer).
  • Wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) w menu.
  • Wybierz zakładkę Przypisania roli.
  • Znajdź wszystkie przypisania ról z nieznaną tożsamością i usuń je.

Nie udało się załadować schematu

Ważność: Krytyczne

W centrum FinOps potoku msexports_ETL_ingestion nie można załadować pliku schematu.

Mitigacja: Przejrzyj komunikat o błędzie, aby zanotować typ i wersję zestawu danych, które są sformatowane za pomocą podkreślenia (na przykład <type>_<version> lub FocusCost_1.0). Upewnij się, że zestaw danych i typ są obsługiwane przez wdrożoną wersję centrów FinOps. Aby uzyskać szczegółowe informacje, zobacz obsługiwane zestawy danych.


SchemaNotFound

Ważność: Krytyczne

Centrum FinOps nie mogło odnaleźć pliku mapowania schematu dla potoku msexports_ExecuteETL wyeksportowanego zestawu danych.

Łagodzenie: Upewnij się, że obsługiwany jest typ i wersja zestawu danych. Aby uzyskać szczegółowe informacje, zobacz obsługiwane zestawy danych. Jeśli zestaw danych jest obsługiwany, potwierdź wersję huba za pomocą raportu o pozyskiwaniu danych.

Aby dodać obsługę innego zestawu danych, utwórz niestandardowy plik mapowania i zapisz go w pliku config/schemas/<dataset-type>_<dataset-version>.json. Wartości <dataset-type><dataset-version> są bardzo zgodne z wartościami używanymi w usłudze Cost Management. Aby zidentyfikować typ danych dla każdej kolumny, użyj istniejącego pliku schematu jako szablonu. Niektóre zestawy danych mają różne schematy dla Umowy EA i umowy z Klientem Microsoft (MCA). Nie można ich zidentyfikować za pomocą tych atrybutów i może spowodować problem, jeśli masz oba typy kont. Pracujemy nad dodaniem zestawów danych oraz uwzględnieniem różnic między umowami EA i MCA poprzez dostosowanie do standardu FOCUS.


Adres URL magazynu importu nie pasuje do żadnych eksportów

Ważność: główna

Jeśli występuje to w raportach zestawu narzędzi FinOps w wersji 0.8, błąd jest spowodowany odwołaniem do parametru, który nie istnieje.

Środki zaradcze: Zostało to naprawione w wersji 0.9 zestawu narzędzi FinOps. Zaktualizuj do najnowszej wersji, aby zastosować poprawkę. Jeśli musisz zastosować poprawkę bezpośrednio do raportów w wersji 0.8, zmodyfikuj funkcję ftk_DemoFilter w edytorze zaawansowanym i zmień zawartość na : () => "". Zapisz, a następnie zamknij i zastosuj wszystkie zmiany.


NieznanyPlikEksportu

Ważność: informacyjna

Plik w magazynie centrum nie wygląda tak, jakby został wyeksportowany z usługi Cost Management. Plik jest ignorowany.

Mitygacja: kontener msexports jest przeznaczony tylko dla eksportów Cost Management. Przenieś inne pliki do innego kontenera magazynowego.


NieznanaWersjaOstrości

Ważność: informacyjna

Ten kod błędu jest wyświetlany w kolumnie x_SourceChanges , gdy nie można zidentyfikować wersji FOKUS.

Zalecenia: sprawdź, czy zestaw danych FOCUS korzysta z obsługiwanej wersji FOCUS. Zgłoś ten problem z anonimową próbką danych na https://aka.ms/ftk/ideas do dalszego zbadania.


UnknownHubVersion

Ważność: Krytyczne

Nie można zidentyfikować wersji centrów FinOps z pliku ustawień. Sprawdź, czy ustawienia są poprawne. Huby FinOps 0.1.1 i starsze nie działają z tym raportem Power BI.

Środki zaradcze: zaktualizuj do najnowszej wersji centrów FinOps lub pobierz raporty Power BI z zestawu narzędzi FinOps w wersji 0.1.1.


Nieobsługiwany typ pliku eksportu

Ważność: Krytyczne

Nie można pozyskać określonego pliku eksportu, ponieważ typ pliku nie jest obsługiwany.

Zabezpieczenie: Przekonwertuj plik na obsługiwany format pliku przed dodaniem do kontenera msexports lub dodaj obsługę konwersji nowego typu pliku do linii przetwarzania msexports_ETL_ingestion.


Nieobsługiwany typ eksportu

Ważność: Ostrzeżenie

Manifest eksportu w magazynie centrum wskazuje, że eksport był przeznaczony dla nieobsługiwanego zestawu danych. Dane eksportowane są zgłaszane jako błędy przetwarzania danych.

Środki zaradcze: Utwórz nowy eksport usługi Cost Management dla kosztów FOCUS i zatrzymaj bieżący eksport lub zmień jego lokalizację na inny kontener magazynowy.


Dostawca zasobów {name} nie jest zarejestrowany w subskrypcji {guid}

Stopień: Niewielki

Otwórz subskrypcję w witrynie Azure Portal, a następnie wybierz pozycję Ustawienia>Dostawcy zasobów, wybierz wiersz dostawcy zasobów (na przykład Microsoft.EventGrid), a następnie wybierz polecenie Zarejestruj w górnej części strony. Rejestracja może potrwać kilka minut.


x_PricingSubcategory pokazuje identyfikator rabatu za zobowiązanie

Eksporty usługi Cost Management przed 28 lutego 2024 r. zawierały usterkę polegającą na tym, że x_PricingSubcategory została niepoprawnie ustawiona dla zatwierdzonego użycia. Powinno się spodziewać wartości takich jak Committed Spend i Committed Usage. Zamiast tego mogą zostać wyświetlone następujące wartości:

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

Jeśli zobaczysz te wartości, ponownie wyeksportuj dane kosztów dla tego miesiąca. Jeśli musisz wyeksportować dane dla starszego miesiąca, który jest niedostępny, skontaktuj się z pomocą techniczną, aby poprosić o wyeksportowanie danych, aby rozwiązać problem z jakością danych z poprzednich przebiegów eksportu.


Power BI: w raportach brakuje danych dla określonych dat

Jeśli w raporcie brakuje wszystkich danych dla jednego lub więcej miesięcy, sprawdź parametry Liczba Miesięcy, RangeStart i RangeEnd, aby upewnić się, że dane nie są filtrowane.

Aby sprawdzić parametry, wybierz Przekształć dane>Edytuj parametry na wstążce lub wybierz indywidualne parametry w folderze 🛠Ustawienia w oknie edytora zapytań.

  • Jeśli chcesz zawsze wyświetlać określoną liczbę ostatnich miesięcy, ustaw Liczba Miesięcy na liczbę zamkniętych (ukończonych) miesięcy. Bieżący miesiąc jest dodatkowym miesiącem oprócz zamkniętej liczby miesięcy.
  • Jeśli chcesz mieć stały zakres dat, który nie zmienia się w czasie (na przykład raportowanie roku obrachunkowego), ustaw wartości RangeStart i RangeEnd.
  • Jeśli chcesz zgłosić wszystkie dostępne dane, upewnij się, że wszystkie trzy parametry daty są puste.

Aby uzyskać więcej informacji, zobacz Konfigurowanie pierwszego raportu.


Power BI: Raporty są puste (brak danych)

Jeśli nie widzisz żadnych danych w usłudze Power BI lub innych raportach lub narzędziach, spróbuj wykonać następujące czynności na podstawie źródła danych:

  1. Jeśli używasz łącznika Zarządzanie Kosztami w usłudze Power BI, sprawdź parametry Billing Account ID i Number of Months, aby upewnić się, że są ustawione poprawnie. Pamiętaj, że stare konta rozliczeniowe mogą nie mieć danych w ostatnich miesiącach.
  2. Jeśli używasz centrów FinOps, sprawdź konto magazynowe, aby upewnić się, że dane są zawarte w kontenerze przyjmowania danych. Powinieneś zobaczyć folder dostawców lub subskrypcji. Aby rozwiązać problemy, skorzystaj z poniższych sekcji.

Centra operacyjne FinOps: kontener ładowania jest pusty

Jeśli kontener przetwarzania jest pusty, otwórz wystąpienie usługi Data Factory w narzędziu Data Factory Studio i wybierz Zarządzaj>Autor>Wyzwalacze i sprawdź, czy wyzwalacz msexports_FileAdded został uruchomiony. Jeśli nie, uruchom go.

Jeśli uruchomienie wyzwalacza nie powiedzie się z powodu błędu "Dostawca zasobów nie jest zarejestrowany", otwórz subskrypcję w witrynie Azure Portal, a następnie wybierz pozycję > zasobów, wybierz wiersz Microsoft.EventGrid, a następnie wybierz polecenie Zarejestruj w górnej części strony. Rejestracja może potrwać kilka minut.

Po zakończeniu rejestracji uruchom ponownie wyzwalacz msexports_FileAdded .

Po uruchomieniu wyzwalacza uruchom ponownie wszystkie połączone eksporty usługi Cost Management. Dane powinny być w pełni pozyskiwane w ciągu 10–20 minut, w zależności od rozmiaru konta.

Jeśli problem będzie się powtarzać, sprawdź, czy eksporty usługi Cost Management są skonfigurowane z włączonym partycjonowaniem plików. Jeśli okaże się, że jest on wyłączony, włącz go i uruchom ponownie eksporty.

Upewnij się, że kontener pozyskiwania jest wypełniony i odśwież swoje raporty lub inne połączone narzędzia.

Centra FinOps: pliki dostępne w kontenerze wczytywania

Jeśli kontener pozyskiwania nie jest pusty, sprawdź, czy masz pliki parquet lub csv.gz, weryfikując zawartość folderów.

Gdy już wiesz, sprawdź, czy parametr FileType jest skonfigurowany na .parquet lub .gz w raporcie usługi Power BI. Aby uzyskać szczegółowe informacje, zobacz Nawiązywanie połączenia z danymi .

Jeśli używasz innego narzędzia, upewnij się, że obsługuje on używany typ pliku.


Power BI: Nie udało się rozpoznać nazwy zdalnej: "<storage-account.dfs.core.windows.net>"

Wskazuje, że nazwa konta magazynu jest nieprawidłowa. Jeśli używasz centrów FinOps, zweryfikuj parametr StorageUrl z wdrożenia. Aby uzyskać szczegółowe informacje, zobacz Nawiązywanie połączenia z danymi .


Power BI: nie można przekonwertować wartości null na typ Logiczny

Wskazuje, że parametr Identyfikator konta rozliczeniowego jest pusty. W przypadku korzystania z centrów FinOps ustaw wartość na docelowy identyfikator konta rozliczeniowego. Jeśli nie masz dostępu do konta rozliczeniowego lub nie chcesz uwzględniać zakupów i zwrotów zobowiązań, ustaw wartość na 0 i otwórz zapytanie CostDetails w edytorze zaawansowanym i zmień 2 wartość na 1. Ustawia raport tak, aby nie ładował danych o rzeczywistych/rozliczanych kosztach z łącznika Cost Management. Aby uzyskać szczegółowe informacje, zobacz Nawiązywanie połączenia z danymi .

Odpowiednie wersje: 0.1 – 0.1.1 (naprawiono w wersji 0.2)


Centra FinOps: nie można przekonwertować wartości null na typ Tabela

Ten błąd zwykle wskazuje, że dane nie zostały przetworzone do kontenera przetwarzania.

Jeśli właśnie zaktualizowałeś do centrów FinOps w wersji 0.2, problem może wynikać z tego, że raport Power BI jest stary (z wersji 0.1.x) lub dlatego, że nie używasz eksportów FOCUS. Aby uzyskać szczegółowe informacje, zobacz Przewodnik uaktualniania.

Aby uzyskać więcej kroków rozwiązywania problemów, zobacz Raporty są puste (brak danych ).


Prześlij opinię

Daj nam znać, jak nam idzie, zostawiając krótką opinię. Te recenzje służą do ulepszania i rozszerzania narzędzi i zasobów FinOps.

Przesyłanie opinii

Jeśli szukasz czegoś konkretnego, zagłosuj na istniejący lub utwórz nowy pomysł. Podziel się pomysłami z innymi osobami, aby uzyskać więcej głosów. Skupiamy się na pomysłach z największą większością głosów.

Głosuj na pomysły lub sugeruj własne


Powiązana zawartość

Jeśli nie widzisz błędu, który występuje, zapoznaj się z przewodnikiem rozwiązywania problemów. Jeśli masz jakieś pytania, rozpocznij dyskusję lub utwórz problem w usłudze GitHub.


  • Last updated on