Melihat log kesalahan portal
Catatan
Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.
Administrator dan pengembang portal menggunakan portal Power Apps untuk membuat situs web untuk pelanggan mereka. Pengembang sering melakukan debug masalah saat mengembangkan portal. Untuk membantu debug, Anda dapat mengakses log kesalahan rinci untuk setiap masalah pada portal. Ada beberapa cara bahwa Anda bisa mendapatkan log kesalahan untuk portal.
Catatan
Log kesalahan portal Power Apps juga digunakan untuk Power Pages. Informasi selengkapnya, Apa itu Power Pages
Tip
Untuk mempelajari tentang peran yang diperlukan untuk melakukan tugas dalam artikel ini, baca peran admin yang diperlukan untuk tugas administratif portal.
Kesalahan kustom
Jika ada pengecualian sisi server terjadi di portal Anda, halaman kesalahan yang disesuaikan dengan pesan kesalahan yang mudah digunakan ditampilkan secara default. Untuk mengkonfigurasi pesan kesalahan, lihat menampilkan pesan kesalahan kustom.
Namun, ada baiknya untuk melihat halaman kesalahan rinci ASP.NET, juga dikenal sebagai layar kuning kematian (YSOD), untuk tujuan Pelacakan. Halaman kesalahan rinci membantu Anda untuk mendapatkan susunan lengkap kesalahan server.
Untuk mengaktifkan YSOD, Anda harus menonaktifkan kesalahan kustom pada portal.
Catatan
Dianjurkan untuk hanya menonaktifkan kesalahan kustom ketika Anda berada dalam tahap pengembangan dan mengaktifkan kesalahan kustom setelah aktif.
Informasi lebih lanjut tentang kesalahan kustom: menampilkan halaman kesalahan kustom
Nonaktifkan kesalahan kustom
Anda dapat menonaktifkan kesalahan kustom pada portal untuk menampilkan pesan pengecualian rinci jika pengecualian sisi server apa pun yang terjadi di portal Anda.
Buka tindakan Portal > menonaktifkan kesalahan kustom.
Pilih nonaktifkan di pesan konfirmasi. Sementara kesalahan kustom dinonaktifkan, portal diaktifkan ulang dan tidak akan tersedia. Pesan muncul ketika kesalahan kustom dinonaktifkan.
Aktifkan kesalahan kustom
Anda dapat mengaktifkan kesalahan kustom pada portal untuk menampilkan halaman yang tampak profesional, bukan YSOD. Halaman ini menyediakan informasi yang memiliki arti jika ada pengecualian yang terjadi di aplikasi.
Buka tindakan Portal > aktifkan kesalahan kustom.
Pilih aktifkan di pesan konfirmasi. Sementara kesalahan kustom diaktifkan, portal diaktifkan ulang dan tidak akan tersedia. Pesan muncul ketika kesalahan kustom diaktifkan.
Catatan
- Jika Anda mengubah instans yang terhubung ke portal Anda, pengaturan kesalahan kustom diatur ke diaktifkan. Anda harus menonaktifkan kesalahan kustom lagi, jika diperlukan.
- Anda tidak boleh mengaktifkan atau menonaktifkan kesalahan kustom saat instans yang terhubung ke portal Anda diubah; Jika tidak dilakukan, pesan kesalahan akan ditampilkan.
Menampilkan pesan kesalahan kustom
Anda dapat mengkonfigurasi portal untuk menampilkan kesalahan kustom yang tampak profesional, bukan kesalahan generik.
Untuk menentukan kesalahan kustom, gunakan potongan konten Portal Generic Error. Konten yang ditentukan dalam potongan ini akan ditampilkan pada halaman kesalahan. Potongan konten ini tidak tersedia siap pakai dan Anda harus membuat. Potongan konten jenis dapat berupa teks atau HTML. Untuk membuat atau mengedit potongan konten, lihat menyesuaikan konten menggunakan potongan konten.
Catatan
Jika kode liquid tertulis dalam potongan konten, akan diabaikan dan tidak ditampilkan.
Bila Anda mengaktifkan kesalahan kustom, pesan muncul dalam struktur berikut pada halaman kesalahan:
<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>
Berikut adalah contoh pesan kesalahan kustom, menggunakan potongan konten jenis HTML:
Ini merupakan kesalahan kustom, Minta dukungan pusat bantuan dengan tangkapan layar kesalahan dengan mengklik di sini
Catatan
Jika portal tidak dapat mengambil potongan konten karena tidak dapat terhubung ke Microsoft Dataverse atau jika potongan tidak tersedia di Dataverse, pesan kesalahan ditampilkan.
Akses log kesalahan portal
Setelah mengembangkan dan mempublikasi portal, Anda tetap perlu untuk dapat mengakses log portal untuk men-debug masalah yang dilaporkan oleh pelanggan. Untuk mengakses log, konfigurasikan portal Anda untuk mengirim semua kesalahan aplikasi ke akun penyimpanan Azure Blob yang dimiliki oleh Anda. Dengan mengakses log portal kesalahan, Anda dapat merespons kueri pelanggan secara efisien karena Anda memiliki rincian masalah. Untuk menerima log kesalahan portal dalam penyimpanan Azure Blob Anda, Anda harus mengaktifkan log diagnostik dari pusat Admin Portal Power Apps.
Catatan
Jika Anda mengubah instans Dataverse yang terhubung ke portal Anda, log diagnostik dinonaktifkan. Anda harus mengaktifkan log diagnostik lagi.
Aktifkan pencatatan diagnostik
Buka tindakan Portal > mengaktifkan log diagnostik.
Di jendela Aktifkan log diagnostik, masukkan nilai berikut:
- String Sambungan Layanan Azure Blob Storage: URL layanan String Sambungan Layanan Azure Blob Storage untuk menyimpan log kesalahan portal. Panjang maksimum URL adalah 2048 karakter. Jika URL lebih dari 2048 karakter, pesan kesalahan akan ditampilkan. Informasi lebih lanjut tentang string koneksi: Konfigurasi string koneksi Azure Storage
- Pilih periode penyimpanan: durasi untuk menyimpan log kesalahan portal di penyimpanan blob. Log kesalahan akan dihapus setelah durasi yang dipilih. Anda dapat memilih salah satu dari nilai berikut ini:
- Satu hari
- Tujuh Hari
- 30 hari
- 60 hari
- 90 hari
- 180 hari
- Selalu
Secara default, periode penyimpanan adalah 30 hari.
Pilih mengkonfigurasi.
Setelah log diagnosis dikonfigurasi, wadah blob log telemetri baru dibuat dalam akun Azure storage dan log ditulis ke file blob yang tersimpan dalam wadah. Screenshot berikut menunjukkan wadah blob log telemetri penjelajah Azure Storage Explorer:
Ketika log diagnostik sukses diaktifkan, tindakan berikut akan tersedia:
- Memperbarui konfigurasi log diagnostik: Anda dapat memperbarui atau menghapus konfigurasi log diagnostik untuk portal.
- Menonaktifkan log diagnostik: Agar Anda dapat menonaktifkan konfigurasi log diagnostik untuk portal.
Memperbarui pencatatan diagnostik
Buka Tindakan Portal > Perbarui Konfigurasi Pencatatan Diagnostik.
Di jendela Perbarui konfigurasi log diagnostik, masukkan nilai berikut:
- Apakah Anda ingin memperbarui string koneksi layanan Azure Blob Storage?: Memungkinkan Anda untuk menentukan apakah akan memperbarui string koneksi layanan Azure Blob Storage. Secara default, ini dipilih.
- String Sambungan Layanan Azure Blob Storage: URL layanan String Sambungan Layanan Azure Blob Storage untuk menyimpan log kesalahan portal. Panjang maksimum URL dapat sepanjang 2048 karakter. Jika URL lebih dari 2048 karakter, pesan kesalahan akan ditampilkan. Bidang ini akan ditampilkan hanya jika kotak centang Apakah Anda ingin memperbarui string koneksi layanan Azure Blob Storage? dipilih. Informasi lebih lanjut tentang string koneksi: Konfigurasi string koneksi Azure Storage
- Pilih periode penyimpanan: durasi untuk menyimpan log kesalahan portal di penyimpanan blob. Log kesalahan akan dihapus setelah durasi yang dipilih. Anda dapat memilih salah satu dari nilai berikut ini:
- Satu hari
- Tujuh Hari
- 30 hari
- 60 hari
- 90 hari
- 180 hari
- Selalu
Secara default, periode penyimpanan adalah 30 hari.
Pilih Perbarui.
Nonaktifkan pencatatan diagnostik
Buka tindakan Portal > Menonaktifkan log diagnostik.
Pilih nonaktifkan di pesan konfirmasi.
Kesalahan plugin tampilan
Skenario lain yang sering terjadi ketika mengembangkan portal tersebut adalah kesalahan yang dihasilkan plug-in kustom dan logika bisnis yang tertulis dalam lingkungan Dataverse Anda. Kesalahan ini biasanya dapat diakses dengan menonaktifkan kesalahan kustom atau mengaktifkan log diagnostik. Ada kalanya lebih cepat untuk menampilkan kesalahan ini secara langsung pada portal untuk mendiagnosis masalah lebih cepat. Anda dapat menyelesaikannya dengan mengkonfigurasi portal untuk menampilkan kesalahan plugin kustom dari Dataverse pada layar portal.
Untuk menampilkan kesalahan plugin kustom, buat pengaturan situs Site/EnableCustomPluginError dan mengatur nilai ke benar. Kesalahan plugin kustom yang akan ditampilkan di layar bukan kesalahan generik. Kesalahan akan menampilkan hanya bagian pesan kesalahan plugin dan bukan jejak susunan lengkap.
Berikut adalah layar di mana kesalahan plugin kustom akan muncul:
- Daftar
- Pengambilan rekaman
- Formulir Dasar
- Ambil
- Membuat/memperbarui dan seterusnya
- Formulir Multilangkah
- Ambil
- Membuat/memperbarui dan seterusnya
Jika pengaturan situs tidak ada, maka akan dianggap salah secara default dan kesalahan plugin tidak akan disajikan.
Baca juga
Pemeliharaan dan pemecahan masalah portal Power App
Catatan
Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)
Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk