Aracılığıyla paylaş


Sık karşılaşılan FinOps araç seti hatalarını giderme

Bu makalede yaygın FinOps araç seti hataları açıklanır ve çözümler hakkında bilgi sağlanır. FinOps araç seti çözümlerini kullanırken anlamadığınız veya çözemediğiniz bir hata alırsanız, sorunu çözmek için azaltma adımlarını içeren aşağıdaki ilgili hata kodunu bulun.

Aşağıda, risk azaltma bilgilerinin yer aldığı yaygın hata kodlarının listesi yer alır.

Sağlanan bilgiler sorunu çözmezse Sorun giderme kılavuzunu deneyin.


Kaynağa erişim yasak

Önem Derecesi: Kritik

Bu hata genellikle bağlı olduğunuz hesabın kullanmaya çalıştığınız kaynağa erişimi olmadığı anlamına gelir.

Azaltma: Doğru Microsoft Entra ID kiracısında doğru hesabı kullandığınızı onaylayın.


Hesap Özelliği Güncellenemez

Önem Derecesi: Kritik

Bu hata genellikle bir FinOps hub dağıtımı oluşturma sırasında kullanılandan farklı bir depolama hesabı yapılandırmasıyla güncelleştirilirken oluşur. Çoğu özellik değiştirilebilir ancak depolama hesabı oluşturulduğunda yalnızca bir kez ayarlanabilen ve değiştirilemeyen birkaç özellik vardır. FinOps hub'ları için bunun bilinen tek örneği "requireInfrastructureEncryption" özelliğidir. Bu özellik ilk FinOps hub dağıtımı sırasında etkinleştirildiyse veya devre dışı bırakıldıysa değiştirilemez. Bu durumda aşağıdaki hatayı görürsünüz:

Girişte 'requireInfrastructureEncryption' özelliği belirtildi, ancak salt okunur olduğundan güncelleştirilemiyor.

Azaltma: Bu ayarı değiştirmek istemediyseniz, depolama hesabınızın altyapı şifrelemesini kullanacak şekilde yapılandırılıp yapılandırılmadığını onaylayın ve FinOps hub şablonunu aynı değerle (açık veya kapalı) yeniden dağıtın. Ayarı değiştirmek istiyorsanız yeni bir FinOps hub örneği dağıtmanızı öneririz, bunun için tüm verilerin yeniden ayarlanması gerekir.

Mevcut depolama hesabını silmeyi ve altyapı şifrelemesi değiştirilmiş şablonu yeniden dağıtmayı deneyebilirsiniz; ancak, bunu kapsamlı bir şekilde test etmedik. Sorunları öngörmesek de, sorunlara neden olup olmadığını doğrulayamıyoruz.


BadHubVersion

Önem Derecesi: Kritik

FinOps hub'ları 0.2 çalışır durumda değildir. 0.3 veya sonraki bir sürüme yükseltin.

Önlem: FinOps hub'larını en son sürüme yükseltin.


'Resources' tablosundaki 'id' sütunu yinelenen bir değer içeriyor

Önem Derecesi: Kritik

Aşağıdaki hatayla karşılaşırsanız, bu, Azure Resource Graph'ın id sütunu için aynı mantıksal değere sahip satırları döndürdüğü anlamına gelir. Kaynak kimliği değerlerinde büyük/küçük harf uyumsuzluğu olduğunda veya başka bir sütun satırlara genişletildiğinde bu durum oluşabilir.

'Resources' Tablosundaki 'id' sütunu '{resource-id}' yinelenen bir değer içeriyor ve çoka bir ilişkinin bir tarafındaki sütunlar veya tablonun birincil anahtarı olarak kullanılan sütunlar için buna izin verilmiyor.

Önlem: Raporun en son sürümünü kullandığınızdan emin olun. Yinelenen değerlerin nedenini belirleyin ve yinelenen değerlere geçici bir çözüm bulmak için sorguyu güncelleştirin. Gelecekteki bir sürümde düzeltilebilmesi için lütfen bu sorunu GitHub'da bildirin . Bu, hatanın nedenini gidermek için ek ayrıntı veya toplantı gerektirebilir.


Çatışma Hatası

Önem Derecesi: Kritik

Bu hatanın birden çok örneği olabilir. Bilinen bir örnek, Key Vault'un aşağıdaki hatayı döndürmesidir:

Aynı ada sahip bir kasa silinmiş durumda zaten var. Mevcut anahtar kasasını geri almanız veya temizlemeniz gerekir. Geçici silme hakkında daha fazla bilgi için bu bağlantıyı https://go.microsoft.com/fwlink/?linkid=2149745 izleyin.

Bu, genellikle silinmiş eski bir dağıtımın üzerine yeni bir dağıtım yaptığınız, ancak Key Vault'un eski kasa örneğini kurtarılabilir bir silinme durumunda tuttuğu anlamına gelir.

Azaltma: Bunu düzeltmek için Azure portalında silinen Key Vault'un temizlenmesini sağlayın.

  1. Azure portalında Key Vault örneklerinin listesini açın.
  2. Sayfanın üst kısmındaki Silinen kasaları yönet komutunu seçin.
  3. Açılan listeden aboneliği seçin.
  4. Kaldırılacak kasaları denetleyin.
  5. Açılır pencerenin alt kısmındaki Temizle'yi seçin.
  6. Onaylama iletişim kutusunda Sil'i seçin.

Artık dağıtımı yeniden deneyebilirsiniz.


Sözleşme Masrafı Etkin Maliyetten Az

Önem derecesi: Uyarı

ContractedCost (üzerinde anlaşmaya varılan indirimlere göre), (taahhüt indirimlerinden sonra) EffectiveCost'den küçüktür, Maliyet Yönetimi'nden alınan verilerde. Taahhüt indirimi, mevcut anlaşmalı indirimlerinizden daha az indirim sağlamadığı sürece bu hiçbir zaman gerçekleşmemelidir. Bu, tasarruf hesaplamalarınızın tam olarak doğru bir şekilde toplanmamasına neden olur.

Önlem: Maliyet verilerinin ContractedUnitPrice fiyat verilerindeki değerlerle eşleştiğini onaylayın. Sözleşme yapılan fiyat doğruysa, x_EffectiveUnitPrice ve EffectiveCost değerlerinin doğru olduğunu onaylamak için Maliyet Yönetimi ekibine bir destek isteği gönderin. Bunlar doğruysa taahhüt indirimini iade etmeyi göz önünde bulundurun.


Kiracılar arası erişim ilkesi bu kullanıcıya izin vermiyor

Önem Derecesi: Büyük

Aşağıdaki hatayla karşılaşırsanız, Microsoft Entra ID'nin diğer kiracıların kullanıcılarının mevcut kiracıda oturum açmasına izin vermeyecek şekilde yapılandırıldığı anlamına gelir.

İleti: AADSTS500213: Kaynak kiracısının kiracılar arası erişim ilkesi bu kullanıcının bu kiracıya erişmesine izin vermiyor.

Bu hata iletisi FinOps araç seti ile ilgili değildir.

Hafifletme: Doğru hesapla oturum açtığınızdan ve hedef dizinin içinde oturum açtığınızdan emin olun. Daha fazla yardıma ihtiyacınız varsa dizin yöneticisine başvurun.


DataExplorerVeriYüklemeBaşarısız

Önem Derecesi: Kritik

Veri Gezgini veri alma işlemi başarısız oldu. Yeni veriler raporlama için kullanılamaz.

Yaygın hata: SEM0080 assert(), 'Veri Alma Başarısız Oldu' iletisiyle başarısız oldu.

Azure Data Factory işlem hattında aşağıdaki anlamsal hatayı görürseniz:

Anlamsal hata: Relop anlamsal hatası: SEM0080: assert() şu iletiyle başarısız oldu: 'Alma Başarısız Oldu'

Bu hata, Veri Gezgini .ingest komutunun alma işlemi sırasında hatalar algıladığını gösterir. Veri alma komutu, komut sonuçlarındaki sütunu doğrulayan bir onay denetimi (assert(iff(toscalar($command_results | project-keep HasErrors) == false, true, false), "Ingestion Failed")) içerir. HasErrors true olduğunda, doğrulama başarısız olur ve bu hatayı tetikler.

