Model data telemetri Application Insights

Application Insights mengirimkan telemetri dari aplikasi web Anda ke portal Microsoft Azure untuk memberikan wawasan tentang performa dan penggunaan aplikasi dan infrastruktur Anda. Untuk membantu Anda lebih memahami dan mengatur data telemetri, kami mengategorikannya ke dalam jenis yang berbeda.

Model data telemetri distandarisasi, memungkinkan pembuatan sistem pemantauan yang independen dari platform dan bahasa. Kami berusaha untuk menjaga model tetap sederhana dan ramping untuk mendukung skenario penting dan memungkinkan skema diperluas untuk penggunaan tingkat lanjut.

Data yang dikumpulkan oleh Application Insights memodelkan pola eksekusi aplikasi umum ini:

¹availabilityResults tidak tersedia secara default dan memerlukan pengujian ketersediaan untuk disiapkan.
²customEvents dan customMetrics hanya tersedia dengan instrumentasi kustom.

Catatan

Application Insights menyimpan log dalam traces tabel karena alasan warisan. Rentang jejak terdistribusi disimpan dalam tabel requests dan dependencies. Kami berencana untuk menyelesaikan ini dalam rilis mendatang untuk menghindari kebingungan.

Jenis telemetri

Jenis telemetri berikut digunakan untuk memantau eksekusi aplikasi Anda. Azure Monitor OpenTelemetry Distro dan Application Insights JavaScript SDK mengumpulkan:

Jenis telemetri	Nama tabel (Wawasan Aplikasi)	Nama tabel (Analitik Log)	Deskripsi
Ketersediaan	availabilityResults	AppAvailabilityResults	Memantau ketersediaan dan respons aplikasi Anda dengan mengirim permintaan web secara berkala dan memberi tahu Anda jika aplikasi tidak merespons atau jika waktu respons terlalu lambat.
Pengaturan waktu browser	browserTimings	AppBrowserTimings	Mengukur performa halaman web, termasuk waktu pemuatan halaman dan durasi jaringan.
Dependensi	dependencies	AppDependencies	Melacak panggilan dari aplikasi Anda ke layanan atau penyimpanan eksternal, seperti REST API atau database SQL, dan mengukur durasi dan keberhasilan panggilan ini.
Acara	customEvents	AppEvents	Biasanya digunakan untuk menangkap interaksi pengguna dan kemunculan signifikan lainnya dalam aplikasi Anda, seperti klik tombol atau checkout pesanan, untuk menganalisis pola penggunaan.
Pengecualian	exceptions	AppExceptions	Menangkap informasi kesalahan sangat penting untuk pemecahan masalah dan pemahaman kegagalan.
Metrik	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	Penghitung kinerja menyediakan data numerik tentang berbagai aspek performa aplikasi dan sistem, seperti penggunaan CPU dan konsumsi memori. Selain itu, metrik kustom memungkinkan Anda menentukan dan melacak pengukuran khusus yang unik untuk aplikasi Anda, memberikan fleksibilitas untuk memantau indikator performa kustom.
Tampilan halaman	pageViews	AppPageViews	Melacak halaman yang dilihat oleh pengguna, memberikan wawasan tentang navigasi dan keterlibatan pengguna dalam aplikasi Anda.
Permintaan	requests	AppRequests	Mencatat permintaan yang diterima oleh aplikasi Anda, memberikan detail seperti ID operasi, durasi, dan status keberhasilan atau kegagalan.
Jejak	traces	AppTraces	Mencatat peristiwa khusus aplikasi, seperti pesan diagnostik kustom atau pernyataan pelacakan, yang berguna untuk penelusuran kesalahan dan pemantauan perilaku aplikasi dari waktu ke waktu.

Penting

Anda dapat mengkueri telemetri aplikasi dari Application Insights dan Log Analytics (disarankan), tetapi nama tabel dan bidang berbeda. Pembedaan ini mempertahankan kompatibilitas ke belakang, misalnya untuk memastikan bahwa dasbor pelanggan dengan kueri kustom yang dibuat sebelum konvensi penamaan Log Analitik terus berfungsi dengan benar.

Untuk membandingkan nama bidang di portal Microsoft Azure, bukaLogApplication Insights>, jalankan kueri, dan salin Id item telemetri (misalnya, 1234a5b6c7de8f90). Kemudian, buka tab baru di browser Anda, buka Log Analytics>Log, beralihlah ke mode KQL, dan jalankan kueri:

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

Perluas kedua item telemetri dengan memilih chevron di sebelah kiri setiap baris untuk melihat semua propertinya.

