Bagikan melalui

Memecahkan masalah kesalahan kotak alat FinOps umum

Artikel ini menjelaskan kesalahan toolkit FinOps umum dan menyediakan informasi tentang solusi. Jika Anda mendapatkan kesalahan saat menggunakan solusi toolkit FinOps yang tidak Anda pahami atau tidak dapat mengatasinya, temukan kode kesalahan terkait berikut dengan langkah-langkah mitigasi untuk mengatasi masalah tersebut.

Berikut adalah daftar kode kesalahan umum dengan informasi mitigasi.

Jika informasi yang diberikan tidak mengatasi masalah, coba panduan Pemecahan Masalah.


Akses ke sumber daya dilarang

Tingkat keparahan: Kritis

Kesalahan ini umumnya berarti akun yang anda hubungkan tidak memiliki akses ke sumber daya yang anda coba gunakan.

Mitigasi: Pastikan Anda menggunakan akun yang tepat dalam tenant Microsoft Entra ID yang benar.


PropertiAkunTidakDapatDiperbarui

Tingkat keparahan: Kritis

Kesalahan ini biasanya terjadi saat memperbarui penyebaran hub FinOps dengan konfigurasi akun penyimpanan yang berbeda dari yang awalnya digunakan selama pembuatan. Meskipun sebagian besar properti dapat diubah, ada beberapa properti yang hanya dapat diatur sekali ketika akun penyimpanan dibuat dan tidak dapat berubah. Kasus yang diketahui dalam konteks hub FinOps adalah properti "requireInfrastructureEncryption". Jika properti ini diaktifkan atau dinonaktifkan selama penyebaran hub FinOps pertama, maka properti ini tidak dapat diubah. Anda akan melihat kesalahan berikut ketika ini terjadi:

Properti 'requireInfrastructureEncryption' ditentukan dalam input, tetapi tidak dapat diperbarui karena bersifat baca-saja.

Mitigasi: Jika Anda tidak bermaksud mengubah pengaturan ini, konfirmasikan apakah akun penyimpanan Anda dikonfigurasi untuk menggunakan enkripsi infrastruktur dan sebarkan kembali templat hub FinOps dengan nilai yang sama (baik aktif atau nonaktif). Jika Anda ingin mengubah pengaturan, sebaiknya sebarkan instans hub FinOps baru, karena ini akan memerlukan penyerapan ulang semua data.

Anda dapat mencoba menghapus akun penyimpanan yang ada dan menyebarkan ulang templat dengan enkripsi infrastruktur diubah; namun, kami belum menguji ini secara menyeluruh. Meskipun kami tidak mengantisipasi masalah, kami tidak dapat mengonfirmasi apakah itu akan menyebabkan masalah.


BadHubVersion

Tingkat keparahan: Kritis

Hub FinOps 0.2 tidak beroperasi. Tingkatkan ke versi 0.3 atau yang lebih baru.

Mitigasi: Tingkatkan ke versi terbaru hub FinOps.


Kolom 'id' dalam Tabel 'Sumber Daya' berisi nilai duplikat

Tingkat keparahan: Kritis

Jika Anda mengalami kesalahan berikut, artinya Azure Resource Graph mengembalikan baris dengan nilai logis yang sama untuk kolom id . Ini dapat terjadi ketika nilai ID sumber daya memiliki casing yang tidak konsisten atau ketika kolom lain diperluas ke beberapa baris.

Kolom 'id' dalam Tabel 'Sumber Daya' berisi nilai duplikat '{resource-id}' dan ini tidak diperbolehkan untuk kolom di satu sisi hubungan banyak ke satu atau untuk kolom yang digunakan sebagai kunci utama tabel.

Mitigasi: Pastikan Anda menggunakan versi terbaru dari laporan. Identifikasi penyebab nilai duplikat dan perbarui kueri untuk mengatasi nilai duplikat. Harap laporkan juga masalah ini di GitHub sehingga dapat diperbaiki dalam rilis mendatang. Ini mungkin memerlukan detail tambahan atau rapat untuk memecahkan masalah penyebab kesalahan.


KesalahanKonflik

Tingkat keparahan: Kritis

Mungkin ada beberapa contoh kesalahan ini. Satu kasus yang diketahui adalah ketika Key Vault mengembalikan kesalahan berikut:

Vault dengan nama yang sama sudah ada dalam status dihapus. Anda perlu memulihkan atau menghapus peti kunci yang ada. Ikuti tautan https://go.microsoft.com/fwlink/?linkid=2149745 ini untuk informasi selengkapnya tentang penghapusan sementara.

Ini umumnya berarti Anda menyebarkan di atas penyebaran lama yang dihapus, tetapi Key Vault menyimpan instans vault lama dalam status penghapusan yang dapat dipulihkan.

Mitigasi: Untuk memperbaikinya, bersihkan sepenuhnya Key Vault yang telah dihapus di portal Azure.

  1. Buka daftar instans Key Vault di portal Microsoft Azure.
  2. Pilih perintah Kelola vault yang dihapus di bagian atas halaman.
  3. Pilih langganan di menu dropdown.
  4. Periksa brankas yang akan dihapus.
  5. Pilih Bersihkan di bagian bawah flyout.
  6. Pilih Hapus di dialog konfirmasi.

Anda kini dapat mencoba ulang penerapan.


Biaya Dikotrak Kurang dari Biaya Efektif

Tingkat keparahan: Peringatan

ContractedCost (berdasarkan diskon yang dinegosiasikan) lebih kecil dari EffectiveCost (setelah diskon komitmen) pada data dari Cost Management. Ini seharusnya tidak pernah terjadi kecuali diskon komitmen memberikan diskon yang lebih kecil daripada diskon yang telah dinegosiasikan sebelumnya. Ini akan menyebabkan perhitungan penghematan Anda tidak sesuai secara akurat.

Mitigasi: Konfirmasikan apakah ContractedUnitPrice dalam data biaya sesuai dengan yang ada dalam data harga. Jika harga yang dikontrak benar, ajukan permintaan dukungan kepada tim Cost Management untuk mengonfirmasi x_EffectiveUnitPrice dan EffectiveCost sudah benar. Jika benar, pertimbangkan untuk mengembalikan diskon komitmen.


Kebijakan akses lintas penyewa tidak mengizinkan pengguna ini

Tingkat Keparahan: Utama

Jika Anda mengalami kesalahan berikut, artinya ID Microsoft Entra dikonfigurasi untuk tidak mengizinkan pengguna dari penyewa lain masuk ke penyewa saat ini.

Pesan: AADSTS500213: Kebijakan akses lintas penyewa sumber daya tidak memungkinkan pengguna ini mengakses penyewa ini.

Pesan kesalahan ini tidak terkait dengan toolkit FinOps.

Mitigasi: Verifikasi bahwa Anda masuk ke akun yang benar dan Anda masuk melalui direktori target. Hubungi admin direktori jika Anda memerlukan bantuan lebih lanjut.


Pengambilan Data Di Penjelajah Gagal

Tingkat keparahan: Kritis

Pemrosesan Data Explorer gagal. Data baru tidak akan tersedia untuk pelaporan.

Kesalahan umum: SEM0080 assert() gagal dengan pesan 'Penyerapan Gagal'

Jika Anda melihat kesalahan semantik berikut di alur Azure Data Factory:

Kesalahan semantik: Kesalahan semantik relop: SEM0080: assert() telah gagal dengan pesan: 'Penyerapan Gagal'

Kesalahan ini menunjukkan bahwa perintah Data Explorer .ingest mendeteksi kesalahan selama proses penyerapan. Perintah pengambilan data menyertakan pemeriksaan asersi (assert(iff(toscalar($command_results | project-keep HasErrors) == false, true, false), "Ingestion Failed")) yang memverifikasi kolom HasErrors dalam hasil perintah. Ketika HasErrors adalah true, pernyataan gagal dan memicu kesalahan ini.