Yaygın kök nedenler:

  • Boş parquet dosyası: Parquet dosyası veri satırı içermiyor. Bu en yaygın nedendir.

    • Maliyet Yönetimi dışarı aktarma işlemi boş bir dosya oluşturdu (zaman aralığı için veri yok)
    • ETL işlem hattı dönüştürme sırasında boş bir parquet dosyası oluşturdu
    • Dosya oluşturuldu ancak veri yazma işlemi başarısız oldu
  • Şema uyuşmazlığı: Parquet dosyası şeması hedef tablo için veri alımı eşlemeleriyle eşleşmiyor.

    • Parquet dosyasındaki sütunların adları veya veri türleri beklenenden farklı olabilir
    • Alma eşlemesi (örneğin, <table>_mapping) güncel olmayabilir veya yanlış olabilir
    • Dışarı aktarma şemasına eşlemede olmayan yeni sütunlar eklendi
  • Bozuk veya geçersiz parke dosyaları: Kaynak dosya hatalı biçimlendirilmiş, bozulmuş veya geçerli bir parquet dosyası olmayabilir.

  • Eksik veya yanlış alma eşlemesi: Başvuruda bulunulan eşleme (örneğin, Costs_raw_mapping) yok veya yanlış sütun tanımları var.

  • Veri türü dönüştürme hataları: Parquet dosyasındaki veriler, tablo şemasında tanımlanan hedef sütun türlerine dönüştürülemez.

  • Dosya erişim sorunları: Veri Gezgini izinler veya ağ sorunları nedeniyle depolamadaki parquet dosyasına erişemiyor.

Risk Azaltma Adımları:

  1. Veri Gezgini'nde alma hatalarını kontrol edin:

    • Veri Gezgini kümenize/veritabanınıza bağlanma
    • Ayrıntılı hata bilgilerini görmek için aşağıdaki sorguyu çalıştırın:
      .show ingestion failures
      | where FailedOn > ago(4h) and Database == "<YourDatabaseName>"
      | project FailedOn, Table, IngestionSourcePath, ErrorCode, Details
      
    • Details Boş dosyalar, şema uyuşmazlıkları veya veri sorunları hakkında belirli hata iletileri için sütunu gözden geçirin
    • Boş bir dosyayı gösteren hata BadRequest_NoRecordsOrWrongFormat kodlarını arayın
  2. Parquet dosyasının boş olup olmadığını denetleyin:

    • Sorunlu parquet dosyasını veri alım kapsayıcısından indirin (yol hata iletisindedir)
    • Dosyayı incelemek için parquet görüntüleyici aracı veya Azure Depolama Gezgini kullanma
    • Dosya boyutunu denetleyin - çok küçükse (< 1 KB), büyük olasılıkla boş olabilir
    • Dosyanın veri satırları içerdiğini doğrulayın
    • Boşsa: Bu, zaman aralığı için veri olmadığında beklenen davranıştır. Dosya, özümseme kapsayıcısından güvenli bir şekilde silinebilir. Maliyet Yönetimi, boş dosyaları kullanımı olmayan aylar boyunca dışarı aktarabilir.
  3. Alma eşlemesinin mevcut olduğunu ve doğru olduğunu doğrulayın:

    • Eşlemenin mevcut olup olmadığını denetlemek için Veri Gezgini'nde bu sorguyu çalıştırın:
      .show table <TableName> ingestion mappings
      
    • Eşleme eksikse yeniden oluşturulması gerekir. Eşleme oluşturma hataları için FinOps hub dağıtım günlüklerini denetleyin.
    • Eşleme varsa, veri kaynağınız için beklenen şemayla eşleşip eşleşmediğini doğrulayın
  4. Şema değişikliklerini denetleyin:

    • Maliyet Yönetimi dışarı aktarmalarını yakın zamanda güncelleştirdiyseniz veya dışarı aktarma sürümlerini değiştirdiyseniz (örneğin, FOCUS 1.0'dan 1.2'ye) şema değişmiş olabilir
    • msexports kapsayıcısında manifest.json dosyasındaki dışarı aktarma veri kümesi sürümünü doğrulayın
    • FinOps hub'larının veri kümesi sürümünü desteklediğini onaylayın - desteklenen veri kümelerine bakın
  5. Veri Gezgini tanılamalarını denetleyin:

    • Azure portalında Veri Gezgini kümenize gidin
    • İzleme>Tanılama ayarları'na gidin
    • Henüz etkinleştirilmemişse tanılama günlüklerini etkinleştirme FailedIngestion
    • Ayrıntılı hata bilgileri için Log Analytics'teki günlükleri gözden geçirin
  6. Eşlemeler eksikse FinOps hub'larını tekrar konuşlandır:

    • Alma eşlemeleri eksik veya bozuksa, FinOps hub'larını yeniden oluşturmak için yeniden dağıtın.
    • Bu, veri kaybı olmadan tüm tabloları, eşlemeleri ve işlevleri yeniden oluşturur
  7. Azure Veri Gezgini ölçümlerini gözden geçirin:

    • Azure İzleyici'de veri alımı sonucu ölçümünü denetle
    • Başarı ve başarısızlık oranlarını görmek için duruma göre filtreleyin
    • Diğer ayrıntılar için bkz. Kuyruğa alınmış alımı izleme
  8. Sorunu düzelttikten sonra veri almayı yeniden çalıştırın

    • Kök nedeni çözdükten sonra işlem hattını yeniden çalıştırın ingestion_ExecuteETL
    • Parametre olarak hata iletisinden klasör yolunu belirtin
    • İşlem hattının başarılı alımını onaylamak amacıyla yürütmeyi izleyin
    • Not: Boş dosyaların yeniden işlenmesine gerek yoktur, bunlar güvenle yok sayılabilir.

Ek kaynaklar:

Bu adımları takip ettikten sonra bu hatayla karşılaşmaya devam ederseniz lütfen sorunu aşağıdaki bilgilerle bildirin:

  • ADF işlem hattından tam hata iletisi
  • Sorgunun çıktısı .show ingestion failures
  • manifest.json dosyasından veri kümesi türü ve sürümü
  • FinOps hubs sürümü

Data Explorer Veri Yükleme Haritalama Başarısız

Önem Derecesi: Kritik

Data Explorer (Veri Gezgini) veri alma haritalaması belirtilen tablo için oluşturulamadı.

Mitigasyon: Lütfen hatayı düzeltin ve belirtilen klasör yolu için alma işlemini tekrar çalıştırın. Bu hatayı görmeye devam ederseniz lütfen https://aka.ms/ftk/ideasadresinde bir sorun bildirin.


DataExplorerIngestionTimeout

Önem Derecesi: Kritik

Veri Gezgini alımı, kullanılabilir kapasiteyi beklerken 2 saat sonra zaman aşımına uğradı.

Önleme: Alma işlemini yeniden denemek için lütfen bu boru hattını yeniden çalıştırın. Bu hatayı görmeye devam ederseniz lütfen https://aka.ms/ftk/ideasadresinde bir sorun bildirin.


VeriKaşifiSonrasıYutmaBırakmaBaşarısız

Önem Derecesi: Kritik

Veri Gezgini veri alımı sonrası temizleme (son tablodan uzantıları kaldırma) başarısız oldu. Önceki bir veri alımından elde edilen veriler raporlamada bulunabilir ve bu da yinelenen ve yanlış maliyetlere neden olabilir.

Bu hata şu durumlarda meydana gelebilir:

  • Veri Gezgini kümesi kapasite sorunları veya yüksek kaynak kullanımıyla karşılaşıyor
  • Drop extents komutu geçersiz bir ifade veya söz dizimi hatasıyla karşılaşıyor
  • Veri Gezgini veritabanına erişim izni sorunları var
  • Data Factory ile Veri Gezgini arasındaki ağ bağlantısı sorunları