Setiap item telemetri dapat menyertakan informasi konteks seperti versi aplikasi atau ID sesi pengguna. Konteks terdiri dari sekumpulan bidang yang ditik dengan kuat yang memungkinkan skenario analisis yang berbeda.

Misalnya, ketika versi aplikasi diinisialisasi dengan benar, Application Insights dapat mendeteksi pola baru dalam perilaku aplikasi yang berkorelasi dengan penyebaran ulang. Demikian pula, Anda dapat menggunakan ID sesi untuk menilai dampak pemadaman atau masalah pada pengguna. Dengan menghitung jumlah ID sesi unik yang terkait dengan dependensi gagal, jejak kesalahan, atau pengecualian penting, Anda mendapatkan gambaran yang lebih jelas tentang dampak pengguna.

Model telemetri Application Insights juga mendukung korelasi item telemetri dengan operasi miliknya. Misalnya, jika permintaan memicu panggilan SQL Database, permintaan dan panggilan dependensi dapat menyertakan data diagnostik dan ditautkan melalui konteks korelasi bersama, memungkinkan Anda melacak alur penuh operasi.

Artikel ini membahas bidang khusus untuk setiap jenis telemetri. Untuk melihat daftar lengkap bidang yang tersedia (termasuk bidang konteks) untuk jenis telemetri apa pun, ikuti tautan yang disediakan di bawah setiap tabel yang relevan.

Telemetri ketersediaan

Telemetri ketersediaan melibatkan pemantauan sintetis, di mana pengujian mensimulasikan interaksi pengguna untuk memverifikasi bahwa aplikasi tersedia dan responsif. Sebaiknya siapkan pengujian ketersediaan standar untuk memantau ketersediaan aplikasi Anda dari berbagai titik di seluruh dunia, dan mengirim informasi pengujian Anda sendiri ke Application Insights.

Bidang khusus ketersediaan:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
id	Id	Pengidentifikasi unik dari hasil pengujian ketersediaan, digunakan untuk korelasi antara eksekusi pengujian individual yang dapat membantu melacak kegagalan atau pola tertentu dari waktu ke waktu. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.
name	Name	Nama pengujian ketersediaan. Ini didefinisikan saat membuat pengujian (misalnya, "Pengujian ping beranda").
location	Location	Lokasi geografis atau wilayah pusat data tempat pengujian ketersediaan dijalankan (misalnya, AS Barat, Eropa Utara). Ini membantu mengidentifikasi pemadaman regional atau masalah latensi.
success	Success	Bidang ini menunjukkan apakah pengujian ketersediaan berhasil atau tidak. Ini adalah nilai boolean di mana true berarti pengujian berhasil dan false berarti gagal.
message	Message	Pesan deskriptif dengan detail tentang hasil pengujian. Ini sering berisi detail pengecualian atau respons kesalahan.
duration	Duration	Jumlah waktu yang diperlukan pengujian ketersediaan untuk dijalankan. Ini membantu mengukur performa dan mengidentifikasi masalah waktu respons. Durasi biasanya diukur dalam milidetik.

Untuk daftar semua bidang yang tersedia, lihat AppAvailabilityResults.

Telemetri pengaturan waktu browser

Browser mengekspos pengukuran untuk tindakan pemuatan halaman dengan API Performa. Application Insights menyederhanakan pengukuran ini dengan mengonsolidasikan waktu terkait ke dalam metrik browser standar.

Bidang yang spesifik untuk penentuan waktu pada browser:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
networkDuration	NetworkDurationMs	Klien menghubungi DNS untuk mengatasi nama host situs web, dan DNS merespons dengan alamat IP. Klien membuat TCP dan kemudian jabat tangan TLS dengan server web.
sendDuration	SendDurationMs	Klien mengirim payload permintaan, menunggu server menjalankan permintaan, dan menerima paket respons pertama.
receiveDuration	ReceiveDurationMs	Klien menerima sisa byte payload respons dari server web.
processingDuration	ProcessingDurationMs	Klien sekarang memiliki payload respons penuh dan harus merender konten ke browser dan memuat DOM.
totalDuration	TotalDurationMs	Jumlah semua waktu browser.

Untuk daftar semua bidang yang tersedia, lihat AppBrowserTimings.

Telemetri dependensi

Item telemetri dependensi mewakili interaksi komponen yang dipantau dengan komponen jarak jauh seperti SQL atau titik akhir HTTP.

