Bagikan melalui


Analisis log yang dihasilkan sistem menggunakan Application Insights

Anda dapat menyambungkan aplikasi kanvas ke, Application Insights fitur Azure Monitor. Application Insights menyertakan alat analitik yang canggih untuk membantu Anda mendiagnosis masalah dan memahami apa yang sebenarnya dilakukan pengguna dengan aplikasi Anda. Anda dapat mengumpulkan informasi untuk membantu mendorong keputusan bisnis yang lebih baik dan meningkatkan kualitas aplikasi Anda.

Prasyarat

Catatan

Untuk melihat informasi telemetri, admin penyewa Anda harus mengaktifkan wawasan aplikasi Canvas. Masuk sebagai admin di Power Platform Pusat Admin. Buka Pengaturan>Pengaturan penyewa>Wawasan aplikasi kanvas. Di panel wawasan aplikasi kanvas, atur sakelar ke Aktif dan simpan perubahan Anda. Untuk informasi lebih lanjut, lihat Pengaturan penyewa.

Buat sumber daya Application Insights

Sebelum dapat mengirim log yang dibuat sistem dari aplikasi, Anda perlu membuat Application Insights resource untuk menyimpan peristiwa.

Buat sumber daya berbasis ruang kerja untuk di Application Insights portal Microsoft Azure.

Sambungkan ke aplikasi Anda ke Application Insights

Catatan

  • Saat menentukan string koneksi, ketahuilah bahwa data dapat dikirim di seluruh penyewa. Peristiwa pelacakan dikirim ke sumber daya App Insights yang sesuai dengan string koneksi yang Anda tetapkan untuk aplikasi Anda, bahkan jika instans App Insights target berada di penyewa yang berbeda dari aplikasi.
  • Berhati-hatilah saat mengimpor file .msapp yang ada karena string koneksi untuk App Insights mungkin ada. Buka aplikasi secara manual setelah impor untuk memverifikasi bahwa string koneksi App Insights yang benar sedang digunakan.
  1. Masuk ke Power Apps.

  2. Buka aplikasi untuk diedit .

  3. Pilih objek Aplikasi di tampilan pohon navigasi kiri dan tempelkan string Koneksi dari sumber daya Anda Application Insights :

    Tambahkan string koneksi.

  4. Simpan dan Publikasikan aplikasi Anda.

  5. Putar aplikasi yang dipublikasikan dan telusuri layar yang berbeda.

Saat Anda menjelajahi layar aplikasi, peristiwa akan dicatat Application Insights secara otomatis, termasuk detail penggunaan seperti:

  • Dari mana aplikasi diakses
  • Perangkat mana yang digunakan
  • Jenis browser yang digunakan

Penting

Anda harus memutar aplikasi yang dipublikasikan untuk mengirimkan aktivitas ke Application Insights. Aktivitas tidak dikirim ke Application Insights ketika Anda mempratinjau aplikasi di Power Apps Studio.

Lihat aktivitas di Application Insights

  1. Masuk ke portal Microsoft Azure dan buka sumber daya yang Application Insights Anda buat sebelumnya.

  2. Gulir ke bawah di panel navigasi kiri dan pilih Pengguna di bawah bagian Penggunaan .

    Catatan

    Tampilan Pengguna menampilkan detail penggunaan aplikasi, seperti:

    • Jumlah pengguna yang melihat aplikasi
    • Jumlah sesi pengguna
    • Jumlah peristiwa yang dicatat
    • Sistem operasi pengguna dan detail versi browser
    • Wilayah dan lokasi pengguna

    Pelajari lebih lanjut tentang analisis pengguna, sesi, dan peristiwa di. Application Insights

  3. Pilih salah satu sesi pengguna untuk menelusuri rincian spesifik. Anda dapat melihat informasi seperti panjang sesi dan layar yang dikunjungi:

    Detail penggunaan untuk pengguna.

  4. Pilih tampilan Peristiwa di panel navigasi kiri di bawah bagian Penggunaan. Anda dapat melihat ringkasan semua layar yang dilihat di semua sesi aplikasi:

    Detail acara untuk aplikasi.

Tip

Lebih banyak Application Insights fitur tersedia, seperti:

Buat aktivitas pelacakan kustom

Anda dapat menulis pelacakan kustom secara langsung ke Application Insights dan mulai menganalisis informasi yang spesifik dengan skenario Anda. Fungsi Trace memungkinkan Anda mengumpulkan:

  • Informasi penggunaan terperinci untuk kontrol di layar
  • Pengguna tertentu yang mengakses aplikasi Anda
  • Kesalahan apa yang terjadi

Pelacakan juga dapat membantu mendiagnosis masalah karena Anda dapat mengirimkan jejak informasi sebagai pengguna yang menelusuri melalui aplikasi Anda dan melakukan tindakan yang berbeda. Lacak pesan yang dikirim untuk Application Insights memiliki salah satu dari tiga tingkat keparahan:

  • Informasi
  • Peringatan
  • Kesalahan

Tergantung pada skenario, Anda dapat memilih untuk mengirim pesan pelacakan dengan tingkat keparahan yang sesuai. Anda dapat mengkueri data dan mengambil tindakan tertentu berdasarkan tingkat keparahannya.

Catatan

Jika Anda mencatat data pribadi apa pun, perhatikan kewajiban Anda sehubungan dengan berbagai undang-undang dan peraturan privasi. Lihat Pusat Kepercayaan Microsoft dan Portal Kepercayaan Layanan untuk informasi selengkapnya.

Sekarang buat komponen baru di aplikasi Anda untuk mengumpulkan umpan balik di setiap layar, dan tulis peristiwa tersebut Application Insights.

  1. Masuk ke Power Apps.

  2. Pilih Aplikasi di panel navigasi kiri. Dari daftar aplikasi, pilih aplikasi Kudos , lalu pilih Edit.

    Catatan

    Anda juga dapat membuat aplikasi baru atau mengedit aplikasi yang sudah ada.

  3. Pilih opsi Komponen pada tampilan Pohon:

    Komponen.

  4. Pilih Komponen baru, lalu ubah ukuran lebar menjadi 200 dan tinggi menjadi 75:

    Tinggi dan lebar.

  5. Pilih Sisipkan dari menu lalu pilih Ikon untuk menambahkan Emoji - Kerutan dan Emoji - Tersenyum:

    Tambahkan ikon.

  6. Pilih Properti kustom baru untuk membuat properti kustom:

    Buat properti kustom.

  7. Masukkan Nama properti dan Nama tampilan seperti FeedbackSceen.

  8. Masukkan properti Deskripsi.

  9. Pilih Jenis properti sebagai Input dan Tipe data sebagai Layar:

    Properti kustom.

    Catatan

    Properti input memungkinkan Anda untuk menangkap nama layar dan komponennya sehingga Anda dapat mencatat informasi ini ke Application Insights.

  10. Pilih komponen pada Tampilan Hierarkis, pilihTindakan lainnya( ...), lalu pilihGanti nama untuk mengganti nama komponen dengan nama yang bermakna seperti FeedbackComponent .

    Ganti nama komponen dan ikon.

  11. Pilih ikon, pilih Tindakan lainnya(...), lalu pilih Ganti nama untuk mengganti nama ikon dengan nama yang bermakna, seperti FrownIcon dan SmileIcon.

  12. Pilih FrownIcon, pilih properti OnSelect , lalu masukkan ekspresi berikut di bilah rumus:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeedbackValue: "-1"
           }
         );
    Notify("Thanks for your feedback!");
    

    Formula ikon cemberut.

    Catatan

    Ekspresi rumus mengirim UserName,UserEmail,Screen, dan Umpan Balik (dengan nilai-1 ) ke. Application Insights

  13. Pilih SmileIcon, pilih properti OnSelect , lalu masukkan ekspresi berikut di bilah rumus:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for your feedback!");
    
  14. Tambahkan komponen ke salah satu layar di aplikasi Anda:

    Tambahkan komponen umpan balik.

  15. Pilih Simpan lalu pilih Publikasikan untuk menyimpan dan menerbitkan aplikasi Anda.

  16. Putar aplikasi yang dipublikasikan, dan kirim tanggapan senyum dan murung dari layar Anda.

    Penting

    Anda harus memutar aplikasi yang dipublikasikan untuk mengirimkan aktivitas ke Application Insights. Aktivitas tidak dikirim ke Application Insights ketika Anda mempratinjau aplikasi di Power Apps Studio.

    Putar aplikasi yang diterbitkan.