Akar penyebab umum:

  • File parket kosong: File parket tidak berisi baris data. Ini adalah penyebab paling umum.

    • Ekspor Cost Management menghasilkan file kosong (tidak ada data untuk periode waktu)
    • Alur ETL membuat file parket kosong selama transformasi
    • File dibuat tetapi operasi penulisan data gagal

  • Ketidakcocokan skema: Skema file parquet tidak cocok dengan referensi pemetaan pemasukan untuk tabel target.

    • Kolom dalam file parquet mungkin memiliki nama atau jenis data yang berbeda dari yang diharapkan
    • Pemetaan penyerapan (misalnya, <table>_mapping) mungkin kedaluarsa atau salah
    • Kolom baru ditambahkan ke skema ekspor yang tidak ada dalam pemetaan

  • File parket yang rusak atau tidak valid: File sumber mungkin salah bentuk, rusak, atau bukan file parket yang valid.

  • Pemetaan penyerapan yang hilang atau salah: Pemetaan yang direferensikan (misalnya, Costs_raw_mapping) tidak ada atau memiliki definisi kolom yang salah.

  • Kesalahan konversi jenis data: Data dalam file parquet tidak dapat dikonversi ke jenis kolom target yang ditentukan dalam skema tabel.

  • Masalah akses file: Data Explorer tidak dapat mengakses file parquet di penyimpanan karena izin atau masalah jaringan.

Langkah-langkah mitigasi:

  1. Periksa kegagalan penyerapan di Data Explorer:

    • Hubungkan ke kluster/database Data Explorer Anda
    • Jalankan kueri berikut untuk melihat informasi kesalahan terperinci: 
      .show ingestion failures
| where FailedOn > ago(4h) and Database == "<YourDatabaseName>"
| project FailedOn, Table, IngestionSourcePath, ErrorCode, Details
    • Details Tinjau kolom untuk pesan kesalahan tertentu tentang file kosong, ketidakcocokan skema, atau masalah data
    • Cari kode kesalahan seperti BadRequest_NoRecordsOrWrongFormat yang menunjukkan file kosong

  2. Periksa apakah file parquet kosong:

    • Unduh file parket bermasalah dari kontainer penyerapan (jalur ada dalam pesan kesalahan)
    • Gunakan alat penampil parquet atau Azure Storage Explorer untuk memeriksa file
    • Periksa ukuran file - jika sangat kecil (< 1KB), kemungkinan kosong
    • Pastikan file tersebut berisi baris data
    • Jika kosong: Ini adalah perilaku yang diharapkan ketika tidak ada data untuk periode waktu tersebut. Berkas dapat dihapus dengan aman dari kontainer ingestion. Cost Management dapat mengekspor file kosong selama berbulan-bulan tanpa penggunaan.

  3. Verifikasi bahwa pemetaan penyerapan ada dan sudah benar:

    • Jalankan kueri ini di Data Explorer untuk memeriksa apakah pemetaan ada: 
      .show table <TableName> ingestion mappings
    • Jika pemetaan hilang, pemetaan perlu dibuat ulang. Periksa log penyebaran hub FinOps untuk memetakan kesalahan pembuatan.
    • Jika pemetaan ada, verifikasi bahwa pemetaan cocok dengan skema yang diharapkan untuk sumber data Anda

  4. Periksa perubahan skema:

    • Jika Anda baru saja memperbarui ekspor Cost Management atau mengubah versi ekspor (misalnya, dari FOCUS 1.0 ke 1.2), skema mungkin telah berubah
    • Verifikasi versi himpunan data ekspor dalam file manifest.json dalam kontainer msexports
    • Mengonfirmasi hub FinOps mendukung versi himpunan data - lihat himpunan data yang didukung

  5. Periksa diagnostic dari Data Explorer:

    • Di portal Microsoft Azure, navigasikan ke kluster Data Explorer Anda
    • BukaPengaturan Diagnostik>
    • Aktifkan FailedIngestion log diagnostik jika belum diaktifkan
    • Tinjau log di Log Analytics untuk mendapatkan informasi kesalahan yang terperinci

  6. Sebarkan ulang hub FinOps jika pemetaan hilang:

    • Jika pemetaan pemasukan data hilang atau rusak, sebarkan ulang hub FinOps untuk membangunnya kembali
    • Ini akan membuat ulang semua tabel, pemetaan, dan fungsi tanpa kehilangan data

  7. Tinjau metrik Azure Data Explorer:

    • Periksa metrik hasil Penyerapan di Azure Monitor
    • Filter menurut status untuk melihat tingkat keberhasilan vs kegagalan
    • Lihat Memantau antrean penyerapan untuk detail selengkapnya.

  8. Jalankan ulang penyerapan setelah memperbaiki masalah:

    • Setelah menyelesaikan akar penyebabnya, jalankan ulang ingestion_ExecuteETL alur.
    • Tentukan jalur folder dari pesan kesalahan sebagai parameter
    • Memantau eksekusi alur untuk mengonfirmasi keberhasilan penyerapan
    • Catatan: File kosong tidak perlu diserap ulang - file dapat diabaikan dengan aman

Sumber daya tambahan:

Jika Anda terus mengalami kesalahan ini setelah mengikuti langkah-langkah ini, silakan laporkan masalah dengan informasi berikut:

  • Pesan kesalahan lengkap dari pipa ADF
  • Output dari kueri .show ingestion failures
  • Jenis dan versi himpunan data dari file manifest.json
  • Versi hub FinOps

PemetaaanIngestiDataExplorerGagal

Tingkat keparahan: Kritis

Pemetaan penyerapan Data Explorer tidak dapat dibuat untuk tabel yang ditentukan.

Mitigasi: Perbaiki kesalahan dan ulangi pengambilan data pada jalur folder yang ditentukan. Jika Anda terus melihat kesalahan ini, silakan laporkan masalah di https://aka.ms/ftk/ideas.


Batas Waktu Ingesti Data Explorer

Tingkat keparahan: Kritis

Proses penyerapan Data Explorer berakhir setelah 2 jam menunggu kapasitas yang tersedia.

Mitigasi: Jalankan kembali alur ini untuk mencoba kembali penyerapan. Jika Anda terus melihat kesalahan ini, silakan laporkan masalah di https://aka.ms/ftk/ideas.


Data Explorer Gagal Menghapus Setelah Ingesti

Tingkat keparahan: Kritis

Pembersihan pasca-penyerapan Data Explorer (penghilangan ekstensi dari tabel akhir) gagal. Data dari pengambilan sebelumnya mungkin sudah ada dalam laporan, yang dapat mengakibatkan biaya terduplikasi dan tidak akurat.

Kesalahan ini dapat terjadi ketika:

  • Kluster Data Explorer mengalami masalah kapasitas atau pemanfaatan sumber daya yang tinggi
  • Perintah drop extents mengalami ekspresi atau kesalahan sintaksis yang tidak valid
  • Ada masalah izin saat mengakses database Data Explorer
  • Masalah konektivitas jaringan antara Data Factory dan Data Explorer