Bidang khusus bergantung:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
id	Id	Pengidentifikasi unik instans panggilan dependensi, digunakan untuk korelasi dengan item telemetri permintaan yang sesuai dengan panggilan dependensi ini. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.
target	Target	Lokasi target pemanggilan dependensi. Contohnya adalah nama server dan alamat host. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.
type	DependencyType	Nama tipe 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.
name	Name	Nama perintah yang diinisiasi dengan panggilan dependensi ini. Ini memiliki nilai kardinalitas rendah. Contohnya adalah nama prosedur tersimpan dan templat jalur URL.
data	Data	Panggilan dependensi ini memulai perintah tersebut. Contohnya adalah pernyataan SQL dan URL HTTP dengan semua parameter kueri.
success	Success	Bidang ini menunjukkan apakah panggilan berhasil atau tidak. Ini adalah nilai boolean di mana true berarti panggilan berhasil dan false berarti gagal.
resultCode	ResultCode	Kode hasil panggilan dependensi. Contohnya adalah kode kesalahan SQL dan kode status HTTP.
duration	DurationMs	Durasi permintaan dalam format DD.HH:MM:SS.MMMMMM. Ini harus kurang dari 1000 hari.

Untuk daftar semua bidang yang tersedia, lihat AppDependencies.

Telemetri peristiwa

Anda dapat membuat item telemetri peristiwa 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.

Untuk mempelajari selengkapnya tentang membuat telemetri peristiwa kustom, lihat Menambahkan dan memodifikasi Azure Monitor OpenTelemetry untuk aplikasi .NET, Java, Node.js, dan Python.

Bidang khusus acara:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
name	Name	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.

Untuk daftar semua bidang yang tersedia, lihat AppEvents.

Telemetri Kesalahan

Item telemetri pengecualian mewakili pengecualian yang ditangani atau tidak tertangani yang terjadi selama eksekusi aplikasi yang dipantau.

Bidang khusus pengecualian:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
problemId	ProblemId	Mengidentifikasi tempat pengecualian dilemparkan dalam kode. Ini digunakan untuk pengelompokan pengecualian. Biasanya, ini adalah kombinasi dari jenis pengecualian dan fungsi dari tumpukan panggilan.
type	ExceptionType	Jenis pengecualian spesifik yang terjadi. Ini biasanya mencakup namespace dan nama kelas, seperti System.NullReferenceException atau System.InvalidOperationException.
assembly	Assembly	Rakitan tempat terjadi pengecualian. Ini berguna untuk menentukan komponen aplikasi yang bertanggung jawab atas pengecualian.
method	Method	Nama metode dalam assembly tempat pengecualian dihasilkan. Ini memberikan informasi kontekstual tentang di mana dalam kode terjadi kesalahan.
outerType	OuterType	Jenis pengecualian luar (pembungkusan), jika pengecualian saat ini ditumpuk dalam pengecualian lain. Ini berguna untuk memahami konteks di mana pengecualian dalam terjadi dan dapat membantu dalam melacak urutan kesalahan.
outerMessage	OuterMessage	Pesan ini memberikan penjelasan yang dapat dibaca manusia tentang pengecualian luar dan dapat membantu dalam memahami masalah yang lebih luas.
outerAssembly	OuterAssembly	Rakitan di mana pengecualian luar berasal.
outerMethod	OuterMethod	Metode pengecualian eksternal. Ini memberikan informasi terperinci tentang titik kegagalan dalam pengecualian luar.
severityLevel	SeverityLevel	Tingkat keparahan jejak dapat menjadi salah satu nilai berikut: Verbose, , Information, WarningError, atau Critical.
details	Details	Berisi informasi pengecualian seperti pesan pengecualian dan tumpukan panggilan.

Untuk daftar semua bidang yang tersedia, lihat AppExceptions.

Metrik telemetri

Application Insights mendukung dua jenis telemetri metrik:

• Pengukuran tunggal memiliki nama dan nilai.
• Metrik yang telah disebarkan sebelumnya mengambil beberapa pengukuran dalam periode agregasi 1 menit.

Penghitung kinerja

Penghitung kinerja selalu metrik pengukuran tunggal dengan name dan value, tetapi dilengkapi dengan bidang tambahan category, counter, dan untuk aplikasi Windows juga instance.

Bidang khusus penghitung kinerja:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
name	Name	Nama metrik yang ingin Anda lihat di portal Application Insights.
value	Value	Nilai tunggal untuk pengukuran. Ini adalah jumlah pengukuran individu untuk agregasi.
category	Category	Mewakili sekelompok penghitung kinerja terkait (misalnya, Process).
counter	Counter	Menentukan metrik performa tertentu yang diukur dalam kategori (misalnya, IO Data Bytes/sec).
instance	Instance	Mengidentifikasi kejadian tertentu dari sebuah penghitung di dalam suatu kategori (misalnya, ??APP_WIN32_PROC??).

