Model data telemetri Application Insights

Application Insights mengirimkan telemetri dari aplikasi web Anda ke portal Azure sehingga Anda dapat menganalisis performa dan penggunaan aplikasi Anda. Model telemetri distandarkan, sehingga dimungkinkan untuk membuat pemantauan platform dan independen bahasa.

Data yang dikumpulkan oleh Application Insights memodelkan pola eksekusi aplikasi khas ini.

Jenis telemetri berikut digunakan untuk memantau eksekusi aplikasi Anda. Application Insights SDK dari kerangka kerja aplikasi web secara otomatis mengumpulkan ketiga jenis ini:

• Permintaan: Dibuat untuk mencatat permintaan yang diterima oleh aplikasi Anda. Misalnya, Application Insights web SDK secara otomatis menghasilkan item telemetri Permintaan untuk setiap permintaan HTTP yang diterima aplikasi web Anda.

  Operasi terdiri dari utas eksekusi yang memproses permintaan. Anda juga dapat menulis kode untuk memantau jenis operasi lain, seperti "bangun" dalam pekerjaan web atau fungsi yang secara berkala memproses data. Setiap operasi memiliki ID. ID dapat digunakan untuk mengelompokkan semua telemetri yang dihasilkan saat aplikasi Anda memproses permintaan. Setiap operasi berhasil atau gagal dan memiliki durasi waktu.

• Pengecualian: Biasanya mewakili pengecualian yang menyebabkan operasi gagal.

• Dependensi: Mewakili panggilan dari aplikasi Anda ke layanan atau penyimpanan eksternal, seperti REST API atau SQL. Dalam ASP.NET, panggilan dependensi ke SQL didefinisikan oleh System.Data. Panggilan ke titik akhir HTTP didefinisikan oleh System.Net.

Application Insights menyediakan tiga jenis data untuk telemetri kustom:

• Jejak: Digunakan baik secara langsung atau melalui adaptor untuk mengimplementasikan pembuatan log diagnostik dengan menggunakan kerangka kerja instrumentasi yang akrab untuk Anda, seperti Log4Net atau System.Diagnostics.
• Peristiwa: Biasanya digunakan untuk menangkap interaksi pengguna dengan layanan Anda untuk menganalisis pola penggunaan.
• Metrik: Digunakan untuk melaporkan pengukuran skalar berkala.

Setiap item telemetri dapat menentukan informasi konteks seperti versi aplikasi atau ID sesi pengguna. Konteks adalah sekumpulan bidang yang ditik dengan kuat yang membuka blokir skenario tertentu. Ketika versi aplikasi diinisialisasi dengan benar, Application Insights dapat mendeteksi pola baru dalam perilaku aplikasi yang berkorelasi dengan penyebaran ulang.

Anda dapat menggunakan ID sesi untuk menghitung pemadaman atau dampak masalah pada pengguna. Menghitung jumlah nilai ID sesi yang berbeda untuk dependensi gagal tertentu, jejak kesalahan, atau pengecualian kritis memberi Anda pemahaman yang baik tentang dampak.

Model telemetri Application Insights mendefinisikan cara untuk menghubungkan telemetri dengan operasi yang merupakan bagiannya. Misalnya, permintaan dapat melakukan panggilan SQL Database dan merekam informasi diagnostik. Anda dapat mengatur konteks korelasi untuk item telemetri yang mengikatnya kembali ke telemetri permintaan.

Perbaikan skema

Model data Application Insights adalah cara dasar namun kuat untuk memodelkan telemetri aplikasi Anda. Kami berusaha untuk menjaga model tetap sederhana dan ramping untuk mendukung skenario penting dan memungkinkan skema diperluas untuk penggunaan tingkat lanjut.

Untuk melaporkan masalah dan saran model data atau skema, gunakan repositori GitHub kami.

Minta

Item telemetri permintaan di Application Insights mewakili urutan eksekusi logis yang dipicu oleh permintaan eksternal ke aplikasi Anda. Setiap eksekusi permintaan diidentifikasi oleh yang unik id dan url berisi semua parameter eksekusi.

Anda dapat mengelompokkan permintaan berdasarkan name logis dan menentukan source permintaan ini. Eksekusi kode dapat mengakibatkan success atau fail dan memiliki duration tertentu. Anda dapat lebih lanjut mengelompokkan keberhasilan dan kegagalan eksekusi dengan menggunakan resultCode. Waktu mulai untuk telemetri permintaan ditentukan pada tingkat amplop.

Telemetri permintaan mendukung model ekstensibilitas standar dengan menggunakan kustom properties dan measurements.

Catatan

Pada tanggal 31 Maret 2025, dukungan untuk penyerapan kunci instrumentasi akan berakhir. Penyerapan kunci instrumentasi akan berjalan terus, namun kami tidak akan lagi menyediakan pembaruan atau dukungan terhadap fitur tersebut. Transisi ke string koneksi untuk memanfaatkan kemampuan baru.

Nama

Bidang ini adalah nama permintaan dan mewakili jalur kode yang diambil untuk memproses permintaan. Nilai kardinalitas rendah memungkinkan pengelompokan permintaan yang lebih baik. Untuk permintaan HTTP, ini mewakili metode HTTP dan templat jalur URL seperti GET /values/{id} tanpa nilai aktual id .

SDK web Application Insights mengirimkan nama permintaan "apa adanya" tentang huruf besar/kecil. Pengelompokan pada UI peka huruf besar/kecil, jadi GET /Home/Index dihitung secara terpisah meskipun GET /home/INDEX sering kali mereka menghasilkan pengontrol dan eksekusi tindakan yang sama. Alasannya adalah bahwa URL secara umum peka huruf besar/kecil. Anda mungkin ingin melihat apakah semua 404 kesalahan terjadi untuk URL yang ditik dalam huruf besar. Anda dapat membaca selengkapnya tentang kumpulan nama permintaan oleh SDK web ASP.NET di posting blog.

Panjang maksimum: 1.024 karakter

ID

ID adalah pengidentifikasi instans panggilan permintaan. Ini digunakan untuk korelasi antara permintaan dan item telemetri lainnya. ID harus unik secara global. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.

Panjang maksimum: 128 karakter

URL

URL adalah URL permintaan dengan semua parameter string kueri.

Panjang maksimum: 2.048 karakter

Sumber

Sumber adalah sumber permintaan. Contohnya adalah kunci instrumentasi pemanggil atau alamat IP pemanggil. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.

Panjang maksimum: 1.024 karakter

Durasi

Durasi permintaan diformat sebagai DD.HH:MM:SS.MMMMMM. Ini harus positif dan kurang dari 1000 hari. Bidang ini diperlukan karena telemetri permintaan mewakili operasi dengan awal dan akhir.

Kode respons

Kode respons adalah hasil dari eksekusi permintaan. Ini adalah kode status HTTP untuk permintaan HTTP. Ini mungkin merupakan HRESULT nilai atau jenis pengecualian untuk jenis permintaan lainnya.

Panjang maksimum: 1.024 karakter

Berhasil

Keberhasilan menunjukkan apakah panggilan berhasil atau tidak berhasil. Bidang ini wajib diisi. Ketika permintaan tidak diatur secara eksplisit ke false, permintaan dianggap berhasil. Jika pengecualian atau kode hasil kesalahan yang dikembalikan mengganggu operasi, atur nilai ini ke false.

Untuk aplikasi web, Application Insights mendefinisikan permintaan sebagai berhasil ketika kode respons kurang dari 400 atau sama dengan 401. Namun, ada kasus ketika pemetaan default ini tidak cocok dengan semantik aplikasi.

Kode 404 respons mungkin menunjukkan "tidak ada rekaman", yang dapat menjadi bagian dari alur reguler. Ini juga mungkin menunjukkan tautan yang rusak. Untuk tautan yang rusak, Anda dapat menerapkan logika yang lebih canggih. Anda dapat menandai tautan yang rusak sebagai kegagalan hanya ketika tautan tersebut terletak di situs yang sama dengan menganalisis perujuk URL. Atau Anda dapat menandainya sebagai kegagalan saat diakses dari aplikasi seluler perusahaan. Demikian pula, 301 dan 302 menunjukkan kegagalan saat diakses dari klien yang tidak mendukung pengalihan.

Konten yang 206 diterima sebagian mungkin menunjukkan kegagalan permintaan keseluruhan. Misalnya, titik akhir Application Insights mungkin menerima batch item telemetri sebagai satu permintaan. Ini mengembalikan ketika beberapa item dalam batch tidak berhasil diproses 206 . Tingkat peningkatan 206 menunjukkan masalah yang perlu diselidiki. Logika serupa berlaku untuk 207 Multi-Status, di mana keberhasilannya mungkin merupakan yang terburuk dari kode respons terpisah.

Properti khusus

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

Pengukuran kustom

Kumpulan pengukuran kustom: Gunakan koleksi ini untuk melaporkan pengukuran bernama yang terkait dengan item telemetri. Kasus penggunaan umum:

• Ukuran payload telemetri dependensi.
• Jumlah item antrean yang diproses oleh telemetri permintaan.
• Waktu yang dibutuhkan pelanggan untuk menyelesaikan langkah wizard menyelesaikan telemetri peristiwa.

Anda dapat mengkueri pengukuran kustom di Analitik Aplikasi:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Catatan

• Pengukuran kustom dikaitkan dengan item telemetri tempat pengukuran berada. Mereka tunduk pada pengambilan sampel dengan item telemetri yang berisi pengukuran tersebut. Untuk melacak pengukuran yang memiliki nilai independen dari jenis telemetri lain, gunakan telemetri metrik.
• Jangan gunakan nilai string untuk pengukuran kustom. Hanya nilai numerik yang didukung.

Panjang kunci maksimum: 150

Dependensi

Telemetri dependensi (dalam Application Insights) mewakili interaksi komponen yang dipantau dengan komponen jarak jauh seperti SQL atau titik akhir HTTP.

Nama

Bidang ini adalah nama perintah yang dimulai dengan panggilan dependensi ini. Ini memiliki nilai kardinalitas rendah. Contohnya adalah nama prosedur tersimpan dan templat jalur URL.

ID

ID adalah pengidentifikasi instans panggilan dependensi. Ini digunakan untuk korelasi dengan item telemetri permintaan yang sesuai dengan panggilan dependensi ini. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.

Data

Bidang ini adalah perintah yang dimulai oleh panggilan dependensi ini. Contohnya adalah pernyataan SQL dan URL HTTP dengan semua parameter kueri.

Jenis

Bidang ini adalah nama jenis dependensi. Ini memiliki nilai kardinalitas rendah untuk pengelompokan logis dependensi dan interpretasi bidang lain seperti commandName dan resultCode. Contohnya adalah SQL, tabel Azure, dan HTTP.

Target

Bidang ini adalah situs target panggilan dependensi. Contohnya adalah nama server dan alamat host. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.

Durasi

Durasi permintaan dalam format DD.HH:MM:SS.MMMMMM. Ini harus kurang dari 1000 hari.

Kode hasil

Bidang ini adalah kode hasil panggilan dependensi. Contohnya adalah kode kesalahan SQL dan kode status HTTP.

Berhasil

Bidang ini adalah indikasi panggilan yang berhasil atau tidak berhasil.

Properti khusus

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

Pengukuran kustom

Kumpulan pengukuran kustom: Gunakan koleksi ini untuk melaporkan pengukuran bernama yang terkait dengan item telemetri. Kasus penggunaan umum:

• Ukuran payload telemetri dependensi.
• Jumlah item antrean yang diproses oleh telemetri permintaan.
• Waktu yang dibutuhkan pelanggan untuk menyelesaikan langkah wizard menyelesaikan telemetri peristiwa.

Anda dapat mengkueri pengukuran kustom di Analitik Aplikasi:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Catatan

• Pengukuran kustom dikaitkan dengan item telemetri tempat pengukuran berada. Mereka tunduk pada pengambilan sampel dengan item telemetri yang berisi pengukuran tersebut. Untuk melacak pengukuran yang memiliki nilai independen dari jenis telemetri lain, gunakan telemetri metrik.
• Jangan gunakan nilai string untuk pengukuran kustom. Hanya nilai numerik yang didukung.

Panjang kunci maksimum: 150

Pengecualian

Dalam Application Insights, instans pengecualian mewakili pengecualian yang ditangani atau tidak tertangani yang terjadi selama eksekusi aplikasi yang dipantau.

ID Masalah

ID masalah mengidentifikasi tempat pengecualian dilemparkan dalam kode. Ini digunakan untuk pengelompokan pengecualian. Biasanya, ini adalah kombinasi dari jenis pengecualian dan fungsi dari tumpukan panggilan.

Panjang maksimum: 1.024 karakter

Tingkat keparahan

Bidang ini adalah tingkat keparahan jejak. Nilainya bisa , Verbose, InformationWarning, Error, atau Critical.

Detail pengecualian

(Untuk diperpanjang)

Properti khusus

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

Pengukuran kustom

Kumpulan pengukuran kustom: Gunakan koleksi ini untuk melaporkan pengukuran bernama yang terkait dengan item telemetri. Kasus penggunaan umum:

• Ukuran payload telemetri dependensi.
• Jumlah item antrean yang diproses oleh telemetri permintaan.
• Waktu yang dibutuhkan pelanggan untuk menyelesaikan langkah wizard menyelesaikan telemetri peristiwa.

Anda dapat mengkueri pengukuran kustom di Analitik Aplikasi:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Catatan

• Pengukuran kustom dikaitkan dengan item telemetri tempat pengukuran berada. Mereka tunduk pada pengambilan sampel dengan item telemetri yang berisi pengukuran tersebut. Untuk melacak pengukuran yang memiliki nilai independen dari jenis telemetri lain, gunakan telemetri metrik.
• Jangan gunakan nilai string untuk pengukuran kustom. Hanya nilai numerik yang didukung.

Panjang kunci maksimum: 150

Trace

Melacak telemetri di Application Insights mewakili printfpernyataan jejak gaya yang dicari teks. Log4Net, NLog, dan entri file log berbasis teks lainnya diterjemahkan ke dalam instans jenis ini. Jejak tidak memiliki pengukuran sebagai ekstensibilitas.

Pesan

Melacak pesan.

Panjang maksimum: 32.768 karakter

Tingkat keparahan

Melacak tingkat keparahan.

Nilai: Verbose, , WarningInformation, Error, danCritical

Properti khusus

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

Kejadian

Anda dapat membuat item telemetri peristiwa (di Application Insights) untuk mewakili peristiwa yang terjadi di aplikasi Anda. Biasanya, ini adalah interaksi pengguna seperti klik tombol atau checkout pesanan. Ini juga bisa menjadi peristiwa siklus hidup aplikasi seperti inisialisasi atau pembaruan konfigurasi.

Secara semantik, peristiwa mungkin atau mungkin tidak terkait dengan permintaan. Jika digunakan dengan benar, telemetri peristiwa lebih penting daripada permintaan atau jejak. Peristiwa mewakili telemetri bisnis dan harus tunduk pada pengambilan sampel yang terpisah dan kurang agresif.

Nama

Nama peristiwa: Untuk mengizinkan pengelompokan yang tepat dan metrik yang berguna, batasi aplikasi Anda sehingga menghasilkan beberapa nama peristiwa terpisah. Misalnya, jangan gunakan nama terpisah untuk setiap instans peristiwa yang dihasilkan.

Panjang maksimum: 512 karakter

Properti khusus

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

Pengukuran kustom

Kumpulan pengukuran kustom: Gunakan koleksi ini untuk melaporkan pengukuran bernama yang terkait dengan item telemetri. Kasus penggunaan umum:

• Ukuran payload telemetri dependensi.
• Jumlah item antrean yang diproses oleh telemetri permintaan.
• Waktu yang dibutuhkan pelanggan untuk menyelesaikan langkah wizard menyelesaikan telemetri peristiwa.

Anda dapat mengkueri pengukuran kustom di Analitik Aplikasi:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Catatan

• Pengukuran kustom dikaitkan dengan item telemetri tempat pengukuran berada. Mereka tunduk pada pengambilan sampel dengan item telemetri yang berisi pengukuran tersebut. Untuk melacak pengukuran yang memiliki nilai independen dari jenis telemetri lain, gunakan telemetri metrik.
• Jangan gunakan nilai string untuk pengukuran kustom. Hanya nilai numerik yang didukung.

Panjang kunci maksimum: 150

Metric

Application Insights mendukung dua jenis telemetri metrik: pengukuran tunggal dan metrik yang telah ditentukan sebelumnya. Pengukuran tunggal hanyalah nama dan nilai. Metrik yang ditentukan sebelumnya menentukan nilai minimum dan maksimum metrik dalam interval agregasi dan simpangan baku metrik tersebut.

Telemetri metrik yang ditentukan sebelumnya mengasumsikan bahwa periode agregasi adalah satu menit.

Application Insights mendukung beberapa nama metrik terkenal. Metrik ini ditempatkan ke performanceCounters dalam tabel.

Tabel berikut menunjukkan metrik yang mewakili penghitung sistem dan proses.

Nama .NET	Nama platform-agnostik	Deskripsi
\Processor(_Total)\% Processor Time	Sedang berlangsung...	Total CPU komputer.
\Memory\Available Bytes	Sedang berlangsung...	Menunjukkan jumlah memori fisik, dalam byte, yang tersedia untuk proses yang berjalan di komputer. Ini dihitung dengan menjumlahkan jumlah ruang pada daftar memori nol, bebas, dan siaga. Memori gratis siap digunakan. Memori nol terdiri dari halaman memori yang diisi dengan nol untuk mencegah proses selanjutnya melihat data yang digunakan oleh proses sebelumnya. Memori siaga adalah memori yang telah dihapus dari set kerja proses (memori fisiknya) dalam rute ke disk tetapi masih tersedia untuk ditarik kembali. Lihat Objek Memori.
\Process(??APP_WIN32_PROC??)\% Processor Time	Sedang berlangsung...	CPU proses yang menghosting aplikasi.
\Process(??APP_WIN32_PROC??)\Private Bytes	Sedang berlangsung...	Memori yang digunakan oleh proses hosting aplikasi.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Sedang berlangsung...	Tingkat operasi I/O yang dijalankan oleh proses yang menghosting aplikasi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Sedang berlangsung...	Tingkat permintaan yang diproses oleh aplikasi.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Sedang berlangsung...	Tingkat pengecualian yang dilemparkan oleh aplikasi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Sedang berlangsung...	Waktu eksekusi permintaan rata-rata.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Sedang berlangsung...	Jumlah permintaan yang menunggu pemrosesan dalam antrean.

Untuk informasi selengkapnya tentang Metrik REST API, lihat Metrik - Dapatkan.

Nama

Bidang ini adalah nama metrik yang ingin Anda lihat di portal Application Insights dan UI.

Nilai

Bidang ini adalah nilai tunggal untuk pengukuran. Ini adalah jumlah pengukuran individu untuk agregasi.

Hitung

Bidang ini adalah bobot metrik metrik agregat. Seharusnya tidak diatur untuk pengukuran.

Min

Bidang ini adalah nilai minimum metrik agregat. Seharusnya tidak diatur untuk pengukuran.

Maks

Bidang ini adalah nilai maksimum metrik agregat. Seharusnya tidak diatur untuk pengukuran.

Simpangan baku

Bidang ini adalah simpanngan standar metrik agregat. Seharusnya tidak diatur untuk pengukuran.

Properti khusus

Metrik dengan properti CustomPerfCounter kustom diatur untuk true menunjukkan bahwa metrik mewakili penghitung kinerja Windows. Metrik ini ditempatkan dalam performanceCounters tabel, bukan di customMetrics. Selain itu, nama metrik ini diurai untuk mengekstrak kategori, penghitung, dan nama instans.

Kumpulan nilai nama properti kustom: Koleksi ini digunakan untuk memperluas telemetri standar dengan dimensi kustom. Contohnya adalah slot penyebaran yang menghasilkan telemetri atau properti khusus item telemetri seperti nomor pesanan.

• Panjang kunci maksimum: 150
• Panjang nilai maksimum: 8.192

PageView

Telemetri PageView (di Application Insights) dicatat saat pengguna aplikasi membuka halaman baru aplikasi yang dipantau. Page Dalam konteks ini adalah unit logis yang ditentukan oleh pengembang untuk menjadi tab aplikasi atau layar dan belum tentu berkorelasi dengan beban halaman web browser atau tindakan refresh. Perbedaan ini dapat dipahami lebih lanjut dalam konteks aplikasi satu halaman (SPAs), di mana peralihan antar halaman tidak terkait dengan tindakan halaman browser. pageViews.duration adalah waktu yang diperlukan aplikasi untuk menyajikan halaman kepada pengguna.

Catatan

• Secara default, Application Insights SDK mencatat peristiwa tunggal PageView di setiap tindakan pemuatan halaman web browser, dengan pageViews.duration diisi oleh waktu browser. Pengembang dapat memperluas pelacakan PageView peristiwa tambahan dengan menggunakan panggilan API trackPageView.
• Retensi log default adalah 30 hari. Jika Anda ingin melihat PageView statistik dalam jangka waktu yang lebih lama, Anda harus menyesuaikan pengaturan.

Mengukur browserTiming di Application Insights

Browser modern mengekspos pengukuran untuk tindakan pemuatan halaman dengan API Performa. Application Insights menyederhanakan pengukuran ini dengan mengonsolidasikan waktu terkait ke dalam metrik browser standar seperti yang didefinisikan oleh definisi waktu pemrosesan ini:

• Klien <--> DNS: Klien menjangkau DNS untuk mengatasi nama host situs web, dan DNS merespons dengan alamat IP.

• Klien <--> Server Web: Klien membuat TCP dan kemudian jabat tangan TLS dengan server web.

• Klien <--> Server Web: Klien mengirim payload permintaan, menunggu server menjalankan permintaan, dan menerima paket respons pertama.

• Klien <--Web Server: Klien menerima sisa byte payload respons dari server web.

• Klien: Klien sekarang memiliki payload respons penuh dan harus merender konten ke browser dan memuat DOM.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = #3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = #5

• browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

• pageViews/duration

  • PageView Durasinya adalah dari antarmuka pengaturan waktu performa browser, PerformanceNavigationTiming.duration.

  • Jika PerformanceNavigationTiming tersedia, durasi tersebut digunakan.

    Jika tidak, antarmuka yang tidak digunakan PerformanceTiming lagi digunakan dan delta antara NavigationStart dan LoadEventEnd dihitung.

  • Pengembang menentukan nilai durasi saat mencatat peristiwa kustom PageView dengan menggunakan panggilan API trackPageView.

Konteks

Setiap item telemetri mungkin memiliki bidang konteks yang diketik dengan kuat. Setiap bidang memungkinkan skenario pemantauan tertentu. Gunakan kumpulan properti kustom untuk menyimpan informasi kustom atau kontekstual spesifik aplikasi.

Versi aplikasi

Informasi dalam bidang konteks aplikasi selalu tentang aplikasi yang mengirim telemetri. Versi aplikasi digunakan untuk menganalisis perubahan tren dalam perilaku aplikasi dan korelasinya dengan penyebaran.

Panjang maksimum: 1.024

Alamat IP Klien