Azaltma:

  1. Ayrıntılı hata iletisini gözden geçirin: Azure Data Factory > İzleyici > İşlem Hattı çalıştırmalarına > gidin Başarısız çalıştırmaya > tıklayın Veri Gezgini hata kodunu ve iletisini görmek için "Alma Sonrası Bırakma Başarısız Oldu" etkinliğini görüntüleyin.

  2. Hata türüne dayalı yaygın çözümler:

    • "Alma Sonrası Bırakma Başarısız Hata iletisi veya hata kodu yorumlanamadı" ifadesini görürseniz: Bu, Başarısız etkinliğindeki dinamik ifadenin değerlendirilemediğini gösterir. Bu genellikle şu anlama gelir:

      • Etkinlik Post-Ingest Cleanup başarısız oldu ancak hata ayrıntılarını beklenen biçimde döndürmedi
      • Veri Gezgini'nin gerçek hatasını bulmak için Post-Ingest Cleanup etkinlik çıktısını kontrol edin.
      • Bu özel hata deseni hakkında daha fazla ayrıntı için bkz. ErrorCodeNotString
    • Kapasite/kaynak sorunları için:

      • Birkaç dakika bekleyin ve işlem hattını yeniden çalıştırın
      • Azure İzleyici'de Veri Gezgini küme ölçümlerini denetleme
      • Sürekli kapasite sınırlarına erişiyorsa kümenin ölçeğini artırmayı göz önünde bulundurun
    • İzin sorunları için:

      • Data Factory yönetilen kimliğinin Veri Gezgini veritabanında uygun izinlere sahip olduğunu doğrulayın
      • Yönetilen kimliğin en az "Database Ingestor" ve "Database Admin" rollerine sahip olduğundan emin olun
    • Söz dizimi/ifade hataları için:

      • Veri Gezgini sorgu düzenleyicisinde kullanarak .show commands Veri Gezgini komut günlüklerini gözden geçirin
      • Kapsamı silme sorgusunu etkileyebilecek son şema değişikliklerini kontrol edin
  3. Alma işlemini yeniden çalıştırma: Sorun çözüldükten sonra Azure Data Factory'deki işlem hattını kullanarak belirtilen klasör için veri alımını ingestion_ExecuteETL yeniden çalıştırın.

  4. Veri yinelemesini engelle: Hata devam ederse, veri alımını yeniden çalıştırmadan önce Veri Gezgini komutlarını kullanarak yinelenen uzantıları el ile temizlemeniz gerekebilir. Yardım için desteğe başvurun.

Daha fazla bilgi için bakınız:

https://aka.ms/ftk/ideaskonumunda çözülmemiş sorunları bildirin.


DataExplorerÖnYüklemeBırakmaBaşarısız

Önem Derecesi: Kritik

Data Explorer alım öncesi temizleme işlemi (ham tablodan uzantıları kaldırma) başarısız oldu. Alım tamamlanmadı.

Bu hata, yeni verileri almadan önce çalışan Veri Gezgini temizleme adımı başarısız olduğunda oluşur. Ham tablolarda yinelenen verileri önlemek için bu temizleme gereklidir.

Azaltma:

  1. Ayrıntılı hata iletisini gözden geçirin: Azure Data Factory > Monitör > İşlem Hattı Çalıştırmaları > sayfasına gidin, başarısız çalıştırmaya > tıklayın ve belirli Veri Gezgini hata kodunu ve iletisini görmek için "Alma Öncesi Bırakma Hatası" etkinliğini görüntüleyin.

  2. Hata türüne dayalı yaygın çözümler:

    • "Ön Alma Başarısız Hatasını veya hata kodunu yorumlayamadı" ifadesini görüyorsanız sorun giderme adımları için bkz. ErrorCodeNotString.

    • Kapasite/kaynak sorunları için:

      • Birkaç dakika bekleyin ve işlem hattını yeniden çalıştırın
      • Azure İzleyici'de Veri Gezgini küme ölçümlerini denetleme
    • İzin sorunları için:

      • Data Factory yönetilen kimliğinin Veri Gezgini veritabanında "Veritabanı Yöneticisi" rolüne sahip olduğunu doğrulayın
    • Söz dizimi/ifade hataları için:

      • Veri Gezgini sorgu düzenleyicisinde kullanarak .show commands Veri Gezgini komut günlüklerini gözden geçirin
  3. Alma işlemini yeniden çalıştırma: Sorun çözüldükten sonra Azure Data Factory'deki işlem hattını kullanarak belirtilen klasör için veri alımını ingestion_ExecuteETL yeniden çalıştırın.

Daha fazla bilgi için bkz. DataExplorerPostIngestionDropFailed için azaltma adımları.

https://aka.ms/ftk/ideaskonumunda çözülmemiş sorunları bildirin.


Dağıtım Çıktısı Değerlendirme Başarısız

Önem Derecesi: Büyük

FinOps hubs 0.8, Azure Veri Gezgini'nin "trustedExternaltenants" güvenlik ayarını, yalnızca belirli ve güvenilir kiracılardan erişilebilecek şekilde kümeyi kilitleyecek biçimde ayarlar. Bu ayar ilk dağıtım için ayarlanabilir, ancak ikinci dağıtımda yeniden ayarlanamaz. Mevcut bir 0.8 dağıtımının üzerine FinOps hub'ları 0.8'i yeniden dağıtmaya çalışırsanız aşağıdaki hatayı görebilirsiniz:

'clusterUri' şablon çıkışı geçerli değil: 'uri' dil ifadesi özelliği yok, kullanılabilir özellikler 'trustedExternalTenants, enableStreamingest, publicNetworkAccess, enableAutoStop, provisioningState' şeklindedir.

Doğru çözümü belirlemek için Azure Veri Gezgini ekibiyle birlikte çalışıyoruz.

Risk Azaltma: FinOps hub'ları 0.9 sürümünü dağıtın. Bu ayar şablondan kaldırılmıştır.


İhracatVerisiBulunamadı

Önem Derecesi: Kritik

İhracatlar belirtilen depolama yolunda bulunamadı.

Azaltma: Maliyet Yönetimi dışarı aktarmasının oluşturulduğunu ve doğru depolama hesabı, kapsayıcı ve depolama yolu ile yapılandırıldığını onaylayın. Oluşturulduktan sonra dışarı aktarma işlemini başlatmak için 'Şimdi çalıştır'ı seçin. Dışarı aktarmaların tamamlanması hesabın boyutuna bağlı olarak 15-30 dakika sürebilir. FinOps hub'larını kullanmayı planladıysanız, depolama URL'sini 'yükleme' kapsayıcısına işaret edecek şekilde düzeltin. FinOps hub dağıtımının çıktısındaki tam URL'yi görmek için storageUrlForPowerBI adresine bakın.


DışaAktarımTürüTanımlanmamış

Önem Derecesi: Kritik

Bu faturalama kapsamı türü yönetilen dışarı aktarmalar tarafından desteklenmez.

Azaltma: Desteklenmeyen faturalama kapsamını settings.json'den kaldırın, faturalama kapsamının FinOps hub'ları tarafından desteklendiğini onaylayın ve faturalama kapsamı için el ile yeni Maliyet yönetimi dışarı aktarmaları oluşturun.


Desteklenmeyen İhracat Türü

Önem Derecesi: Kritik

Yönetilen dışarı aktarmalar için Microsoft Müşteri Sözleşmeleri desteklenmez.

Azaltım: MCA faturalama kapsamını settings.json'dan kaldırın ve FOCUS maliyeti, fiyat listesi, rezervasyon ayrıntıları, rezervasyon işlemleri ve rezervasyon önerileri için her MCA faturalama profili için elle yeni Maliyet Yönetimi ihracatları oluşturun.


ErrorCodeNotString

Önem Derecesi: Kritik

Azure Data Factory Başarısız etkinliği dinamik hata iletisini veya hata kodu ifadesini geçerli bir dize olarak değerlendiremediğinde bu hata oluşur. Hata iletisi genellikle "[activity_name] hata iletisi veya hata kodu ErrorCodeNotString yorumlanamadı" şeklinde ve hata koduyla görünür.

Yaygın senaryolar:

  • Ana etkinlik (Post-Ingest Cleanup, Pre-Ingest Cleanup veya Ingest Data gibi) başarısız oldu, ancak beklenen biçimde hata çıktısı oluşturmadı.
  • Dinamik ifade, etkinlik çıkışında mevcut olmayan bir özelliğe erişmeye çalışır
  • Etkinlik çıkışı null, boş veya beklenen JSON yapısında değil