Untuk daftar semua bidang yang tersedia, lihat AppPerformanceCounters.

Untuk mempelajari selengkapnya tentang metrik, lihat Metrik di Application Insights. Untuk informasi selengkapnya tentang Metrik REST API, lihat Metrik - Dapatkan.

Metrik penghitung sistem dan proses

Nama .NET	Deskripsi
\Processor(_Total)\% Processor Time	Total CPU komputer.
\Memory\Available Bytes	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	CPU proses yang menghosting aplikasi.
\Process(??APP_WIN32_PROC??)\Private Bytes	Memori yang digunakan oleh proses hosting aplikasi.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Tingkat operasi I/O yang dijalankan oleh proses yang menghosting aplikasi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Tingkat permintaan yang diproses oleh aplikasi.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Tingkat pengecualian yang dilemparkan oleh aplikasi.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Waktu eksekusi permintaan rata-rata.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Jumlah permintaan yang menunggu pemrosesan dalam antrean.

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.

Metrik khusus

Metrik kustom adalah indikator performa atau metrik khusus bisnis yang Anda tentukan dan kumpulkan untuk mendapatkan wawasan yang tidak tercakup oleh metrik standar. Untuk mempelajari selengkapnya tentang metrik kustom, lihat Metrik kustom di Azure Monitor (pratinjau).

Bidang khusus metrik kustom:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Pengukuran tunggal	Metrik yang telah diagregasi sebelumnya
name	Name	Bidang ini adalah nama metrik yang ingin Anda lihat di portal Application Insights dan UI.
value	Value	Bidang ini adalah nilai tunggal untuk pengukuran. Ini adalah jumlah pengukuran individu untuk agregasi.	Untuk metrik yang sudah teragregasi sebelumnya, Nilai sama dengan Jumlah.
Max	Max	Untuk metrik pengukuran tunggal, Maks sama dengan Nilai.	Bidang ini adalah nilai maksimum metrik agregat. Seharusnya tidak diatur untuk pengukuran.
Min	Min	Untuk metrik pengukuran tunggal, Min sama dengan Nilai.	Bidang ini adalah nilai minimum metrik agregat. Seharusnya tidak diatur untuk pengukuran.
Sum	Sum	Untuk metrik pengukuran tunggal, Jumlah sama dengan Nilai.	Jumlah semua nilai metrik agregat. Seharusnya tidak diatur untuk pengukuran.
Count	Count	Untuk metrik pengukuran tunggal, Count adalah 1.	Jumlah pengukuran dalam periode agregasi 1 menit. Seharusnya tidak diatur untuk pengukuran.

Untuk daftar semua bidang yang tersedia, lihat AppMetrics.

Catatan

Untuk menghitung rata-rata, bagi Jumlah menurut Hitungan.

Telemetri tampilan halaman

Telemetri tampilan halaman 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.

Bidang khusus tampilan halaman:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
name	Name	Nama halaman yang dilihat oleh pengguna (misalnya, "Home" atau "Shopping Cart").
url	Url	URL lengkap halaman yang ditampilkan. Bidang ini sangat penting untuk menganalisis lalu lintas dan perilaku pengguna di seluruh aplikasi.
duration	DurationMs	PageView Durasinya adalah dari antarmuka pengaturan waktu performa browser, PerformanceNavigationTiming.duration. Jika PerformanceNavigationTiming tersedia, durasi tersebut digunakan. Jika tidak, antarmuka yang tidak digunakanPerformanceTiming lagi digunakan dan delta antara NavigationStart dan LoadEventEnd dihitung. Pengembang menentukan nilai durasi saat mencatat peristiwa kustom PageView dengan menggunakan panggilan API trackPageView.

Untuk daftar semua bidang yang tersedia, lihat AppPageViews.

Catatan

• Secara default, Application Insights JavaScript 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.

Meminta telemetri

Telemetri permintaan mewakili informasi yang berhubungan dengan permintaan HTTP masuk ke aplikasi Anda. Jenis telemetri ini membantu Anda memantau performa dan keberhasilan layanan berbasis web aplikasi Anda. Item telemetri permintaan 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.