Mitigasi:

  1. Tinjau pesan kesalahan terperinci: Navigasi ke Azure Data Factory > Monitor > Pemantauan Alur > Klik pada alur yang gagal > Lihat aktivitas "Post-Ingest Drop Failed Error" untuk melihat kode dan pesan kesalahan Data Explorer tertentu.

  2. Solusi umum berdasarkan jenis kesalahan:

    • Jika Anda melihat "Gagal menginterpretasikan pesan gagal atau kode kesalahan Post-Ingest Drop Failed Error": Ini menunjukkan bahwa ekspresi dinamis dalam aktivitas Fail tidak dapat dievaluasi. Ini biasanya berarti:

      • Aktivitas Post-Ingest Cleanup gagal tetapi tidak mengembalikan detail kesalahan dalam format yang diharapkan
      • Periksa output aktivitas Post-Ingest Cleanup untuk kesalahan sebenarnya dari Data Explorer
      • Lihat ErrorCodeNotString untuk detail selengkapnya tentang pola kesalahan khusus ini

    • Untuk masalah kapasitas/sumber daya:

      • Tunggu beberapa menit dan jalankan ulang pipelin
      • Memeriksa metrik kluster Data Explorer di Azure Monitor
      • Pertimbangkan untuk meningkatkan kluster jika secara konsisten mencapai batas kapasitas

    • Untuk masalah izin:

      • Memverifikasi identitas terkelola Data Factory memiliki izin yang tepat pada database Data Explorer
      • Pastikan identitas terkelola memiliki setidaknya peran "Database Ingestor" dan "Admin Database"

    • Untuk kesalahan sintaks/ekspresi:

      • Tinjau log perintah Data Explorer menggunakan .show commands di editor kueri Data Explorer
      • Periksa perubahan skema terbaru yang mungkin memengaruhi kueri tingkat penurunan

  3. Jalankan ulang penyerapan: Setelah masalah diselesaikan, jalankan ulang penyerapan data untuk folder yang ditentukan menggunakan ingestion_ExecuteETL alur di Azure Data Factory.

  4. Mencegah duplikasi data: Jika kesalahan berlanjut, Anda mungkin perlu membersihkan tingkat duplikat secara manual menggunakan perintah Data Explorer sebelum menjalankan ulang penyerapan. Hubungi dukungan untuk bantuan.

Untuk informasi selengkapnya, lihat:

Laporkan masalah yang belum terselesaikan di https://aka.ms/ftk/ideas.


Kesalahan pada "DataExplorerPreIngestionDropFailed"

Tingkat keparahan: Kritis

Pembersihan pra-pemasukan Data Explorer (menghapus bagian data dari tabel mentah) gagal. Penyerapan tidak selesai.

Kesalahan ini terjadi ketika langkah pembersihan Data Explorer yang berjalan sebelum menyerap data baru gagal. Pembersihan ini diperlukan untuk mencegah data duplikat dalam tabel mentah.

Mitigasi:

  1. Tinjau pesan kesalahan terperinci: Buka Azure Data Factory > Monitor > Eksekusi Alur > Klik pada eksekusi > yang gagal untuk melihat aktivitas "Pre-Ingest Drop Failed Error" guna melihat kode dan pesan kesalahan Data Explorer yang spesifik.

  2. Solusi umum berdasarkan jenis kesalahan:

    • Jika Anda melihat "Gagal menginterpretasikan pesan kesalahan atau kode kesalahan 'Pre-Ingest Drop Failed Error'": Lihat ErrorCodeNotString untuk langkah-langkah pemecahan masalah.

    • Untuk masalah kapasitas/sumber daya:

      • Tunggu beberapa menit dan jalankan ulang alur
      • Memeriksa metrik kluster Data Explorer di Azure Monitor

    • Untuk masalah izin:

      • Pastikan identitas terkelola Data Factory memiliki peran "Admin Database" di database Data Explorer

    • Untuk kesalahan sintaks/ekspresi:

      • Tinjau log perintah Data Explorer menggunakan .show commands di editor kueri Data Explorer

  3. Jalankan ulang penyerapan: Setelah masalah diselesaikan, jalankan ulang penyerapan data untuk folder yang ditentukan menggunakan ingestion_ExecuteETL alur di Azure Data Factory.

Untuk informasi selengkapnya, lihat langkah-langkah mitigasi untuk DataExplorerPostIngestionDropFailed.

Laporkan masalah yang belum terselesaikan di https://aka.ms/ftk/ideas.


GagalEvaluasiKeluaranPenerapan

Tingkat Keparahan: Utama

Hub FinOps 0.8 mengatur pengaturan keamanan "trustedExternaltenants" Azure Data Explorer untuk mengunci kluster sehingga hanya dapat diakses dari penyewa tertentu yang tepercaya. Pengaturan ini dapat diatur untuk penyebaran pertama, tetapi tidak dapat diatur lagi dalam penyebaran kedua. Anda mungkin melihat kesalahan berikut jika Anda mencoba menyebarkan ulang hub FinOps 0.8 di atas penyebaran 0,8 yang ada:

Output template 'clusterUri' tidak valid: Properti ekspresi bahasa 'uri' tidak ditemukan, properti yang tersedia adalah 'trustedExternalTenants, enableStreamingIngest, publicNetworkAccess, enableAutoStop, provisioningState'.

Kami menindaklanjuti dengan tim Azure Data Explorer untuk mengidentifikasi resolusi yang benar.

Mitigasi: Mengimplementasikan hub FinOps 0.9. Pengaturan ini telah dihapus dari templat.


DataEksporTidakDitemukan

Tingkat keparahan: Kritis

Ekspor tidak ditemukan di jalur penyimpanan yang ditentukan.

Mitigasi: Konfirmasikan bahwa sebuah ekspor Cost Management dibuat dan dikonfigurasi dengan akun penyimpanan, kontainer, dan jalur penyimpanan yang benar. Setelah dibuat, pilih 'Jalankan sekarang' untuk memulai proses ekspor. Ekspor dapat memakan waktu 15-30 menit untuk diselesaikan tergantung pada ukuran akun. Jika Anda bermaksud menggunakan hub FinOps, koreksi URL penyimpanan untuk menunjuk ke kontainer 'penyerapan'. storageUrlForPowerBI Lihat output dari penyebaran hub FinOps untuk URL lengkap.


JenisEksporTidakDitentukan

Tingkat keparahan: Kritis

Jenis cakupan penagihan ini tidak didukung oleh ekspor terkelola.

Mitigasi: Hapus cakupan penagihan yang tidak didukung dari settings.json, konfirmasikan cakupan penagihan didukung oleh hub FinOps dan buat ekspor manajemen Biaya baru secara manual untuk cakupan penagihan.


TipeEksporTidakDidukung

Tingkat keparahan: Kritis

Perjanjian Pelanggan Microsoft tidak didukung untuk ekspor terkelola.

Mitigasi: Hapus cakupan penagihan MCA dari settings.json dan buat ekspor Cost Management baru secara manual untuk setiap profil penagihan MCA untuk biaya FOCUS, lembar harga, detail reservasi, transaksi reservasi, dan rekomendasi reservasi.


ErrorCodeNotString

Tingkat keparahan: Kritis

Kesalahan ini terjadi ketika Aktivitas Gagal di Azure Data Factory tidak dapat mengevaluasi pesan kesalahan dinamis atau ekspresi kode kesalahannya menjadi string yang valid. Pesan kesalahan biasanya muncul sebagai "Gagal menafsirkan [activity_name] pesan gagal atau kode kesalahan" dengan kode ErrorCodeNotStringkesalahan .

Skenario umum:

  • Aktivitas induk (seperti Post-Ingest Cleanup, , Pre-Ingest Cleanupatau Ingest Data) gagal tetapi tidak menghasilkan output kesalahan dalam format yang diharapkan
  • Ekspresi dinamis mencoba mengakses properti yang tidak ada dalam output aktivitas
  • Output aktivitas kosong, tidak ada, atau tidak sesuai dalam struktur JSON yang diharapkan

Mitigasi:

  1. Identifikasi aktivitas akar penyebab: Lihat aktivitas mana yang memicu aktivitas Gagal (misalnya, jika Anda melihat "Kesalahan Gagal Pasca-Penyerapan", periksa aktivitas "Pembersihan Pasca-Penyerapan").

  2. Tinjau output aktivitas induk:

    • Menavigasi ke eksekusi Alur Monitor > Azure Data Factory >
    • Klik pada jalur pemrosesan yang gagal
    • Temukan dan klik aktivitas yang berjalan tepat sebelum aktivitas Gagal
    • Tinjau tab "Output" untuk melihat detail kesalahan aktual
    • Cari pesan kesalahan atau kode apa pun yang menjelaskan mengapa aktivitas gagal

  3. Periksa masalah khusus Data Explorer (untuk kesalahan alur penyerapan):

    • Kapasitas sumber daya: Kluster Data Explorer mungkin sudah pada batas kapasitas. Periksa metrik kluster di Azure Monitor.
    • Kesalahan sintaks perintah: Tinjau riwayat perintah Data Explorer menggunakan .show commands di editor kueri.
    • Masalah izin: Verifikasi identitas terkelola memiliki izin database yang tepat.
    • Konektivitas jaringan: Pastikan Data Factory dapat mencapai kluster Data Explorer.

  4. Perintah pemecahan masalah Common Data Explorer:

    // 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. Setelah menyelesaikan masalah yang mendasar: Jalankan ulang alur yang gagal dari Azure Data Factory.

Kesalahan terkait: Kesalahan ini sering terlihat bersama dengan:

Untuk informasi selengkapnya, lihat:

Laporkan masalah yang belum terselesaikan di https://aka.ms/ftk/ideas.


DataHubTidakDitemukan

Tingkat keparahan: Kritis

Data hub FinOps tidak ditemukan di akun penyimpanan yang ditentukan.

Mitigasi: Kesalahan ini berasumsi Anda tersambung ke penyebaran hub FinOps. Jika menggunakan ekspor mentah, perbaik jalur penyimpanan untuk tidak mereferensikan kontainer ingestion. Konfirmasikan hal berikut:

  1. URL penyimpanan harus cocok dengan keluaran StorageUrlForPowerBI pada penyebaran hub FinOps.
  2. Ekspor Cost Management harus dikonfigurasi untuk menunjuk ke akun penyimpanan yang sama menggunakan kontainer msexports.
  3. Ekspor Cost Management harus menunjukkan ekspor yang berhasil dalam riwayat operasi.
  4. Semua pemicu di pusat pabrik data FinOps harus dimulai.
  5. Alur kerja pabrik data hub FinOps harus berhasil.

Untuk informasi lebih lanjut dan langkah-langkah penelusuran kesalahan, lihat Validasi penyebaran hub FinOps Anda.


FilePemasukanTidakDitemukan

Tingkat keparahan: Kritis

Tidak dapat menemukan file parket untuk diserap dari jalur folder yang ditentukan.

Mitigasi: Konfirmasi jalur folder adalah jalur lengkap, termasuk pemasukan data kontainer dan tidak dimulai dengan atau diakhiri oleh garis miring (/). Salin jalur dari eksekusi alur ingestion_ExecuteETL terakhir yang berhasil.


Kesalahan Layanan Internal

Microsoft Fabric Real-Time Intelligence dapat mengembalikan kode kesalahan "InternalServiceError (520-UnknownError)" saat menyerap data. Pesan kesalahan terperinci dapat mengatakan:

Klien Kusto gagal mengirim permintaan ke layanan: 'Tidak dapat membaca data dari koneksi transportasi: Koneksi yang ada ditutup secara paksa oleh host jarak jauh.' `

Alasan pasti untuk kesalahan ini tidak diketahui. Jika Anda mengalaminya, silakan ajukan permintaan dukungan dengan Microsoft Fabric untuk menyelidiki lebih lanjut.

Mitigasi: Sebagai solusinya, ubah konsumsi minimum untuk eventhouse Fabric menjadi Sedang (18 CUs), tunggu 30 menit, dan jalankan kembali alur ingestion_ExecuteETL untuk himpunan data dan bulan tersebut. Untuk mempelajari lebih lanjut konsumsi minimum, lihat Konsumsi minimum dalam gambaran umum eventhouse.


BiayaEfektifTidakValid

Tingkat Keparahan: Utama

Mulai November 2024, Cost Management memiliki bug yang diketahui di mana pembelian paket penghematan dilacak secara internal sebagai biaya aktual dan biaya yang diamortisasi. Karena itu, FOCUS menyertakan pembelian paket penghematan dalam perhitungan untuk EffectiveCost, yang menyebabkan angka yang tidak akurat dalam laporan toolkit FinOps.

Mitigasi: Ajukan permintaan dukungan kepada tim Microsoft Cost Management dengan detail tentang masalah untuk memperbaiki data yang mendasarinya. Pada November 2024, tim mengetahui masalah ini, tetapi perbaikan belum diprioritaskan. Selama menunggu, perbarui ke toolkit FinOps 0.7, yang mencakup solusi sementara untuk hub FinOps dan laporan Power BI berbasis penyimpanan.


KontainerEksporTidakValid

Tingkat keparahan: Kritis

File ini terlihat seperti mungkin diekspor dari Cost Management tetapi tidak ada dalam kontainer yang benar.

Mitigasi: Perbarui ekspor Cost Management Anda untuk mengarahkan ke kontainer penyimpanan 'msexports'. Kontainer 'ingesti' hanya digunakan untuk melakukan kueri terhadap data biaya yang diingesti.


VersiEksporTidakValid

Tingkat keparahan: Kritis

Pusat FinOps memerlukan ekspor biaya FOCUS, tetapi file ini terlihat seperti ekspor manajemen biaya versi lama.

Mitigasi: Buat ekspor Cost Management baru untuk biaya FOCUS dan hentikan ekspor saat ini atau ubah untuk mengekspor ke kontainer penyimpanan yang berbeda.


VersiHubTidakValid

Tingkat keparahan: Kritis

Hub FinOps 0.1.1 dan yang lebih lama tidak berfungsi dengan laporan Power BI penyerapan data.

Mitigasi: Tingkatkan ke versi terbaru dari FinOps hubs atau unduh laporan Power BI dari rilis 0.1.1.


ID Lingkup Tidak Valid

Tingkat keparahan: Informasi

Jalur ekspor bukan ID ruang lingkup yang valid. Hub FinOps mengharapkan jalur ekspor adalah ID sumber daya Azure untuk cakupan di mana ekspor dibuat, guna menyederhanakan manajemen. Ini seharusnya tidak menyebabkan kegagalan, tetapi mungkin mengakibatkan laporan terkait cakupan menjadi membingungkan.

Mitigasi: Perbarui jalur penyimpanan untuk ekspor Pengelolaan Biaya dengan menggunakan ID sumber daya Azure yang lengkap untuk cakupan.


LegacyFocusVersion

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan ketika data yang diserap menggunakan versi FOCUS yang lebih lama. Jika ditemukan di kolom x_SourceChanges, kode ini hanya untuk informasi. Saat ditampilkan dalam laporan penyimpanan Power BI ketika kueri Biaya gagal dimuat, ini berarti parameter Tidak Digunakan Lagi: Melakukan Pengoptimalan Kueri Ekstra dinonaktifkan.

Hub FinOps mengonversi data ke versi FOCUS terbaru sehingga ini seharusnya tidak menyebabkan masalah; namun, transformasi modernisasi tidak dapat memperhitungkan semua skenario dan dapat mengakibatkan hasil yang tidak terduga dalam beberapa kasus. Silakan merujuk pada dokumentasi untuk masalah yang sudah diketahui.

Mitigasi: Ada beberapa cara untuk mengurangi pesan ini, tergantung pada alat mana yang Anda gunakan.

Jika Anda menggunakan hub FinOps dengan Data Explorer dan melihat hal ini di kolom x_SourceChanges pada tabel Biaya atau fungsi terkait, perbarui ekspor biaya dari Cost Management untuk menggunakan versi terbaru dari FOCUS. Tidak ada perubahan tambahan yang perlu dilakukan. Semua data akan digabungkan selama pemrosesan Data Explorer.

Jika menggunakan laporan penyimpanan dan melihat ini di kolom x_SourceChanges kueri Biaya, pesan ini adalah peringatan bahwa versi FOCUS ini akan dihapus dalam pembaruan mendatang. Meskipun Anda dapat mengabaikan pesan ini dengan aman, pesan ini akan memerlukan pembaruan dalam rilis mendatang. Untuk menghindari pesan, perbarui ekspor Cost Management ke versi FOCUS terbaru, hapus atau pindahkan data lama menggunakan versi FOCUS yang lebih lama, dan ekspor ulang data historis. Jika menggunakan hub FinOps, hapus atau pindahkan data dari wadah pengambilan . Jika Anda menghosting ekspor Anda sendiri di penyimpanan, ubah parameter URL Penyimpanan ke jalur folder lain yang tidak menyertakan versi FOCUS yang lebih lama.

Pada toolkit FinOps 0.7, dukungan untuk versi FOCUS yang lebih lama telah ditolak untuk meningkatkan performa dan skalabilitas. Sebaiknya perbarui ke versi FOCUS terbaru dan eksportasi ulang data untuk meningkatkan pengalaman Anda. Atur parameter Tidak Digunakan Lagi: Lakukan Pengoptimalan Kueri Ekstra ke TRUE untuk memastikan versi FOCUS yang lebih lama didukung dan atur ke FALSE untuk mempercepat performa dan mendukung himpunan data yang lebih besar yang mencakup lebih banyak biaya atau waktu. Pada 0,7, parameter ini diaktifkan secara default untuk kompatibilitas mundur. Di toolkit FinOps 0.8, toolkit akan dinonaktifkan secara default, tetapi masih tersedia untuk kompatibilitas mundur hingga pada atau setelah Juni 2025. Jika Anda tidak dapat memindahkan versi FOCUS lama atau untuk performa dan dukungan terbaik untuk akun yang lebih besar atau jangka waktu yang lebih lama, sebaiknya gunakan hub FinOps dengan Data Explorer.


Biaya Daftar Kurang dari Biaya Kontrak

Tingkat keparahan: Peringatan

ListCost (berdasarkan harga eceran publik) kurang dari ContractedCost (berdasarkan diskon yang dinegosiasikan) dalam data dari "Cost Management". Ini seharusnya tidak pernah terjadi. Ini akan menyebabkan perhitungan penghematan Anda tidak sesuai secara akurat.

Mitigasi: Konfirmasikan apakah ListUnitPrice dalam data biaya sesuai dengan yang ada dalam data harga. Jika harga daftar benar, ajukan permintaan dukungan kepada tim Cost Management untuk mengonfirmasi ListUnitPrice dan ContractedUnitPrice benar dan menjelaskan mengapa harga setelah diskon yang dinegosiasikan akan lebih tinggi dari tarif ritel publik.

Untuk detail tentang bagaimana masalah kualitas data memengaruhi penghitungan penghematan, lihat Memahami penghitungan penghematan.


ManifestReadFailed

Tingkat keparahan: Kritis

"Pipeline hub FinOps msexports_ExecuteETL gagal membaca file manifes Cost Management."

Mitigasi:

  1. Jika kesalahan terjadi pada contoh hub kerja ketika tidak ada perubahan yang dilakukan pada hub atau ekspor, maka Cost Management mungkin telah mengubah skema manifes untuk versi API yang ada.
  2. Jika kesalahan terjadi setelah Anda membuat ekspor baru atau mengubah ekspor yang ada, maka versi API ekspor mungkin menggunakan skema manifes baru yang tidak didukung.
  3. Jika kesalahan terjadi setelah penyebaran hub (penginstalan awal atau peningkatan), maka penyebaran mungkin gagal atau mungkin ada bug di alur.

Untuk mengonfirmasi skema manifes (#1) atau versi API (#2):

  1. Buka akun penyimpanan hub di portal Azure atau penjelajah penyimpanan.
  2. Jika di Portal Azure, buka Browser Penyimpanan dalam menu.
  3. Pilih kontainer msexports.
  4. Arahkan turun hierarki file untuk ekspor yang bermasalah (periksa lokasi manifes pada pesan kesalahan).
  5. Temukan file manifest.json dan pilih menu (⋯), lalu pilih Tampilkan/edit.
  6. Identifikasi properti berikut: 
    {
  "exportConfig": {
    "resourceId": "<scope-id>/providers/Microsoft.CostManagement/exports/<export-name>",
    "dataVersion": "<dataset-version>",
    "apiVersion": "2023-07-01-preview",
    "type": "<dataset-type>",
    ...
  },
  ...
}
  7. Konfirmasikan bahwa nilai tersebut diatur ke nilai yang didukung berikut ini:
    • resourceId dapat berupa ID cakupan dan nama ekspor apa pun, tetapi harus ada dengan jenis sumber daya "Microsoft.CostManagement/exports". Ini tidak sensitif terhadap huruf besar/kecil.
    • jenis harus ada, tetapi seharusnya tidak menyebabkan kegagalan dengan kesalahan ini untuk nilai yang tidak bernilai null apa pun.
    • dataVersion harus ada, tetapi seharusnya tidak gagal dengan kesalahan ini untuk nilai apapun yang bukan null.
    • apiVersion tidak digunakan secara eksplisit tetapi dapat menandakan perubahan pada skema manifes. Lihat versi API yang didukung untuk detailnya.
  8. Jika Anda menggunakan versi API yang lebih baru:
    1. Untuk melacak penambahan dukungan untuk versi API baru, buat masalah permintaan perubahan di GitHub.
    2. Hapus ekspor pada Cost Management.
    3. Buat ekspor menggunakan perintah PowerShell New-FinOpsCostExport menggunakan versi API yang didukung.

      Petunjuk / Saran

      Jika Anda menganggap diri Anda pengguna daya, Anda mungkin ingin mencoba memperbarui alur sendiri untuk resolusi tercepat. Untuk melakukannya, buka Data Factory, navigasikan ke Penulis > Pipelines > msexports_ExecuteETL, dan pilih aktivitas "Set" yang berlaku dan perbarui pengaturan Pengaturan>Nilai properti sesuai kebutuhan. Jika Anda melakukan ini, Anda tidak perlu membuat ulang ekspor dengan versi yang lebih lama. Mohon tetap laporkan masalah dan pertimbangkan untuk berbagi JSON baru dari ikon {} di bagian kanan atas desainer pipeline.

  9. Jika Anda melihat properti berubah untuk versi API yang didukung:
    1. Untuk melacak perubahan yang melanggar, buat masalah permintaan perubahan di GitHub. Sertakan jenis, dataVersion, dan apiVersion dari file manifest.json Anda.
    2. Kirimkan permintaan dukungan ke Cost Management untuk meminta agar perubahan mereka dibatalkan karena itu menjadikan masalah bagi semua orang yang menggunakan hub FinOps atau solusi kustom lainnya. Sertakan detail berikut untuk membantu tim dukungan Cost Management mengidentifikasi masalah dalam sistem mereka. Manajemen Biaya tidak memiliki konteks mengenai hub FinOps, jadi Anda harus menjaga detail tetap berfokus pada fungsionalitas Manajemen Biaya. Berikut adalah contohnya:

      Saya menggunakan ekspor Manajemen Biaya untuk mengambil data biaya saya ke ADLS. Saya memiliki alur ADF yang memproses data saat file manifes ditulis. Alur saya dibangun pada versi API <your-supported-api-version> yang mengharuskan properti-properti exportConfig.resourceId, exportConfig.type, dan exportConfig.dataVersion dikirimkan secara konsisten. Saya melihat file-file ini tidak disertakan dalam file manifes untuk versi API ini untuk ekspor saya yang berjalan pada <your-export-date>. Harapan saya adalah bahwa file manifes tidak boleh berubah untuk versi API yang ada. Bisakah Anda mengembalikan perubahan ini?

      Untuk membantu Anda memecahkan masalah, berikut adalah file manifes saya: {your-manifest-json}

Jika properti manifes sudah sesuai dan itu merupakan instans hub FinOps baru atau yang telah ditingkatkan, konfirmasikan proses penyebaran:

  1. Buka grup sumber daya hub di portal Azure.
  2. Pilih Pengaturan>Penyebaran di menu di sebelah kiri.
  3. Pastikan bahwa semua penyebaran berhasil. Secara khusus, cari nama penyebaran berikut:
    • utama
    • hub
    • dataFactoryResources
    • penyimpanan
    • Kunci Berkas
  4. Jika ada penyebaran yang gagal, tinjau pesan kesalahan untuk menentukan apakah itu sesuatu yang dapat Anda atasi sendiri (misalnya, konflik nama, pelanggaran kebijakan yang dapat diperbaiki).
  5. Jika kesalahan tampak sementara, coba sebarkan lagi.
  6. Jika kesalahan berlanjut, buat diskusi untuk melihat apakah ada orang lain jika menghadapi masalah atau mengetahui kemungkinan solusi (terutama untuk masalah kebijakan).
  7. Jika kesalahan jelas merupakan bug atau kekurangan fitur, buat isu bug atau permintaan fitur di GitHub.

Kami mencoba menanggapi masalah dan diskusi dalam waktu tiga hari kerja. Butuh bantuan langsung? Bergabunglah dengan sesi konsultasi dua mingguan kami.


Biaya Kontrak Hilang

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di x_SourceChanges kolom ketika ContractedCost null atau 0 dan EffectiveCost lebih besar dari 0. Kesalahan menunjukkan Microsoft Cost Management tidak menyertakan ContractedCost untuk baris yang ditentukan, yang berarti penghitungannya tidak dapat dilakukan.

Mitigasi: Sebagai solusi untuk data yang hilang, toolkit FinOps melaporkan salin EffectiveCost ke dalam ContractedCost kolom untuk baris yang ditandai dengan kode kesalahan ini. Penghematan tidak tersedia untuk rekaman ini.

Untuk menghitung penghematan lengkap, Anda dapat menggabungkan data biaya dan penggunaan dengan harga. Untuk informasi selengkapnya, lihat masalah #873.


Harga Satuan Kontrak yang Hilang

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di x_SourceChanges kolom ketika ContractedUnitPrice null atau 0 dan EffectiveUnitPrice lebih besar dari 0. Kesalahan menunjukkan Microsoft Cost Management tidak menyertakan ContractedUnitPrice untuk baris yang ditentukan, yang berarti penghitungannya tidak dapat dilakukan.

Mitigasi: Sebagai solusi untuk data yang hilang, toolkit FinOps melaporkan salin EffectiveUnitPrice ke dalam ContractedUnitPrice kolom untuk baris yang ditandai dengan kode kesalahan ini. Penghematan tidak tersedia untuk rekaman ini.

Untuk menghitung penghematan lengkap, Anda dapat menggabungkan data biaya dan penggunaan dengan harga. Untuk informasi selengkapnya, lihat masalah #873.

Untuk detail tentang bagaimana harga yang hilang memengaruhi penghitungan penghematan, lihat Memahami perhitungan penghematan.


BiayaDaftarHilang

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di x_SourceChanges kolom ketika ListCost null atau 0 dan ContractedCost lebih besar dari 0. Kesalahan menunjukkan Microsoft Cost Management tidak menyertakan ListCost untuk baris yang ditentukan, yang berarti penghitungannya tidak dapat dilakukan.

Mitigasi: Sebagai solusi untuk data yang hilang, toolkit FinOps melaporkan salin ContractedCost ke dalam ListCost kolom untuk baris yang ditandai dengan kode kesalahan ini. Penghematan tidak tersedia untuk rekaman ini.

Untuk menghitung penghematan lengkap, Anda dapat menggabungkan data biaya dan penggunaan dengan harga. Untuk informasi selengkapnya, lihat masalah #873.


Daftar Harga Satuan yang Hilang

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di x_SourceChanges kolom ketika ListUnitPrice null atau 0 dan ContractedUnitPrice lebih besar dari 0. Kesalahan menunjukkan Microsoft Cost Management tidak menyertakan ListUnitPrice untuk baris yang ditentukan, yang berarti penghitungannya tidak dapat dilakukan.

Mitigasi: Sebagai solusi untuk data yang hilang, toolkit FinOps melaporkan salin ContractedUnitPrice ke dalam ListUnitPrice kolom untuk baris yang ditandai dengan kode kesalahan ini. Penghematan tidak tersedia untuk rekaman ini.

Untuk menghitung penghematan lengkap, Anda dapat menggabungkan data biaya dan penggunaan dengan harga. Untuk informasi selengkapnya, lihat masalah #873.

Untuk detail tentang bagaimana harga yang hilang memengaruhi penghitungan penghematan, lihat Memahami perhitungan penghematan.


NamaPenyediaHilang

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di kolom x_SourceChanges saat ProviderName null. Kesalahan menunjukkan penyedia himpunan data (misalnya, Microsoft Cost Management) tidak menyertakan nilai ProviderName untuk baris yang ditentukan.

Mitigasi: Sebagai solusi untuk data yang hilang, laporan toolkit FinOps mencoba mengidentifikasi penyedia berdasarkan kolom yang tersedia.


Kueri '...' mereferensikan kueri atau langkah lain

Tingkat Keparahan: Ringan

Sumber kesalahan ini tidak diketahui. Kesalahan ini mungkin muncul secara acak saat menyegarkan data Power BI.

Mitigasi: Jika Anda menerima kesalahan ini, pilih Terapkan perubahan lagi.

Kesalahan ini hanya dilaporkan dalam laporan penyimpanan. Jika Anda memiliki waktu refresh data yang lama atau sering mengalami kesalahan ini, pertimbangkan untuk beralih ke hub FinOps dengan Data Explorer. Data Explorer menggunakan laporan KQL yang tidak memerlukan penjadwalan atau refresh bertahap. Data ditarik saat laporan dibuka, sehingga laporan selalu menampilkan data terbaru.


PengecualianAksesSumberdayaDilarang

Tingkat Keparahan: Utama

Power BI: Pengecualian jenis 'Microsoft.Mashup.Engine.Interface.ResourceAccessForbiddenException' dilemparkan

Menunjukkan bahwa akun yang memuat data di Power BI tidak memiliki peran Pembaca Data Blob Penyimpanan. Berikan peran ini ke data pemuatan akun di Power BI.


Ukuran muatan respons adalah... yang telah melampaui batas

Tingkat Keparahan: Utama

Kueri Azure Resource Graph dalam laporan Power BI pengoptimalan Tata Kelola dan Beban Kerja mungkin mengembalikan kesalahan yang mirip dengan:

Kesalahan OLE DB atau ODBC: [Expression.Error] Harap berikan info di bawah ini saat meminta dukungan: tanda waktu = {timestamp}, correlationId = {guid}. Detail: Ukuran payload respons adalah {number}, dan telah melebihi batas 16777216. Harap pertimbangkan untuk mengkueri lebih sedikit data sekaligus dan melakukan panggilan paginasi jika diperlukan.

Kesalahan ini berarti Anda memiliki lebih banyak sumber daya daripada yang didukung dalam kueri Resource Graph yang tidak difilter. Ini terjadi karena laporan toolkit FinOps dirancang untuk menampilkan detail tingkat sumber daya dan tidak diagregasi. Mereka dirancang untuk lingkungan berukuran kecil dan menengah dan tidak dirancang untuk mendukung organisasi dengan jutaan sumber daya.

Mitigasi: Jika Anda mengalami error ini, ada beberapa pilihan:

  • Hapus kolom yang tidak diperlukan untuk kebutuhan Anda.
  • Filter kueri untuk mengembalikan lebih sedikit sumber daya berdasarkan apa yang paling penting bagi Anda (misalnya, langganan, tag).
  • Nonaktifkan kueri agar tidak menghalangi kueri lain untuk berjalan.

PembaruanPenugasanPeranTidakDiizinkan

Tingkat Keparahan: Ringan

Jika Anda menghapus hub FinOps dan mencoba menyebarkannya kembali dengan nilai yang sama, termasuk nama Identitas Terkelola, Anda mungkin mengalami masalah yang diketahui berikut ini:

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

Mitigasi: Untuk memperbaiki masalah tersebut, Anda harus menghapus identitas kedaluarsa:

  • Navigasi ke akun penyimpanan dan pilih Kontrol akses (IAM) di menu.
  • Pilih tab Penetapan peran.
  • Temukan semua penugasan peran yang memiliki identitas "tidak diketahui" dan hapus.

PenugasanPeranAda

Tingkat Keparahan: Ringan

Saat meningkatkan hub FinOps dari satu versi ke versi lainnya, Anda mungkin mengalami kesalahan berikut jika penetapan peran yang dibuat dalam penyebaran sebelumnya masih ada:

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

Ini kemungkinan karena identitas terkelola dihapus secara eksplisit tanpa terlebih dahulu menghapus semua penetapan perannya.

Mitigasi: Untuk memperbaiki masalah ini, hapus penetapan peran yatim di portal Azure.

  • Navigasi ke grup sumber daya atau sumber daya yang terpengaruh (seperti kluster Data Explorer).
  • Pilih Kontrol akses (IAM) di menu.
  • Pilih tab Penetapan peran.
  • Temukan penugasan peran yang identitasnya tidak diketahui dan hapus.

PemuatanSkemaGagal

Tingkat keparahan: Kritis

Pipeline msexports_ETL_ingestion hub FinOps gagal memuat file skema.

Mitigasi: Tinjau pesan kesalahan untuk mencatat jenis dan versi himpunan data, yang diformat dengan garis bawah (misalnya, <type>_<version> atau FocusCost_1.0). Konfirmasikan bahwa himpunan data dan jenis keduanya didukung oleh versi hub FinOps yang disebarkan. Lihat himpunan data yang didukung untuk detailnya.


SkemaTidakDitemukan

Tingkat keparahan: Kritis

Alur msexports_ExecuteETL hub FinOps tidak dapat menemukan file pemetaan skema untuk dataset yang diekspor.

Mitigasi: Konfirmasikan jenis dan versi himpunan data didukung. Lihat himpunan data yang didukung untuk detailnya. Jika himpunan data didukung, konfirmasikan versi hub dengan laporan Penyerapan data.

Untuk menambahkan dukungan untuk himpunan data lain, buat file pemetaan kustom dan simpan ke config/schemas/<dataset-type>_<dataset-version>.json. Nilainya <dataset-type><dataset-version> sangat cocok dengan apa yang digunakan Cost Management. Untuk mengidentifikasi jenis data untuk setiap kolom, gunakan file skema yang ada sebagai templat. Beberapa himpunan data memiliki skema yang berbeda untuk EA dan Perjanjian Pelanggan Microsoft (MCA). Mereka tidak dapat diidentifikasi melalui atribut ini dan dapat menyebabkan masalah jika Anda memiliki kedua jenis akun. Kami sedang berupaya menambahkan himpunan data dan memperhitungkan perbedaan antara EA dan MCA dengan menyelaraskannya ke FOCUS.


URL Penyimpanan impor tidak cocok dengan ekspor

Tingkat Keparahan: Utama

Jika Anda mengalami ini dalam laporan toolkit 0.8 FinOps, kesalahannya adalah karena referensi ke parameter yang tidak ada.

Mitigasi: Ini diperbaiki di toolkit FinOps 0.9. Perbarui ke rilis terbaru untuk menerapkan perbaikan. Jika Anda perlu menerapkan perbaikan langsung ke laporan 0.8, edit fungsi ftk_DemoFilter di editor tingkat lanjut dan ubah konten menjadi: () => "". Simpan, lalu tutup dan terapkan semua perubahan.


File Ekspor Tidak Dikenal

Tingkat keparahan: Informasi

File di penyimpanan hub tidak terlihat seperti diekspor dari Cost Management. File diabaikan.

Mitigasi: Kontainer msexports hanya ditujukan untuk ekspor Cost Management. Pindahkan file lain di kontainer penyimpanan lain.


VersiFokusTidakDiketahui

Tingkat keparahan: Informasi

Kode kesalahan ini ditampilkan di kolom x_SourceChanges saat versi FOCUS tidak dapat diidentifikasi.

Mitigasi: Validasi bahwa himpunan data FOCUS menggunakan versi FOCUS yang didukung. Laporkan masalah ini dengan sampel data yang dianonimkan di https://aka.ms/ftk/ideas untuk menyelidiki lebih lanjut.


VersiHubTidakDiketahui

Tingkat keparahan: Kritis

Tidak dapat mengidentifikasi versi hub FinOps dari file pengaturan. Verifikasi pengaturan sudah benar. Hub FinOps 0.1.1 dan yang lebih lama tidak berfungsi dengan laporan Power BI ini.

Mitigasi: Tingkatkan ke versi terbaru hub FinOps atau unduh laporan Power BI dari rilis toolkit FinOps v0.1.1.


JenisFileEksporTidakDidukung

Tingkat keparahan: Kritis

Tidak dapat menyerap file ekspor yang ditentukan karena tipe file tidak didukung.

Mitigasi: Konversikan file ke format file yang didukung sebelum menambahkan ke kontainer msexports atau tambahkan dukungan untuk mengonversi jenis file baru ke alur msexports_ETL_ingestion .


TipeEksporTidakDidukung

Tingkat keparahan: Peringatan

Manifes ekspor dalam penyimpanan hub menunjukkan ekspor adalah untuk himpunan data yang tidak didukung. Data yang diekspor dilaporkan sebagai kesalahan pengolahan.

Mitigasi: Buat ekspor Cost Management baru untuk biaya FOCUS dan hentikan ekspor saat ini atau ubah untuk mengekspor ke kontainer penyimpanan yang berbeda.


Penyedia sumber daya {name} tidak terdaftar dalam langganan {guid}

Tingkat Keparahan: Ringan

Buka langganan di portal Azure, lalu pilih Pengaturan>Penyedia sumber daya, pilih baris penyedia sumber daya (misalnya, Microsoft.EventGrid), lalu pilih perintah Daftar di bagian atas halaman. Pendaftaran mungkin memakan waktu beberapa menit.


x_PricingSubcategory menampilkan ID diskon komitmen

Ekspor Cost Management sebelum 28 Februari 2024 memiliki bug di mana x_PricingSubcategory salah ditetapkan untuk penggunaan yang telah dikomitmenkan. Anda harus mengharapkan untuk melihat nilai seperti Committed Spend dan Committed Usage. Sebagai gantinya, Anda mungkin melihat nilai seperti:

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

Jika Anda melihat nilai-nilai ini, ekspor ulang data biaya untuk bulan tersebut. Jika Anda perlu mengekspor data untuk bulan yang lebih lama yang tidak tersedia, hubungi dukungan untuk meminta data diekspor bagi Anda untuk mengatasi masalah kualitas data dari eksekusi ekspor sebelumnya.


Power BI: Laporan kehilangan data untuk tanggal tertentu

Jika laporan Anda kehilangan semua data selama satu atau beberapa bulan, periksa parameter Jumlah Bulan, RangeStart, dan RangeEnd untuk memastikan data tidak difilter.

Untuk memeriksa parameter, pilih Transform data>Edit parameters di ribbon atau pilih parameter individual di folder 🛠️ dari jendela editor kueri.

  • Jika Anda ingin selalu menampilkan jumlah tertentu bulan terakhir, atur Jumlah Bulan ke jumlah bulan tertutup (selesai). Bulan ini adalah bulan ekstra yang ditambahkan dari jumlah bulan yang telah lengkap.
  • Jika Anda menginginkan rentang tanggal tetap yang tidak berubah dari waktu ke waktu (misalnya, pelaporan tahun fiskal), atur RangeStart dan RangeEnd.
  • Jika Anda ingin melaporkan semua data yang tersedia, konfirmasikan bahwa ketiga parameter tanggal kosong.

Untuk informasi selengkapnya, lihat Menyiapkan laporan pertama Anda.


Power BI: Laporan kosong (tanpa data)

Jika Anda tidak melihat data apa pun di Power BI atau laporan atau alat lain, coba yang berikut ini berdasarkan sumber data Anda:

  1. Jika menggunakan konektor Cost Management di Power BI, periksa parameter Billing Account ID dan Number of Months untuk memastikan bahwa parameter-parameter tersebut diatur dengan benar. Perlu diingat akun penagihan lama mungkin tidak memiliki data dalam beberapa bulan terakhir.
  2. Jika menggunakan hub FinOps, periksa akun penyimpanan untuk memastikan data diisi dalam kontainer penyerapan . Anda seharusnya melihat folder penyedia atau langganan. Gunakan bagian berikut untuk memecahkan masalah lebih lanjut.

Hub FinOps: Kontainer ingesti kosong

Jika kontainer pengumpulan data kosong, buka instans Data Factory di Data Factory Studio dan pilih Kelola>Penulis>Pemicu dan verifikasi pemicu msexports_FileAdded dimulai. Jika tidak, mulailah.

Jika pemicu gagal dimulai dengan kesalahan "penyedia sumber daya tidak terdaftar", buka langganan di portal Azure, lalu pilih Pengaturan>Penyedia sumber daya, pilih baris Microsoft.EventGrid, lalu pilih Perintah Daftar di bagian atas halaman. Pendaftaran mungkin memakan waktu beberapa menit.

Setelah proses pendaftaran selesai, mulai kembali pemicu msexports_FileAdded.

Setelah pemicu dimulai, jalankan ulang semua ekspor yang terhubung ke Cost Management. Data harus sepenuhnya diserap dalam waktu 10-20 menit, tergantung pada ukuran akun.

Jika masalah terus berlanjut, periksa apakah ekspor Cost Management telah dikonfigurasi dengan mengaktifkan partisi file. Jika Anda menemukan bahwa itu dinonaktifkan, aktifkan dan lakukan ekspor kembali.

Pastikan kontainer pengambilan data sudah terisi dan perbarui laporan Anda atau alat terhubung lainnya.

Hub FinOps: File yang tersedia dalam wadah penerimaan

Jika kontainer pengumpulan data tidak kosong, konfirmasikan apakah Anda memiliki file parquet atau csv.gz dengan menelusuri folder.

Setelah Anda tahu, verifikasi parameter FileType diatur ke .parquet atau .gz di laporan Power BI. Lihat Menyambungkan ke data Anda untuk informasi lebih lanjut.

Jika Anda menggunakan alat lain, pastikan alat tersebut mendukung jenis file yang Anda gunakan.


Power BI: Nama host tidak dapat dipecahkan: '<storage-account>.dfs.core.windows.net'

Menunjukkan bahwa nama akun penyimpanan salah. Jika menggunakan hub FinOps, verifikasi parameter StorageUrl saat penyebaran. Lihat Menyambungkan ke data Anda untuk informasi lebih lanjut.


Power BI: Kami tidak dapat mengonversi nilai null ke tipe logis

Menandakan bahwa parameter Akun Penagihan ID kosong. Jika menggunakan hub FinOps, atur nilai ke ID akun penagihan yang diinginkan. Jika Anda tidak memiliki akses ke akun penagihan atau tidak ingin menyertakan pembelian dan pengembalian dana komitmen, atur nilai ke 0 dan buka kueri CostDetails di editor tingkat lanjut dan ubah 2 menjadi 1. Ini memberi tahu laporan agar tidak memuat data biaya sesungguhnya/ditagih dari konektor Manajemen Biaya. Lihat Menyambungkan ke data Anda untuk informasi lebih lanjut.

Versi yang berlaku: 0.1 - 0.1.1 (diperbaiki dalam 0,2)


Power BI: Kami tidak dapat mengonversi nilai null untuk mengetik Tabel

Tingkat keparahan: Kritis

Kesalahan ini dapat terjadi saat menyambungkan laporan penyimpanan Power BI ke akun penyimpanan menggunakan titik akhir Blob alih-alih titik akhir Data Lake Storage (DFS) yang diperlukan.

Mitigasi: Perbarui parameter URL Penyimpanan Anda untuk menggunakan titik akhir Data Lake Storage:

  1. Ubah .blob.core.windows.net ke .dfs.core.windows.net di URL Penyimpanan Anda.
  2. Jika menggunakan portal Microsoft Azure:
    • Buka akun penyimpanan Anda
    • PilihPengaturan>Titik Akhir
    • Salin URL Data Lake Storage (bukan URL layanan Blob)

Contohnya:

  • ❌ Salah: https://mystorageaccount.blob.core.windows.net/container
  • ✅ Benar: https://mystorageaccount.dfs.core.windows.net/container

Jika Anda masih mengalami masalah setelah menggunakan titik akhir yang benar, lihat hub FinOps: Kami tidak dapat mengonversi nilai null ke tipe Tabel untuk langkah-langkah pemecahan masalah tambahan.


Hub FinOps: Kami tidak dapat mengonversi nilai null untuk mengetik Tabel

Kesalahan ini biasanya menunjukkan bahwa data tidak dimasukkan ke kontainer ingesti.

Jika Anda baru saja memutakhirkan ke hub FinOps 0.2, masalahnya dapat mengakibatkan laporan Power BI menjadi lama (dari 0.1.x) atau karena Anda tidak menggunakan ekspor FOCUS. Lihat Panduan peningkatan untuk detailnya.

Lihat Laporan kosong (tanpa data) untuk langkah-langkah pemecahan masalah selengkapnya.


Berikan umpan balik

Beri tahu kami bagaimana kinerja kami melalui ulasan singkat. Kami menggunakan ulasan ini untuk meningkatkan dan memperluas alat dan sumber daya FinOps.

Berikan umpan balik

Jika Anda mencari sesuatu yang spesifik, pilih yang sudah ada atau buat ide baru. Bagikan ide dengan orang lain untuk mendapatkan lebih banyak suara. Kami fokus pada ide-ide dengan suara terbanyak.

Memilih atau menyarankan ide


Konten terkait

Jika Anda tidak melihat kesalahan yang Anda alami, telusuri panduan pemecahan masalah. Jika Anda memiliki pertanyaan, mulai diskusi atau buat masalah di GitHub.


  • Last updated on