Azaltma:

  1. Kök neden etkinliğini tanımlama: Başarısız etkinliği tetikleyen etkinliğe bakın (örneğin, "Alma Sonrası Bırakma Başarısız Oldu Hatası" ifadesini görürseniz "Alma Sonrası Temizleme" etkinliğini denetleyin).

  2. Üst etkinlik çıkışını gözden geçirin:

    • Azure Data Factory > İzleyici > İşlem Hattı çalıştırmalarına gidin
    • Başarısız işlem hattı çalışmasını tıklayın
    • Başarısız etkinliğinden hemen önce çalıştırtığınız etkinliği bulun ve tıklayın
    • Gerçek hata ayrıntılarını görmek için "Çıkış" sekmesini gözden geçirin
    • Etkinliğin neden başarısız olduğunu açıklayan hata iletilerini veya kodları arayın
  3. Veri Gezgini'ne özgü sorunları denetleyin (alma işlem hattı hataları için):

    • Kaynak kapasitesi: Veri Gezgini kümesi kapasitede olabilir. Azure İzleyici'de küme ölçümlerini denetleyin.
    • Komut söz dizimi hataları: Sorgu düzenleyicisinde kullanarak .show commands Veri Gezgini komut geçmişini gözden geçirin.
    • İzin sorunları: Yönetilen kimliğin uygun veritabanı izinlerine sahip olduğunu doğrulayın.
    • Ağ bağlantısı: Data Factory'nin Veri Gezgini kümesine ulaşadığından emin olun.
  4. Yaygın Veri Gezgini sorun giderme komutları:

    // Check recent failed operations
    .show operations
    | where StartedOn > ago(4h) and State == "Failed"
    
    // Check ingestion failures
    .show ingestion failures
    | where FailedOn > ago(4h)
    
    // Check command history
    .show commands
    | where StartedOn > ago(4h)
    
  5. Temel sorunu çözdükten sonra: Başarısız işlem hattını Azure Data Factory'den yeniden çalıştırın.

İlgili hatalar: Bu hata genellikle aşağıdakilerle birlikte görülür:

Daha fazla bilgi için bakınız:

https://aka.ms/ftk/ideaskonumunda çözülmemiş sorunları bildirin.


Hub Verileri Bulunamadı

Önem Derecesi: Kritik

FinOps hub'ı verileri belirtilen depolama hesabında bulunamadı.

Azaltma: Bu hatanın, bir FinOps hub dağıtımına bağlandığınız varsayımına dayandığı kabul edilir. Ham dışarı aktarmalar kullanıyorsanız, ingestion kapsayıcısına başvurmamak için lütfen depolama yolunu düzeltin. Aşağıdakileri onaylayın:

  1. Depolama URL'si, FinOps hub dağıtımındaki çıktıyla eşleşmelidir StorageUrlForPowerBI .
  2. Maliyet Yönetimi dışa aktarmaları, kapsayıcı msexports ile aynı depolama hesabına işaret edecek şekilde yapılandırılmalıdır.
  3. Maliyet Yönetimi aktarımları, çalışma geçmişinde başarılı bir aktarma göstermelidir.
  4. FinOps hub veri fabrikası tetikleyicilerinin tümü başlatılmalıdır.
  5. FinOps hub veri fabrikası işlem hatları başarılı olmalıdır.

Daha fazla ayrıntı ve hata ayıklama adımları için bkz. FinOps hub dağıtımınızı doğrulama.


İncelemeDosyalarıBulunamadı

Önem Derecesi: Kritik

Belirtilen klasör yolundan alınacak parquet dosyaları bulunamıyor.

Önlem: Klasör yolunun, ingestion kapsayıcısını da içeren tam yol olduğunu ve eğik çizgiyle (/) başlamadığını veya bitmediğini onaylayın. Son başarılı ingestion_ExecuteETL işlem hattı çalıştırmasının yolunu kopyalayın.


DahiliServisHatası

Microsoft Fabric Real-Time Intelligence, veri alırken "InternalServiceError (520-UnknownError)" hata kodu döndürebilir. Ayrıntılı hata iletisinde şu ifadeler bulunabilir:

Kusto istemcisi hizmete istek gönderemedi: 'Aktarım bağlantısından veri okunamıyor: Var olan bir bağlantı uzak konak tarafından zorla kapatıldı.' `

Bu hatanın tam nedeni bilinmiyor. Bu sorunla karşılaşırsanız, daha fazla araştırma yapmak için lütfen Microsoft Fabric'e bir destek isteği gönderin.

Hafifletme: Geçici bir çözüm olarak, Fabric etkinlik evi için en düşük tüketimi Orta (18 CUs) olarak değiştirin, 30 dakika bekleyin ve bu veri kümesi ve ay için ingestion_ExecuteETL boru hattını yeniden çalıştırın. Minimum tüketim hakkında daha fazla bilgi edinmek için etkinlik binasına genel bakış bölümünde Minimum tüketim bölümüne bakın.


Geçersiz Etkili Maliyet

Önem Derecesi: Büyük

Kasım 2024 itibarıyla Maliyet Yönetimi,tasarruf planı satın almalarının hem gerçek hem de amorti edilmiş maliyetler olarak dahili olarak izlendiği bilinen bir hataya sahiptir. Bu nedenle FOCUS, EffectiveCosthesaplamasında tasarruf planı satın almalarını içerir ve bu da FinOps araç seti raporlarında yanlış sayılara yol açar.

Azaltma: Microsoft Maliyet Yönetimi ekibine, temel alınan verileri düzeltmek için sorunla ilgili ayrıntıları içeren bir destek isteği gönderin. Kasım 2024 itibarıyla ekip sorunun farkındadır ancak düzeltmeye henüz öncelik verilmemiştir. Bu arada, FinOps hub'ları ve depolama tabanlı Power BI raporları için geçici bir çözüm içeren FinOps araç seti 0.7'ye güncelleştirin.


GeçersizVeriDışaAktarmaKapsayıcısı

Önem Derecesi: Kritik

Bu dosya Maliyet Yönetimi'nden dışarı aktarılmış gibi görünüyor ancak doğru kapsayıcıda değil.

Azaltma: Maliyet Yönetimi dışa aktarma işleminizi, 'msexports' depolama kapsayıcısına işaret edecek şekilde güncelleyin. 'Veri alımı' kapsayıcısı yalnızca alınan maliyet verilerini sorgulamak için kullanılır.


Geçersiz Dışa Aktarma Sürümü

Önem Derecesi: Kritik

FinOps hub'ları FOCUS maliyet dışa aktarmalarını gerektirir, ancak bu dosya geçmiş bir Maliyet Yönetimi dışa aktarması gibi görünüyor.

Hafifletme: FOCUS maliyeti için yeni bir Maliyet Yönetimi ihracatı oluşturun ve mevcut ihracatı durdurun veya başka bir depolama kapsayıcısına ihraç edilecek şekilde değiştirin.


Geçersiz Hub Sürümü

Önem Derecesi: Kritik

FinOps hub'ları 0.1.1 ve önceki sürümleri Veri alımı Power BI raporuyla çalışmaz.

Azaltma: FinOps hub'larının en son sürümüne yükseltin veya 0.1.1 sürümünden Power BI raporlarını indirin.


GeçersizKapsamId

Önem Derecesi: Bilgisel

Dışarı aktarma yolu geçerli bir kapsam kimliği değil. FinOps hub'ları, dışarı aktarma yolunun, yönetimi basitleştirmek için dışarı aktarmanın oluşturulduğu kapsam için bir Azure kaynak kimliği olmasını bekler. Hatalara neden olmamalıdır, ancak kapsamla ilgili raporlar için kafa karıştırıcı sonuçlara neden olabilir.

Azaltma: Maliyet Yönetimi dışa aktarma için depolama yolunu, kapsam için tam Azure kaynak kimliğini kullanacak şekilde güncelleştirin.


LegacyFocusVersion

Önem Derecesi: Bilgisel

Bu hata kodu, alınan veriler FOCUS'ın eski bir sürümünü kullandığında gösterilir. x_SourceChanges sütununda bulunduğunda kod yalnızca bilgilendirme amaçlıdır. Maliyetler sorgusu yüklenemediğinde Power BI depolama raporlarında gösteriliyorsa, bu, Kullanım Dışı: Ek Sorgu İyileştirmeleri Yapma parametresinin devre dışı bırakıldığı anlamına gelir.

FinOps hub'ları verileri en son FOCUS sürümüne dönüştürür, bu nedenle bu bir soruna neden olmamalıdır; ancak modernleştirme dönüşümü tüm senaryoları hesaba ekleyemez ve bazı durumlarda beklenmeyen sonuçlara neden olabilir. Bilinen sorunlar için belgelere bakın.

Azaltma: Hangi aracı kullandığınıza bağlı olarak bu iletiyi azaltmanın çeşitli yolları vardır.

Veri Gezgini ile FinOps hub'ları kullanıyorsanız ve bunu Maliyetler tablosunun veya ilgili işlevlerin x_SourceChanges sütununda görüyorsanız, Maliyet Yönetimi maliyet dışarı aktarmalarını en son FOCUS sürümünü kullanacak şekilde güncelleştirin. Ek değişiklik yapılması gerekmez. Veri Gezgini alımı sırasında tüm veriler birleştirilir.

Depolama raporları kullanılıyorsa ve bunu Maliyetler sorgusunun x_SourceChanges sütununda görüyorsanız, bu ileti bu FOCUS sürümünün gelecekteki bir güncelleştirmede kaldırılacağına ilişkin bir uyarıdır. Bu mesajı güvenle görmezden gelebilirsiniz, ancak gelecekteki bir sürümde güncellenmesi gerekecektir. İletiyi önlemek için Maliyet Yönetimi dışarı aktarmalarını en son FOCUS sürümüne güncelleştirin, eski bir FOCUS sürümünü kullanarak eski verileri silin veya taşıyın ve geçmiş verileri yeniden gönderin. FinOps hubları kullanıyorsanız verileri yükleme kapsayıcısının dışına taşıyın veya silin. Depolamada kendi dışarı aktarmalarınızı barındırıyorsanız, Depolama URL'si parametresini eski FOCUS sürümlerini içermeyen farklı bir klasör yoluna değiştirin.

FinOps araç seti 0.7'den itibaren, performansı ve ölçeklenebilirliği geliştirmek için eski FOCUS sürümleri desteği kullanım dışı bırakılmıştır. Deneyiminizi geliştirmek için en son FOCUS sürümüne güncelleştirmenizi ve verileri yeniden göndermenizi öneririz. Daha eski FOCUS sürümlerinin desteklenmesi için Kullanım Dışı: Ek Sorgu İyileştirmeleri parametresini TRUE olarak ayarlayın ve performansı hızlandırmak ve daha fazla maliyet veya zamanı kapsayan daha büyük veri kümelerini desteklemek için FALSE olarak ayarlayın. 0,7 itibarıyla bu parametre geriye dönük uyumluluk için varsayılan olarak etkindir. FinOps araç seti 0.8'de varsayılan olarak devre dışı bırakılır, ancak Haziran 2025'e kadar geriye dönük uyumluluk için kullanılabilir. Eski FOCUS sürümlerini devre dışı bırakamıyorsanız veya daha büyük hesaplar veya daha uzun süreler için en iyi performans ve destek için Veri Gezgini ile FinOps hub'ları kullanmanızı öneririz.


Sözleşmeli Maliyetten Daha Az Liste Maliyeti

Önem derecesi: Uyarı

Maliyet Yönetimi'nin verilerine göre ListCost (genel, perakende fiyatlarına göre), ContractedCost (üzerinde anlaşmaya varılan indirimlere göre) ile karşılaştırıldığında daha azdır. Bu asla olmamalı. Bu, tasarruf hesaplamalarınızın tam olarak doğru bir şekilde toplanmamasına neden olur.

Önlem: Maliyet verilerinin ListUnitPrice fiyat verilerindeki değerlerle eşleştiğini onaylayın. Liste fiyatı doğruysa, maliyet yönetimi ekibine hem ve ListUnitPrice hem de ContractedUnitPrice doğru olduğunu onaylamak için bir destek isteği gönderin ve üzerinde anlaşmaya varılan indirimlerden sonra fiyatın neden genel, perakende fiyatlarından yüksek olacağını açıklayın.

Veri kalitesi sorunlarının tasarruf hesaplamalarını nasıl etkilediği hakkında ayrıntılı bilgi için bkz. Tasarruf hesaplamalarını anlama.


ManifestOkumaBaşarısız

Önem Derecesi: Kritik

FinOps hub msexports_ExecuteETL işlem hattı Maliyet Yönetimi bildirim dosyasını okuyamadı.

Azaltma:

  1. Çalışan bir hub örneğinde, hub'da veya dışarı aktarmada hiçbir değişiklik yapılmadığında hata oluştuysa, Maliyet Yönetimi muhtemelen var olan bir API sürümünün bildirim şemasını değiştirmiştir.
  2. Yeni bir dışarı aktarma oluşturduktan veya var olan bir dışarı aktarmayı değiştirdikten sonra hata oluştuysa, dışarı aktarma API'sinin sürümü desteklenmeyen yeni bir bildirim şeması kullanabilir.
  3. Hata bir hub dağıtımından (ilk yükleme veya yükseltme) sonra oluştuysa, dağıtım başarısız olmuş olabilir veya işlem hattında bir hata olabilir.

Bildirim şemasını (#1) veya API sürümünü (#2) onaylamak için:

  1. Azure portalında veya depolama gezgininde hub depolama hesabını açın.
  2. Azure portalındaysa, menüden Depolama tarayıcısına gidin.
  3. msexports kapsayıcısını seçin.
  4. Sorunun olduğu dışa aktarma işlemi için dosya hiyerarşisinde aşağı doğru gidin (hata iletisindeki manifest konumuna bakın).
  5. manifest.json dosyasını bulun ve menüyü () ve ardından Görüntüle/düzenle'yi seçin.
  6. Aşağıdaki özellikleri tanımlayın:
    {
      "exportConfig": {
        "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
        "dataVersion": "<dataset-version>",
        "apiVersion": "2023-07-01-preview",
        "type": "<dataset-type>",
        ...
      },
      ...
    }
    
  7. Bunların aşağıdaki desteklenen değerlere ayarlandığını onaylayın:
    • resourceId herhangi bir kapsam kimliği ve herhangi bir dışarı aktarma adı olabilir, ancak "Microsoft.CostManagement/exports" kaynak türüyle mevcut olmalıdır. Büyük/küçük harfe duyarlı değil.
    • type mevcut olmalıdır, ancak null olmayan değerler için bu hatayla başarısız olmamalı.
    • dataVersion mevcut olmalıdır, ancak null olmayan değerler için bu hatayla başarısız olmamalıdır.
    • apiVersion açıkça kullanılmaz, ancak bildirim şemasındaki değişiklikleri işaret edebilir. Ayrıntılar için desteklenen API sürümlerine bakın.
  8. Daha yeni bir API sürümü kullanıyorsanız:
    1. Yeni API sürümü için destek eklemeyi izlemek için GitHub'da bir değişiklik isteği sorunu oluşturun.
    2. Maliyet Yönetimi'nde dışarı aktarmayı silin.
    3. Desteklenen bir API sürümünü kullanarak New-FinOpsCostExport PowerShell komutunu kullanarak dışarı aktarma oluşturun.

      İpucu

      Kendinizi güçlü bir kullanıcı olarak görürseniz, işlem hattını en hızlı çözüm için kendiniz güncelleştirmeyi deneyebilirsiniz. Bunu yapmak için Data Factory'yi açın, Yazar > İşlem Hatları > msexports_ExecuteETL'ye gidin ve ilgili "Ayarla" etkinliklerini seçin ve Ayarlar >Değeri özelliğini gerektiği gibi güncelleyin. Bunu yaparsanız, dışarı aktarmayı eski bir sürümle yeniden oluşturmanız gerekmez. Lütfen sorunu bildirmeye devam edin ve işlem hattı tasarımcısının sağ üst köşesindeki {} simgeden yeni JSON'ı paylaşmayı düşünün.

  9. Desteklenen bir API sürümü için özelliklerin değiştiğini fark ederseniz:
    1. Hataya neden olan değişikliği izlemek için GitHub'da bir değişiklik isteği sorunu oluşturun. manifest.json dosyanızdan türünü, dataVersion'ı ve apiVersion'ı ekleyin.
    2. FinOps hub'larını veya diğer özel çözümleri kullanan herkesi bozan değişikliklerin geri döndürülme isteğinde bulunmak için Maliyet Yönetimi'ne bir destek isteği gönderin. Maliyet Yönetimi destek ekibinin sistemindeki sorunu tanımlamasına yardımcı olmak için aşağıdaki ayrıntıları ekleyin. Maliyet Yönetimi'nin FinOps hub'ları hakkında bağlamı yoktur, bu nedenle ayrıntıları Maliyet Yönetimi işlevselliğine odaklamalısınız. Örnek:

      Maliyet verilerimi ADLS'ye çekmek için Maliyet Yönetimi dışa aktarımımı kullanıyorum. Bildirim dosyaları yazıldığında verileri işleyen bir ADF işlem hattım var. İşlem hattım, <your-supported-api-version> API sürümü üzerinde kurulmuştur, bu da exportConfig.resourceId, exportConfig.type ve exportConfig.dataVersion özelliklerinin tutarlı bir şekilde teslim edilmesini bekler. <your-export-date> tarihinde çalıştırılan dışa aktarma işlemim için bu API sürümünün bildirim dosyasında bu dosyaların yer almadığını fark ettim. Beklentim, bildirim dosyasının mevcut BIR API sürümü için hiçbir zaman değişmemesidir. Lütfen bu değişiklikleri geri alabilir misiniz?

      Sorun gidermenize yardımcı olması için bildirim dosyam şudur: {your-manifest-json}

Bildirim özellikleri iyi görünüyorsa ve yeni veya yükseltilmiş bir FinOps hub örneğiyse dağıtımı onaylayın:

  1. Azure portalında hub kaynak grubunu açın.
  2. Soldaki menüden Ayarlar>Dağıtımlar seçeneklerini seçin.
  3. Tüm dağıtımların başarılı olduğunu onaylayın. Özellikle aşağıdaki dağıtım adlarını arayın:
    • ana
    • merkez
    • veri fabrikası kaynakları
    • depolama
    • Anahtar Kasası
  4. Herhangi bir dağıtım başarısız olduysa, bunun kendi kendinize çözümleyebileceğiniz bir şey olup olmadığını (örneğin, ad çakışması, düzeltilebilir ilke ihlali) belirlemek için hata iletisini gözden geçirin.
  5. Hata geçici görünüyorsa dağıtmayı yeniden deneyin.
  6. Hata devam ederse, sorunla karşılaşan veya olası bir geçici çözümü (özellikle ilke sorunları için) bilen başka birinin olup olmadığını görmek için bir tartışma oluşturun.
  7. Hata açıkça bir hata veya özellik açığıysa GitHub'da bir hata veya özellik isteği sorunu oluşturun.

Üç iş günü içinde sorunlara ve tartışmalara yanıt vermeye çalışıyoruz. Canlı yardıma mı ihtiyacınız var? İki haftalık ofis saatlerimize katılın.


Eksik Anlaşmalı Maliyet

Önem Derecesi: Bilgisel

Bu hata kodu, x_SourceChanges ya null ya da 0 olduğunda ve ContractedCost 0'dan büyük olduğunda EffectiveCost sütununda gösterilir. Hata, Microsoft Maliyet Yönetimi'nin belirtilen satırlar için ContractedCost içermediğini gösterir; bu, tasarrufların hesaplanamayacağı anlamına gelir.

Azaltma: Eksik veriler için geçici bir çözüm olarak, FinOps araç seti raporları, bu hata koduyla işaretlenmiş satırlarda EffectiveCost öğesini ContractedCost sütununa kopyalar. Bu kayıtlar için indirimler kullanılamaz.

Tüm tasarrufları hesaplamak için maliyet ve kullanım verilerini fiyatlarla birleştirebilirsiniz. Daha fazla bilgi için bkz . sorun #873.


Eksik Sözleşmeli Birim Fiyatı

Önem Derecesi: Bilgisel

Bu hata kodu, x_SourceChanges ya null ya da 0 olduğunda ve ContractedUnitPrice 0'dan büyük olduğunda EffectiveUnitPrice sütununda gösterilir. Hata, Microsoft Maliyet Yönetimi'nin belirtilen satırlar için ContractedUnitPrice içermediğini gösterir; bu, tasarrufların hesaplanamayacağı anlamına gelir.

Azaltma: Eksik veriler için geçici bir çözüm olarak, FinOps araç seti raporları, bu hata koduyla işaretlenmiş satırlarda EffectiveUnitPrice öğesini ContractedUnitPrice sütununa kopyalar. Bu kayıtlar için indirimler kullanılamaz.

Tüm tasarrufları hesaplamak için maliyet ve kullanım verilerini fiyatlarla birleştirebilirsiniz. Daha fazla bilgi için bkz . sorun #873.

Eksik fiyatların tasarruf hesaplamalarını nasıl etkilediği hakkında ayrıntılı bilgi için bkz. Tasarruf hesaplamalarını anlama.


MissingListCost

Önem Derecesi: Bilgisel

Bu hata kodu, x_SourceChanges ya null ya da 0 olduğunda ve ListCost 0'dan büyük olduğunda ContractedCost sütununda gösterilir. Hata, Microsoft Maliyet Yönetimi'nin belirtilen satırlar için ListCost içermediğini gösterir; bu, tasarrufların hesaplanamayacağı anlamına gelir.

Azaltma: Eksik veriler için geçici bir çözüm olarak, FinOps araç seti raporları, bu hata koduyla işaretlenmiş satırlarda ContractedCost öğesini ListCost sütununa kopyalar. Bu kayıtlar için indirimler kullanılamaz.

Tüm tasarrufları hesaplamak için maliyet ve kullanım verilerini fiyatlarla birleştirebilirsiniz. Daha fazla bilgi için bkz . sorun #873.


EksikListeBirimFiyatı

Önem Derecesi: Bilgisel

Bu hata kodu, x_SourceChanges ya null ya da 0 olduğunda ve ListUnitPrice 0'dan büyük olduğunda ContractedUnitPrice sütununda gösterilir. Hata, Microsoft Maliyet Yönetimi'nin belirtilen satırlar için ListUnitPrice içermediğini gösterir; bu, tasarrufların hesaplanamayacağı anlamına gelir.

Azaltma: Eksik veriler için geçici bir çözüm olarak, FinOps araç seti raporları, bu hata koduyla işaretlenmiş satırlarda ContractedUnitPrice öğesini ListUnitPrice sütununa kopyalar. Bu kayıtlar için indirimler kullanılamaz.

Tüm tasarrufları hesaplamak için maliyet ve kullanım verilerini fiyatlarla birleştirebilirsiniz. Daha fazla bilgi için bkz . sorun #873.

Eksik fiyatların tasarruf hesaplamalarını nasıl etkilediği hakkında ayrıntılı bilgi için bkz. Tasarruf hesaplamalarını anlama.


Sağlayıcı Adı Eksik

Önem Derecesi: Bilgisel

bu hata kodu, x_SourceChanges null olduğunda ProviderName sütununda gösterilir. Hata, veri kümesinin sağlayıcısının (örneğin, Microsoft Maliyet Yönetimi) belirtilen satırlar için ProviderName değeri içermediğini gösterir.

Azaltma: Eksik verilere geçici bir çözüm olarak, FinOps araç seti raporları kullanılabilir sütunlara göre sağlayıcıyı belirlemeye çalışır.


'...' sorgusu diğer sorgulara veya adımlara başvurur

Önem Derecesi: Hafif

Bu hatanın kaynağı bilinmiyor. Power BI verileri yenilenirken bu hata rastgele ortaya çıkabilir.

Azaltma: Bu hatayı alırsanız Değişiklik uygula tekrar seçin.

Bu hata yalnızca depolama raporlarında bildirilmiştir. Uzun veri yenileme süreleriniz varsa veya bu hatayla sık sık karşılaşıyorsanız Veri Gezgini ile FinOps hub'larına geçmeyi göz önünde bulundurun. Veri Gezgini zamanlamayı veya artımlı yenilemeyi gerektirmeyen KQL raporlarını kullanır. Rapor açıldığında veriler çekilir, bu nedenle raporlar her zaman en son verileri gösterir.


KaynakErişimiYasaklanmışİstisnası

Önem Derecesi: Büyük

Power BI: 'Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException' türü özel durumu oluşturuldu

Power BI'da veri yükleyen hesabın Depolama Blobu Veri Okuyucusu rolüne sahip olmadığını gösterir. Bu rolü Power BI'daki verileri yüken hesaba verin.


Yanıt yükü boyutu... ve sınırı aştı

Önem Derecesi: Büyük

İdare ve İş Yükü iyileştirme Power BI raporlarındaki Azure Kaynak Grafiği sorguları aşağıdakine benzer bir hata döndürebilir:

OLE DB veya ODBC hatası: [Expression.Error] Destek isterken lütfen aşağıdaki bilgileri sağlayın: zaman damgası = {timestamp}, correlationId = {guid}. Ayrıntılar: Yanıt yükü boyutu {number} ve 16777216 sınırını aştı. Lütfen bir kerede daha az veri sorgulamayı ve gerekirse sayfalandırılmış çağrı yapmayı göz önünde bulundurun.

Bu hata, filtrelenmemiş bir Kaynak Grafı sorgusunda desteklenenden daha fazla kaynağınız olduğu anlamına gelir. Bunun nedeni FinOps araç seti raporlarının kaynak düzeyi ayrıntılarını gösterecek şekilde tasarlanmış olması ve toplanmamasıdır. Bunlar küçük ve orta ölçekli ortamlar için tasarlanmıştır ve milyonlarca kaynağı olan kuruluşları desteklemek için tasarlanmamıştır.

Azaltma: Bu hatayla karşılaşırsanız birkaç seçenek vardır:

  • Gereksinimleriniz için gerekli olmayan sütunları kaldırın.
  • Sizin için en önemli noktalara (örneğin abonelikler, etiketler) göre daha az kaynak döndürmek için sorguyu filtreleyin.
  • Diğer sorguların çalışmasını engellememesi için sorguyu devre dışı bırakın.

Rol Atama Güncellemesi İzin Verilmez

Önem Derecesi: Hafif

FinOps hub'larını sildiyseniz ve Yönetilen Kimlik adı da dahil olmak üzere aynı değerlerle yeniden dağıtmaya çalışırsanız, aşağıdaki bilinen sorunla karşılaşabilirsiniz:

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

Çözüm: Bu sorunu düzeltmek için eski kimliği kaldırmanız gerekir.

  • Depolama hesabına gidin ve menüden Erişim denetimi (IAM) öğesini seçin.
  • Rol atamaları sekmesini seçin.
  • "Bilinmeyen" kimliğe sahip rol atamalarını bulun ve silin.

Rol Ataması Mevcut

Önem Derecesi: Hafif

FinOps hub'larını bir sürümden diğerine yükseltirken, önceki bir dağıtımda oluşturulan rol atamaları hala mevcutsa aşağıdaki hatayla karşılaşabilirsiniz:

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

Bunun nedeni büyük olasılıkla yönetilen kimliğin önce tüm rol atamaları kaldırılmadan açıkça silinmesidir.

Çözüm: Bu sorunu düzeltmek için Azure portalında yetim rol atamalarını silin:

  • Kaynak grubuna veya etkilenen kaynağa (Veri Gezgini kümesi gibi) gidin.
  • Menüden Erişim denetimi (IAM) öğesini seçin.
  • Rol atamaları sekmesini seçin.
  • Bilinmeyen bir kimliğe sahip rol atamalarını bulun ve silin.

ŞemaYüklenemedi

Önem Derecesi: Kritik

FinOps hub msexports_ETL_ingestion işlem hattı şema dosyasını yükleyemedi.

Azaltma: Alt çizgiyle (örneğin, <type>_<version> veya FocusCost_1.0) biçimlendirilmiş veri kümesi türünü ve sürümünü not almak için hata iletisini gözden geçirin. Veri kümesinin ve türün, FinOps hub'larının dağıtılan sürümü tarafından desteklendiğini onaylayın. Ayrıntılar için desteklenen veri kümelerine bakın.


Şema Bulunamadı

Önem Derecesi: Kritik

FinOps hub msexports_ExecuteETL işlem hattı, dışarı aktarılan veri kümesinin şema eşleme dosyasını bulamadı.

Azaltma: Veri kümesi türü ve sürümünün desteklenip desteklenmediğini onaylayın. Ayrıntılar için desteklenen veri kümelerine bakın. Veri kümesi destekleniyorsa Veri alımı raporuyla hub sürümünü onaylayın.

Başka bir veri kümesi için destek eklemek için özel bir eşleme dosyası oluşturun ve dosyasına config/schemas/<dataset-type>_<dataset-version>.jsonkaydedin. Değerler, <dataset-type><dataset-version> Maliyet Yönetimi'nin kullandığı değerlerle çok eşleşmektedir. Her sütunun veri türünü tanımlamak için şablon olarak var olan bir şema dosyasını kullanın. Bazı veri kümelerinin EA ve Microsoft Müşteri Sözleşmesi (MCA) için farklı şemaları vardır. Bu öznitelikler aracılığıyla tanımlanamazlar ve her iki hesap türünüz de varsa bir soruna neden olabilir. FOCUS ile uyumlu hale getirme yoluyla EA ve MCA farklarını hesaba katmak için veri kümeleri eklemeye çalışıyoruz.


İçeri aktarma Depolama URL'si hiçbir dışa aktarmayla eşleşmiyor

Önem Derecesi: Büyük

FinOps araç seti 0.8 raporlarında bu sorunla karşılaşıyorsanız, hatanın nedeni var olmayan bir parametre başvurusudur.

Azaltma: Bu, FinOps araç seti 0.9'da düzeltildi. Düzeltmeyi uygulamak için en son sürüme güncelleştirin. Düzeltmeyi doğrudan 0.8 raporlarına uygulamanız gerekiyorsa, gelişmiş düzenleyicide ftk_DemoFilter işlevini düzenleyin ve içeriğini olarak değiştirin: () => "". Tüm değişiklikleri kaydedin, kapatın ve uygulayın.


BilinmeyenDışaAktarmaDosyası

Önem Derecesi: Bilgisel

Hub depolamadaki dosya Maliyet Yönetimi'nden dışarı aktarılmış gibi görünmüyor. Dosya göz ardı edilir.

Azaltma: msexports kapsayıcısı yalnızca Maliyet Yönetimi dışa aktarımları için tasarlanmıştır. Başka bir depolama kapsayıcısında diğer dosyaları taşıma.


BilinmeyenOdakSürümü

Önem Derecesi: Bilgisel

Bir FOCUS sürümü tanımlanamadığında bu hata kodu x_SourceChanges sütununda gösterilir.

Azaltma: FOCUS veri kümesinin desteklenen bir FOCUS sürümü kullandığını doğrulayın. Daha fazla araştırma yapmak için bu sorunu https://aka.ms/ftk/ideas anonimleştirilmiş bir veri örneğiyle bildirin.


UnknownHubVersion

Önem Derecesi: Kritik

Ayarlar dosyasından FinOps hub'larının sürümü tanımlanamıyor. Ayarların doğru olduğunu doğrulayın. FinOps hub'ları 0.1.1 ve önceki sürümleri bu Power BI raporuyla çalışmaz.

Azaltma: FinOps hub'larının en son sürümüne yükseltin veya FinOps araç seti v0.1.1 sürümünden Power BI raporlarını indirin.


Desteklenmeyen Dışa Aktarma Dosya Türü

Önem Derecesi: Kritik

Dosya türü desteklenmediğinden belirtilen dışarı aktarma dosyası alınamıyor.

Azaltma: msexports kapsayıcısına eklemeden önce dosyayı desteklenen bir dosya biçimine dönüştürün veya yeni dosya türünü msexports_ETL_ingestion işlem hattına dönüştürme desteği ekleyin.


DesteklenmeyenAktarımTürü

Önem derecesi: Uyarı

Hub depolama alanındaki dışarı aktarma bildirimi, dışarı aktarma işleminin desteklenmeyen bir veri kümesine yönelik olduğunu gösterir. Dışarı aktarılan veriler, veri alma hatası olarak rapor edilir.

Hafifletme: FOCUS maliyeti için yeni bir Maliyet Yönetimi ihracatı oluşturun ve mevcut ihracatı durdurun veya başka bir depolama kapsayıcısına ihraç edilecek şekilde değiştirin.


{name} kaynak sağlayıcısı {guid} aboneliğine kayıtlı değil

Önem Derecesi: Hafif

Aboneliği Azure portalında açın, ardından Ayarlar, kaynak sağlayıcısı satırını (örneğin, Microsoft.EventGrid) seçin ve ardından sayfanın üst kısmındaki Kaydet> Kayıt birkaç dakika sürebilir.


x_PricingSubcategory taahhüt indirimi kodunu gösterir

28 Şubat 2024'ten önceki Maliyet Yönetimi dışa aktarmalarında, taahhüt edilen kullanım için x_PricingSubcategory yanlış ayarlanmıştı. ve Committed Spendgibi Committed Usage değerleri görmeyi beklemeniz gerekir. Bunun yerine, aşağıdaki gibi değerler görebilirsiniz:

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

Bu değerleri görürseniz, o ayın maliyet verilerini yeniden dışarı aktarın. Mevcut olmayan eski bir aya ait verileri dışarı aktarmanız gerekiyorsa, önceki dışarı aktarma çalıştırmalarından veri kalitesi sorununu çözmeniz için verilerin dışarı aktarılma isteğinde bulunmak üzere desteğe başvurun.


Power BI: Raporlarda belirli tarihlere ilişkin veriler eksik

Raporunuzda bir veya daha fazla ay boyunca tüm veriler eksikse, verilerin filtrelenmediğinden emin olmak için Ay Sayısı, Aralık Başlangıcı ve Aralık Sonu parametrelerini denetleyin.

Parametreleri denetlemek için şeritte Verileri>dönüştür Parametreleri düzenle'yi seçin veya sorgu düzenleyicisi penceresinden 🛠️ Kurulum klasöründeki parametreleri tek tek seçin.

  • Her zaman belirli sayıda son ayı göstermek istiyorsanız, Ay Sayısı'nı kapatılan (tamamlanan) ay sayısına ayarlayın. Geçerli ay, kapatılan ay sayısına ek olarak ek bir aydır.
  • Zaman içinde değişmeyen sabit bir tarih aralığı istiyorsanız (örneğin, mali yıl raporlama), RangeStart ve RangeEnd'i ayarlayın.
  • Kullanılabilir tüm verileri raporlamak istiyorsanız, üç tarih parametresinin de boş olduğunu onaylayın.

Daha fazla bilgi için İlk raporunuzu ayarlama konusuna bakın.


Power BI: Raporlar boş (veri yok)

Power BI'nızda veya diğer raporlarda veya araçlarda veri görmüyorsanız, veri kaynağınıza göre aşağıdakileri deneyin:

  1. Power BI'de Maliyet Yönetimi bağlayıcısını kullanıyorsanız, Billing Account ID ve Number of Months parametrelerinin doğru ayarlandığından emin olmak için denetleyin. Eski ödeme hesaplarında son aylarda veri bulunamayabilir.
  2. FinOps hub'ları kullanıyorsanız verilerin alma kapsayıcısında dolduruldığından emin olmak için depolama hesabını denetleyin. Sağlayıcılar veya abonelikler klasörünü görmeniz gerekir. Daha fazla sorun gidermek için aşağıdaki bölümleri kullanın.

FinOps hub'ları: Toplama kapsayıcısı boş

Alma kapsayıcısı boşsa, Data Factory Studio'da Data Factory örneğini açın ve Yönet>> seçeneklerini seçin ve msexports_FileAdded tetikleyicisinin başlatıldığını doğrulayın. Eğer değilse, başlatın.

Tetikleyici "kaynak sağlayıcısı kayıtlı değil" hatasıyla başlayamazsa aboneliği Azure portalında açın, ardından Ayarlar> seçin, Microsoft.EventGrid satırını seçin ve ardından sayfanın üst kısmındaki Kaydet komutunu seçin. Kayıt birkaç dakika sürebilir.

Kayıt tamamlandıktan sonra msexports_FileAdded tetikleyicisini yeniden başlatın.

Tetikleyici başlatıldıktan sonra tüm bağlı Maliyet Yönetimi dışa aktarmalarını yeniden çalıştırın. Veriler, hesabın boyutuna bağlı olarak 10-20 dakika içinde tamamen alınmalıdır.

Sorun devam ederse, Maliyet Yönetimi dışarı aktarmalarının dosya bölümleme etkin olarak yapılandırılıp yapılandırılmamış olduğunu denetleyin. Devre dışı olduğunu fark ederseniz, açın ve dışa aktarmayı tekrar başlatın.

Veri alım kapsayıcısının dolu olduğundan emin olun ve raporlarınızı veya diğer bağlı araçları yenileyin.

FinOps hub'ları: Veri alma kapsayıcısında kullanılabilen dosyalar

Veri alma kapsayıcısı boş değilse, klasörlere girerekparquet veya csv.gz dosyalarınız olup olmadığını onaylayın.

Biliyorsanız, Power BI raporunda FileType parametresinin veya .parquet olarak ayarlandığını doğrulayın. Ayrıntılar için Verilerinize bağlanma bölümüne bakın.

Başka bir araç kullanıyorsanız, kullandığınız dosya türünü desteklediğinden emin olun.


Power BI: Uzak ad çözümlenemedi: '<storage-account.dfs.core.windows.net>'

Depolama hesabı adının yanlış olduğunu gösterir. FinOps hub'ları kullanıyorsanız, dağıtımdan StorageUrl parametresini doğrulayın. Ayrıntılar için Verilerinize bağlanma bölümüne bakın.


Power BI: Null değerini Mantıksal türüne dönüştüremiyoruz

Faturalama Hesabı Kimliği parametresinin boş olduğunu gösterir. FinOps hub'ları kullanıyorsanız, değeri istenen ödeme hesabı kimliğine ayarlayın. Ödeme hesabına erişiminiz yoksa veya taahhüt satın almalarını ve para iadelerini dahil etmek istemiyorsanız, değerini 0 olarak ayarlayın ve gelişmiş düzenleyicide CostDetails sorgusunu açın ve öğesini 2 olarak 1değiştirin. Raporu Maliyet Yönetimi bağlayıcısından gerçek/faturalanmış maliyet verilerini yüklememesi konusunda bilgilendirmektedir. Ayrıntılar için Verilerinize bağlanma bölümüne bakın.

Geçerli sürümler: 0.1 - 0.1.1 (0.2 ile düzeltildi)


Power BI: Null değerini Tablo türüne dönüştüremiyoruz

Önem Derecesi: Kritik

Bu hata, Power BI depolama raporlarını gerekli Data Lake Storage (DFS) uç noktası yerine Blob uç noktasını kullanarak bir depolama hesabına bağlarken oluşabilir.

Azaltma: Depolama URL'si parametrenizi Data Lake Storage uç noktasını kullanacak şekilde güncelleştirin:

  1. Depolama URL'nizdeki .blob.core.windows.net'yi .dfs.core.windows.net ile değiştirin.
  2. Azure portalını kullanıyorsanız:
    • Depolama hesabınızı açma
    • Ayarlar>Uç Noktaları'nı seçin
    • Data Lake Storage URL'sini kopyalayın (Blob hizmeti URL'sini değil)

Örneğin:

  • ❌ Yanlış: https://mystorageaccount.blob.core.windows.net/container
  • ✅ Doğru: https://mystorageaccount.dfs.core.windows.net/container

Doğru uç noktayı kullandıktan sonra sorun yaşamaya devam ediyorsanız, ek sorun giderme adımları için bkz . FinOps hub'ları: Null değerini Tablo türüne dönüştüremiyoruz .


FinOps hub'ları: Null değerini Tablo türüne dönüştüremiyoruz

Bu hata genellikle verilerin ingestion kapsayıcısına alınmadığını gösterir.

FinOps hub'ları 0.2'ye yeni yükselttiyseniz, sorun Power BI raporunun eski olmasından (0.1.x'ten) veya FOCUS dışarı aktarmalarını kullanmadığınızdan kaynaklanabilir. Ayrıntılar için Yükseltme kılavuzuna bakın.

Daha fazla sorun giderme adımı için bkz. Raporlar boş (veri yok).


Görüş bildirin

Hızlı bir incelemeyle nasıl olduğumuzu bize bildirin. Bu incelemeleri FinOps araçlarını ve kaynaklarını geliştirmek ve genişletmek için kullanırız.

Belirli bir şey arıyorsanız mevcut bir fikir için oy verin veya yeni bir fikir oluşturun. Daha fazla oy almak için başkalarıyla fikir paylaşın. En çok oyu alan fikirlere odaklanıyoruz.


Karşılaştığınız hatayı görmüyorsanız sorun giderme kılavuzunu inceleyin. Sorularınız varsa, GitHub'da bir tartışma başlatın veya bir sorun oluşturun.