Bidang khusus permintaan:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
id	Id	Pengidentifikasi unik instans panggilan permintaan, digunakan untuk korelasi antara permintaan dan item telemetri lainnya. ID harus unik secara global. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.
source	Source	Sumber adalah sumber permintaan. Contohnya adalah kunci instrumentasi pemanggil atau alamat IP pemanggil. Untuk informasi lebih lanjut, lihat Korelasi telemetri di Application Insights.
name	Name	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.
url	Url	URL adalah URL permintaan dengan semua parameter string kueri.
success	Success	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.
resultCode	ResultCode	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.
duration	DurationMs	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.

Untuk daftar semua bidang yang tersedia, lihat AppRequests.

Melacak telemetri

Telemetri pelacakan mewakili pernyataan pelacakan gaya printf dengan pencarian teks. Log4Net, NLog, dan entri file log berbasis teks lainnya diterjemahkan ke dalam instans jenis ini. Jejak tidak memiliki pengukuran sebagai ekstensibilitas.

Bidang khusus pelacakan:

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
message	Message	Melacak pesan.
severityLevel	SeverityLevel	Melacak tingkat keparahan.

Untuk daftar semua bidang yang tersedia, lihat AppTraces.

Catatan

Nilai untuk severityLevel dijumlahkan dan khusus platform.

Properti dan pengukuran kustom

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

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.

Nama bidang (Wawasan Aplikasi)	Nama bidang (Analitik Log)	Deskripsi
account_ID	user_AccountId	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.
application_Version	AppVersion	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.
appId	ResourceGUID	Pengidentifikasi unik untuk sumber daya Application Insights Anda untuk membedakan telemetri dari aplikasi yang berbeda.
appName	Tidak tersedia	Dalam Application Insights, appName sama _ResourceIddengan .
client_Browser	ClientBrowser	Nama browser web yang digunakan oleh klien.
client_City	ClientCity	Kota tempat klien berada ketika telemetri dikumpulkan (berdasarkan geolokasi IP).
client_CountryOrRegion	ClientCountryOrRegion	Negara atau wilayah tempat klien berada ketika telemetri dikumpulkan (berdasarkan geolokasi IP).
client_IP	ClientIP	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.
client_OS	ClientOS	Menunjukkan sistem operasi klien yang menghasilkan telemetri.
client_StateorProvince	ClientStateOrProvince	Negara bagian atau provinsi tempat klien berada ketika telemetri dikumpulkan (berdasarkan geolokasi IP).
client_Type	ClientType	Menjelaskan jenis perangkat klien yang mengirim telemetri (misalnya, Browser atau PC.)
cloud_RoleInstance	AppRoleInstance	Nama instans tempat aplikasi berjalan. Misalnya, ini adalah nama komputer untuk lokal atau nama instans untuk Azure.
cloud_RoleName	AppRoleName	Nama peran yang merupakan bagian dari aplikasi. Ini memetakan langsung ke nama peran di Azure. Ini juga dapat digunakan untuk membedakan layanan mikro, yang merupakan bagian dari satu aplikasi.
iKey	IKey	Pengidentifikasi unik warisan yang digunakan untuk mengaitkan data telemetri dengan sumber daya Application Insights tertentu.
itemId	Tidak tersedia	Pengidentifikasi unik untuk item telemetri tertentu.
itemCount	ItemCount	Jumlah kemunculan atau hitungan yang terkait dengan satu peristiwa telemetri.
operation_Id	OperationId	Pengidentifikasi unik operasi utama. 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.
operation_Name	OperationName	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?
operation_ParentId	ParentId	Pengidentifikasi unik induk langsung item telemetri. Untuk informasi selengkapnya, lihat Korelasi telemetri.
operation_SyntheticSource	SyntheticSource	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.
sdkVersion	SDKVersion	Versi Application Insights SDK yang mengirim data telemetri. Untuk informasi selengkapnya, lihat versi SDK.
session_Id	SessionId	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.
user_AuthenticatedId	UserAuthenticatedId	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.
user_Id	UserId	ID pengguna anonim 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. 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.
_ResourceId	_ResourceId	ID Sumber Daya Azure lengkap dari komponen Application Insights, yang mencakup langganan, grup sumber daya, dan nama sumber daya.

Langkah berikutnya

• Tinjau pertanyaan yang sering diajukan (FAQ): FAQ model data telemetri
• Lihat platform yang didukung oleh Application Insights.
• Pelajari cara mengumpulkan telemetri kustom menggunakan Distro OpenTelemetry Azure Monitor.
• Pelajari cara menggunakan API Application Insights untuk peristiwa dan metrik kustom.
• Pelajari cara memperluas dan memfilter telemetri.
• Pelajari cara menggunakan pengambilan sampel untuk meminimalkan jumlah telemetri berdasarkan model data.