Analisis data di Application Insights

Sekarang Anda dapat mulai menganalisis data yang Anda kirim menggunakan fungsi Pelacakan dari aplikasi Application Insights Anda.

  1. Masuk ke portal Microsoft Azure dan buka sumber daya yang Application Insights Anda buat sebelumnya:

    Pilih Application Insights.

  2. Pilih Log di bawah Pemantauan di panel navigasi kiri:

    Pilih Log.

  3. Masukkan kueri berikut dan pilih Jalankan untuk melihat umpan balik yang diterima dari aplikasi Anda:

    traces
    | where message == "App Feedback"
    | order by timestamp
    

    Lihat umpan balik aplikasi.

  4. Pilih baris di hasil dan perluas bidang customDimensions .

    Nilai untuk Screen,UserName,UserEmail, dan FeedbackValue untuk acara OnSelect dari ikon senyum atau cemberut di komponen Anda telah direkam. Nilai juga dicatat untuk setiap peristiwa yang dikirim, Application Insights seperti appId, appName, dan appSessionId.

    Perluas dimensi kustom.

  5. Dengan kueri contoh berikut, Anda dapat memperluas properti dimensi kustom JSON dan memproyeksikan kolom dalam tampilan hasil.

    traces
        | extend customdims = parse_json(customDimensions)
        | where message == "App Feedback"
        | project timestamp
            , message
            , AppName = customdims.['ms-appName']
            , AppId = customdims.['ms-appId']
            , FeedbackFrom = customdims.UserEmail
            , Screen = customdims.Screen
            , FeedbackValue = customdims.FeedbackValue
        | order by timestamp desc
    

    Perluas kueri customDimensions.

    Tip

    Kueri log sangat kuat. Anda dapat menggunakannya untuk masuk ke beberapa tabel, mengumpulkan data dalam jumlah besar, dan melakukan operasi yang rumit. Pelajari kueri log lebih lanjut.

Memantau kesalahan tidak tertangani (eksperimental)

[Bagian ini berisi dokumentasi prarilis dan dapat berubah.]

Penting

  • Ini adalah fitur eksperimental.
  • Fitur eksperimental tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Anda tidak selalu dapat mengantisipasi dan merencanakan semua kesalahan yang mungkin terjadi saat aplikasi Anda berjalan. Kesalahan rumus yang tidak ditangani Power Fx dilaporkan kepada pengguna sebagai pesan spanduk. Mereka juga dapat dilaporkan untuk Application Insights membantu Anda memahami frekuensi dan tingkat keparahannya tanpa bergantung pada pengguna aplikasi Anda untuk melaporkan masalah. Anda juga dapat menyiapkan pemberitahuan real-time saat terjadi error runtime untuk mengambil pendekatan yang lebih proaktif.

Aktifkan penerusan kesalahan ke Application Insights

Anda perlu mengaktifkan pengaturan yang memungkinkan Power Apps untuk meneruskan kesalahan runtime yang tidak tertangani ke Azure Application Insights.

Peringatan

Mengaktifkan pengaturan ini mungkin akan dikenakan biaya tambahan yang terkait dengan penyimpanan log Application Insights.

Untuk mengaktifkan kesalahan passing, buka Pengaturan Fitur yang > akan datang Kesalahan Eksperimental > Pass ke Azure > sambil menjaga aplikasi kanvas Anda tetap terbuka Application Insights untuk diedit. Simpan dan publikasikan aplikasi Anda.

Aktifkan Teruskan kesalahan ke pengaturan Azure Application Insights .

Peristiwa kesalahan di Application Insights

Error yang tidak tertangani Power Fx yang dialami pengguna pada runtime aplikasi dilaporkan ke tabel pelacakan . Kesalahan yang tidak ditangani dapat diidentifikasi dan dibedakan dari peristiwa kesalahan lainnya dengan pesan peristiwa "Kesalahan yang tidak ditangani". Dimensi "severityLevel" dari peristiwa ini adalah 3 (TraceSeverity.Error).