Bidang ini adalah alamat IP perangkat klien. IPv4 dan IPv6 didukung. Ketika telemetri dikirim dari layanan, konteks lokasi adalah tentang pengguna yang memulai operasi dalam layanan. Application Insights mengekstrak informasi lokasi geografis dari IP klien lalu memotongnya. IP klien dengan sendirinya tidak dapat digunakan sebagai informasi yang dapat diidentifikasi pengguna.

Panjang maksimum: 46

Jenis perangkat

Awalnya, bidang ini digunakan untuk menunjukkan jenis perangkat yang digunakan pengguna aplikasi. Saat ini digunakan terutama untuk membedakan telemetri JavaScript dengan jenis Browser perangkat dari telemetri sisi server dengan jenis PCperangkat .

Panjang maksimum: 64

ID Operasi

Bidang ini adalah pengidentifikasi unik dari operasi akar. Pengidentifikasi ini memungkinkan pengelompokan telemetri di beberapa komponen. Untuk informasi selengkapnya, lihat Korelasi telemetri. Permintaan atau tampilan halaman membuat ID operasi. Semua telemetri lainnya mengatur bidang ini ke nilai untuk permintaan atau tampilan halaman yang berisi.

Panjang maksimum: 128

ID operasi induk

Bidang ini adalah pengidentifikasi unik induk langsung item telemetri. Untuk informasi selengkapnya, lihat Korelasi telemetri.

Panjang maksimum: 128

Nama operasi

Bidang ini adalah nama (grup) operasi. Permintaan atau tampilan halaman membuat nama operasi. Semua item telemetri lainnya mengatur bidang ini ke nilai untuk permintaan atau tampilan halaman yang berisi. Nama operasi digunakan untuk menemukan semua item telemetri untuk sekelompok operasi (misalnya, GET Home/Index). Properti konteks ini digunakan untuk menjawab pertanyaan seperti Apa pengecualian umum yang dilemparkan di halaman ini?

Panjang maksimum: 1.024

Sumber operasi sintetis

Bidang ini adalah nama sumber sintetis. Beberapa telemetri dari aplikasi mungkin mewakili lalu lintas sintetis. Mungkin perayap web yang mengindeks situs web, pengujian ketersediaan situs, atau jejak dari pustaka diagnostik seperti Application Insights SDK itu sendiri.

Panjang maksimum: 1.024

ID Sesi

ID Sesi adalah instans interaksi pengguna dengan aplikasi. Informasi dalam bidang konteks sesi selalu tentang pengguna. Ketika telemetri dikirim dari layanan, konteks sesi adalah tentang pengguna yang memulai operasi dalam layanan.

Panjang maksimum: 64

ID pengguna anonim

ID pengguna anonim (User.Id) mewakili pengguna aplikasi. Ketika telemetri dikirim dari layanan, konteks pengguna adalah tentang pengguna yang memulai operasi dalam layanan.

Pengambilan sampel adalah salah satu teknik untuk meminimalkan jumlah telemetri yang terkumpul. Algoritma pengambilan sampel mencoba untuk mengambil sampel masuk atau keluar semua telemetri yang berkorelasi. ID pengguna anonim digunakan untuk pembuatan skor pengambilan sampel, sehingga ID pengguna anonim harus menjadi nilai yang cukup acak.

Catatan

Jumlah ID pengguna anonim tidak sama dengan jumlah pengguna aplikasi unik. Jumlah ID pengguna anonim biasanya lebih tinggi karena setiap kali pengguna membuka aplikasi Anda di perangkat atau browser yang berbeda, atau membersihkan cookie browser, ID pengguna anonim unik baru dialokasikan. Perhitungan ini dapat mengakibatkan penghitungan pengguna fisik yang sama beberapa kali.

ID pengguna dapat direferensikan silang dengan ID sesi untuk menyediakan dimensi telemetri unik dan menetapkan aktivitas pengguna selama durasi sesi.

Menggunakan ID pengguna anonim untuk menyimpan nama pengguna adalah penyalahgunaan bidang. Gunakan ID pengguna yang diautentikasi.

Panjang maksimum: 128

ID pengguna Terautentikasi

ID pengguna yang diautentikasi adalah kebalikan dari ID pengguna anonim. Bidang ini mewakili pengguna dengan nama yang mudah diingat. ID ini hanya dikumpulkan secara default dengan AuthenticatedUserIdTelemetryInitializer ASP.NET Framework SDK.

Gunakan Application Insights SDK untuk menginisialisasi ID pengguna terautentikasi dengan nilai yang mengidentifikasi pengguna secara terus-menerus di seluruh browser dan perangkat. Dengan cara ini, semua item telemetri dikaitkan dengan ID unik tersebut. ID ini memungkinkan kueri untuk semua telemetri yang dikumpulkan untuk pengguna tertentu (tunduk pada konfigurasi sampling dan pemfilteran telemetri).

ID pengguna dapat direferensikan silang dengan ID sesi untuk menyediakan dimensi telemetri unik dan menetapkan aktivitas pengguna selama durasi sesi.

Panjang maksimum: 1.024

ID Akun

ID akun, dalam aplikasi multipenyewa, adalah ID akun penyewa atau nama yang digunakan pengguna. Ini digunakan untuk lebih banyak segmentasi pengguna saat ID pengguna dan ID pengguna yang diautentikasi tidak cukup. Contohnya mungkin ID langganan untuk portal Azure atau nama blog untuk platform blogging.

Panjang maksimum: 1.024

Peran cloud

Bidang ini adalah nama peran di mana aplikasi adalah bagian. Ini memetakan langsung ke nama peran di Azure. Ini juga dapat digunakan untuk membedakan layanan mikro, yang merupakan bagian dari satu aplikasi.

Panjang maksimum: 256

Instans peran cloud

Bidang ini adalah nama instans tempat aplikasi berjalan. Misalnya, ini adalah nama komputer untuk lokal atau nama instans untuk Azure.

Panjang maksimum: 256

Internal: Versi SDK

Untuk informasi selengkapnya, lihat versi SDK.

Panjang maksimum: 64

Internal: Nama simpul

Bidang ini mewakili nama simpul yang digunakan untuk tujuan penagihan. Gunakan untuk mengganti deteksi standar simpul.

Panjang maksimum: 256

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Bagaimana cara mengukur dampak kampanye pemantauan?

Telemetri PageView menyertakan URL dan Anda dapat mengurai parameter UTM menggunakan fungsi regex di Kusto.

Terkadang, data ini mungkin hilang atau tidak akurat jika pengguna atau perusahaan menonaktifkan pengiriman Agen Pengguna di pengaturan browser. Regex UA Parser mungkin tidak menyertakan semua informasi perangkat. Atau Application Insights mungkin belum mengadopsi pembaruan terbaru.

Mengapa pengukuran kustom berhasil tanpa kesalahan tetapi log tidak muncul?

Ini dapat terjadi jika Anda menggunakan nilai string. Hanya nilai numerik yang berfungsi dengan pengukuran kustom.

Langkah berikutnya

Pelajari cara menggunakan API Application Insights untuk peristiwa dan metrik kustom, termasuk:

• Telemetri permintaan kustom
• Telemetri dependensi kustom
• Telemetri pelacakan kustom
• Telemetri peristiwa kustom
• Telemetri metrik kustom

Siapkan pelacakan dependensi untuk:

• .NET
• Java

Untuk mempelajari selengkapnya:

• Lihat platform yang didukung oleh Application Insights.
• Lihat konfigurasi kumpulan properti konteks standar.
• Jelajahi log jejak .NET di Application Insights.
• Jelajahi log jejak Java di Application Insights.
• Pelajari tentang integrasi bawaan Azure Functions dengan Application Insights untuk memantau eksekusi fungsi.
• Pelajari cara mengonfigurasi aplikasi ASP.NET Core dengan Application Insights.
• Pelajari cara mendiagnosis pengecualian di aplikasi web Anda dengan Application Insights.
• Pelajari cara memperluas dan memfilter telemetri.
• Gunakan pengambilan sampel untuk meminimalkan jumlah telemetri berdasarkan model data.