Pesan kesalahan terperinci disediakan dalam dimensi "error" properti customDimension . Dalam situasi di mana beberapa kesalahan terjadi selama operasi yang sama, kesalahan dikonsolidasikan dalam dimensi "kesalahan" dari satu peristiwa pelacakan. Pesan kesalahan sama seperti yang dilaporkan di Monitor selama sesi debug langsung.

Contoh kueri berikut mengidentifikasi kesalahan yang tidak tertangani dan memperluas semua pesan kesalahan yang disertakan dalam peristiwa pelacakan:

traces
    | where message == "Unhandled error"
    | extend customdims = parse_json(customDimensions)
    | extend errors = parse_json(tostring(customdims.['errors']))
    | mv-expand errors
    | project timestamp
        , itemId //unique identifier for the trace event
        , AppName = customdims.['ms-appName']
        , AppId = customdims.['ms-appId']
        , errors = errors.['Message']
    | order by timestamp desc

Contoh output untuk contoh kueri.

Pelacakan korelasi (eksperimental)

[Bagian ini berisi dokumentasi prarilis dan dapat berubah.]

Penting

  • Ini adalah fitur eksperimental.
  • Fitur eksperimental tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Koneksi ke data dan layanan eksternal sangat penting untuk sebagian besar aplikasi. Pelacakan korelasi menghasilkan dan menyebarkan informasi konteks untuk menggabungkan log yang dihasilkan sistem di seluruh aplikasi kanvas dan koneksinya, tunduk pada batasan tertentu. Sebagai contoh, aplikasi Anda dapat memanggil konektor kustom yang pada gilirannya memanggil Fungsi Azure atau panggilan REST API. Pelacakan korelasi memungkinkan Anda untuk menghubungkan tindakan yang diambil di aplikasi dengan panggilan API yang mendasari di seluruh tingkatan. Ini dapat berguna dalam pemecahan masalah.

Pelacakan korelasi aplikasi kanvas adalah implementasi pelacakan konteks dan mengikuti spesifikasi W3C.

Aktifkan pelacakan korelasi

Peringatan

Mengaktifkan pengaturan ini mungkin akan dikenakan biaya tambahan yang terkait dengan penyimpanan log Application Insights.

Untuk mengaktifkan fitur pelacakan korelasi, buka Pengaturan Fitur yang > akan datang Eksperimental > Aktifkan pelacakan > korelasi Azure Application Insights sambil menjaga aplikasi kanvas Anda tetap terbuka untuk diedit. Simpan dan publikasikan aplikasi Anda.

Aktifkan pelacakan korelasi Azure Application Insights .

Pembatasan

Menggunakan pelacakan korelasi

Saat diaktifkan, pelacakan korelasi menambahkan peristiwa log baru yang dihasilkan sistem di tabel dependensi instans aplikasi Application Insights kanvas. Peristiwa ini direkam pada saat respons dari panggilan jaringan diterima. Aktivitas dependensi menangkap rincian panggilan jaringan, termasuk header permintaan dan respons, kode status respons, dan durasi panggilan.

Contoh peristiwa yang dicatat dalam tabel dependensi.

Jika layanan yang terhubung juga tersambung ke, Application Insights peristiwa log tambahan yang dihasilkan sistem yang menangkap permintaan dihasilkan dalam tabel permintaan Application Insights instans layanan. Beberapa layanan Azure, seperti Azure Functions, dapat dihubungkan tanpa pengkodean apa pun dari portal Microsoft Azure. Baik aplikasi kanvas atau beberapa aplikasi dan layanan yang terhubung dapat dihubungkan ke instans yang sama Application Insights .

Contoh peristiwa yang dicatat dalam tabel permintaan.

Panggilan jaringan untuk konektor yang didukung dapat digabungkan dengan log lain yang dihasilkan sistem pada dimensi "operation_Id". Contoh kueri berikut menunjukkan panggilan jaringan yang dilakukan bersama peristiwa pelacakan yang dipancarkan selama sesi aplikasi.

traces | union dependencies | union requests | union pageViews | union customEvents
| project timestamp
    , itemType
    , name
    , operation_Name
    , message
    , severityLevel
    , customDimensions
    , operation_Id
    , operation_ParentId
| where operation_Id == "0a7729e3e83c4e4d93cb4f51149f73b9" //placeholder operation_Id, replace
| order by timestamp asc

Contoh output untuk kueri contoh sebelumnya.

Data ekspor ke Power BI

Anda dapat mengekspor data Application Insights dan hasil kueri ke Power BI untuk analisis dan presentasi data.

  1. Masuk ke portal Microsoft Azure dan buka sumber daya yang Application Insights Anda buat sebelumnya:

  2. Pilih Log di bawah Pemantauan di panel navigasi kiri:

  3. Dari jendela kueri analitik log, pilih menu Ekspor .

  4. Pilih opsi Ekspor ke( Power BI kueri M) untuk mengunduh Power BI file kueri:

    Kueri ekspor. Power BI

  5. Buka file yang diunduh di editor teks dan salin kueri ke clipboard.

  6. Buka Power BI.

  7. Pilih menu Dapatkan Data di pita Beranda , lalu pilih Kueri kosong:

    Power BI kueri kosong.

  8. Di jendela kueri, pilih Editor Tingkat Lanjut. Tempelkan kueri ke jendela, pilih Selesai, lalu pilih Tutup & Terapkan:

    Power BI kueri lanjutan.

Anda juga dapat membuat diagram dan visualisasi di Power BI untuk menunjukkan tanggapan yang diterima di aplikasi Anda, serta membuat keputusan dan tindakan berdasarkan data.

Bagan dan visualisasi.

Konteks dan dimensi aktivitas Pelacakan default

Kumpulan dimensi default juga ditambahkan ke properti customDimensions pada setiap peristiwa Pelacakan. Dimensi ini dapat digunakan untuk mengidentifikasi aplikasi dan sesi aplikasi di mana aktivitas terjadi. Jika Anda mencatat data kustom tambahan menggunakan fungsi Trace, data tersebut juga akan muncul di dimensi kustom.

Nama Dimensi Menunjukkan
ms-appId ID Aplikasi dari aplikasi yang mengirimkan aktivitas.
ms-appname Nama aplikasi dari aplikasi yang mengirimkan aktivitas.
ms-appSessionId ID sesi aplikasi. Nilai ini mungkin tidak diisi adalah beberapa skenario. Bila tersedia, nilai ini akan menimpa dimensi Application Insights sessionID standar.
ms-tenantID Pengidentifikasi unik penyewa tempat aplikasi dipublikasikan.
ms-environmentId Nama lingkungan tempat aplikasi dipublikasikan.
userId Pengidentifikasi unik untuk pengguna yang terkait dengan sesi.
ms-duration Nilai yang diperhitungkan yang mengukur waktu yang diperlukan pengguna untuk menavigasi dari satu layar ke layar lainnya. Nilai ini mengesampingkan dimensi durasi PageView Application Insights standar.
sessionId ID sesi yang dapat digunakan untuk mengkorelasikan semua aktivitas yang terkait dengan satu sesi aplikasi. Nilai ini selalu ada dan direkomendasikan untuk memahami jumlah sesi unik. Nilai ini diambil dari ID sesi pemain dan ditampilkan saat melihat rincian sesi saat memutar aplikasi. ID Sesi terkadang mendapatkan nilai yang buatan Application Insights yang default, acak, dan unik. Nilai default ini tidak andal dan tidak berkorelasi dengan parameter spesifik aplikasi apa pun.
Durasi Nilai yang diperhitungkan yang mengukur waktu yang diperlukan pengguna untuk menavigasi dari satu layar ke layar lainnya. Nilai ini sama dengan durasi yang dilaporkan oleh dimensi ms-duration.
ms-isTest Menunjukkan apakah sesi dikaitkan dengan test runner Test Studio.
ms-currentServerName Nama halaman tempat pengguna menavigasi (hadir untuk peristiwa navigasi halaman).
ms-targetScreenName Nama halaman yang dikunjungi pengguna (hadir untuk peristiwa navigasi halaman).

Skenario Tidak Didukung

Application Insights tidak mendukung skenario berikut.

  • Acara pemain offline tidak ditangkap.
  • Peristiwa aplikasi seluler (keduanya iOS dan Android) tidak ditangkap saat aplikasi ditangguhkan.