Informasi yang dikumpulkan oleh klien web CloudWatch RUM

Bagian ini mendokumentasikan PutRumEventsskema, yang mendefinisikan struktur data yang dapat Anda kumpulkan dari sesi pengguna menggunakan CloudWatch RUM.

PutRumEventsPermintaan mengirimkan struktur data dengan bidang berikut ke CloudWatch RUM.

• ID batch peristiwa RUM ini

• Detail monitor aplikasi, yang mencakup hal berikut:

  • ID monitor aplikasi

  • Versi aplikasi yang dipantau

• Detail monitor aplikasi, yang mencakup hal berikut. Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.

  • ID pengguna yang dihasilkan klien web

  • ID Sesi

• Susunan peristiwa RUM dalam batch ini.

Skema peristiwa RUM

Struktur setiap peristiwa RUM mencakup bidang-bidang berikut.

• ID peristiwa

• Timestamp

• Jenis peristiwa

• Agen pengguna

• Metadata

• Detail peristiwa RUM

Metadata peristiwa RUM

Metadata mencakup metadata halaman, metadata agen pengguna, metadata geolokasi, dan metadata domain.

Metadata halaman

Metadata halaman meliputi berikut ini:

• ID Halaman

• Judul halaman

• ID halaman induk. – Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.

• Kedalaman interaksi – Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.

• Tanda halaman – Anda dapat menambahkan tanda ke peristiwa halaman untuk mengelompokkan halaman bersama–sama. Untuk informasi selengkapnya, lihat Gunakan grup halaman.

Metadata agen pengguna

Metadata agen pengguna meliputi berikut ini:

• Bahasa Browser

• Nama Browser

• Versi browser

• Nama sistem operasi

• Versi Sistem Operasi

• Jenis perangkat

• Jenis platform

Metadata geolokasi

Metadata geolokasi meliputi berikut ini:

• Kode negara

• Kode subdivisi

Metadata domain

Metadata domain mencakup domain URL.

Detail peristiwa RUM

Detail peristiwa mengikuti salah satu jenis skema berikut, tergantung jenis peristiwa.

Peristiwa awal sesi

Peristiwa ini tidak berisi bidang. Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.

Skema tampilan halaman

Peristiwa tampilan halaman berisi properti berikut. Anda dapat menonaktifkan koleksi tampilan halaman dengan mengonfigurasi klien web. Untuk informasi selengkapnya, lihat dokumentasi klien web CloudWatch RUM.

Nama	Tipe	Deskripsi
ID Halaman	String	ID yang secara unik mewakili halaman ini dalam aplikasi. Secara default, ini adalah jalur URL.
ID halaman induk	String	ID halaman yang digunakan pengguna saat mereka menavigasi ke halaman saat ini. Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.
Kedalaman interaksi	String	Ini dikumpulkan hanya jika monitor aplikasi mengaktifkan cookie.

JavaScript skema kesalahan

JavaScript peristiwa kesalahan yang dihasilkan oleh agen berisi properti berikut. Klien web mengumpulkan peristiwa ini hanya jika Anda memilih untuk mengumpulkan telemetri kesalahan.

Nama	Tipe	Deskripsi
Jenis kesalahan	String	Nama kesalahan, jika ada. Untuk informasi selengkapnya, silakan lihat Error.prototype.name. Beberapa browser mungkin tidak mendukung jenis kesalahan.
Pesan kesalahan	String	Pesan kesalahan. Untuk informasi selengkapnya, silakan lihat Error.prototype.message. Jika bidang kesalahan tidak ada, ini adalah pesan dari peristiwa kesalahan. Untuk informasi lebih lanjut, lihat ErrorEvent. Pesan kesalahan mungkin tidak konsisten di berbagai browser.
Jejak tumpukan	String	Jejak tumpukan kesalahan, jika ada, terpotong menjadi 150 karakter. Untuk informasi selengkapnya, silakan lihat Error.prototype.stack. Beberapa browser mungkin tidak mendukung jejak tumpukan.

Skema peristiwa DOM

Peristiwa document object model (DOM) yang dihasilkan agen berisi properti berikut. Peristiwa ini tidak dikumpulkan secara default. Mereka dikumpulkan hanya jika Anda mengaktifkan telemetri interaksi. Untuk informasi selengkapnya, lihat dokumentasi klien web CloudWatch RUM.

Nama	Tipe	Deskripsi
Peristiwa	String	Jenis peristiwa DOM, seperti klik, gulir, atau arahkan kursor. Untuk informasi selengkapnya, silakan lihat Referensi Perintah.
Elemen	String	Jenis elemen DOM
ID Elemen	String	Jika elemen yang menghasilkan peristiwa memiliki ID, properti ini menyimpan ID tersebut. Untuk informasi selengkapnya, silakan lihat Element.id.
CSSLocator	String	Locator CSS digunakan untuk mengidentifikasi elemen DOM.
InteractionId	String	ID unik untuk interaksi antara pengguna dan UI.

Skema peristiwa navigasi

Peristiwa navigasi dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri performa.

Peristiwa navigasi menggunakan API pengaturan waktu Navigasi Level 1 dan Navigasi Level 2. API Level 2 tidak didukung di semua browser, jadi bidang yang lebih baru ini bersifat opsional.

catatan

Metrik stempel waktu didasarkan pada DOM. HighResTimestamp Dengan API Level 2, semua pengaturan waktu secara default relatif terhadap startTime. Tetapi untuk Level 1, metrik navigationStart dikurangi dari metrik timestamp untuk mendapatkan nilai relatif. Semua nilai timestamp dalam milidetik.

Peristiwa navigasi berisi properti berikut.

Nama	Tipe	Deskripsi	Catatan
initiatorType	String	Merupakan jenis sumber daya yang memulai peristiwa performa.	Nilai: "navigasi" Level 1: "navigasi" Level 2: entryData.initiatorType
navigationType	String	Merupakan jenis navigasi. Atribut ini tidak diperlukan.	Nilai: Nilai harus berupa salah satu dari berikut ini: navigate adalah navigasi yang dimulai dengan memilih tautan, memasukkan URL di bilah alamat browser, pengiriman formulir, atau menginisialisasi melalui operasi skrip selain reload atau back_forward . reload adalah navigasi melalui operasi muat ulang browser atau location.reload() . back_forward adalah navigasi melalui operasi penelusuran riwayat browser. prerender adalah navigasi yang diprakarsai petunjuk prerender. Untuk informasi selengkapnya, silakan lihat Prerender.
startTime	Nomor	Menunjukkan kapan peristiwa dipicu.	Nilai: 0 Level 1: entryData.navigationStart - entryData.navigationStart Level 2: entryData.startTime
unloadEventStart	Angka	Menunjukkan waktu ketika dokumen sebelumnya di jendela mulai dibongkar setelah peristiwa unload dilemparkan.	Nilai: Jika tidak ada dokumen sebelumnya atau jika dokumen sebelumnya atau salah satu pengalihan yang diperlukan tidak berasal dari asal yang sama, nilai yang dikembalikan adalah 0. Level 1: entryData.unloadEventStart > 0 ? entryData.unloadEventStart - entryData.navigationStart : 0 Level 2: EntryData. unloadEventStart
promptForUnload	Angka	Waktu yang dibutuhkan untuk membongkar dokumen. Dengan kata lain, waktu antara unloadEventStart dan unloadEventEnd. UnloadEventEnd mewakili momen dalam milidetik ketika penanganan peristiwa pembongkaran selesai.	Nilai: Jika tidak ada dokumen sebelumnya atau jika dokumen sebelumnya atau salah satu pengalihan yang diperlukan tidak berasal dari asal yang sama, nilai yang dikembalikan adalah 0. Level 1: EntryData. unloadEventEnd - EntryData. unloadEventStart Level 2: EntryData. unloadEventEnd - EntryData. unloadEventStart
redirectCount	Nomor	Angka yang mewakili jumlah pengalihan sejak navigasi non-pengalihan terakhir di bawah konteks penjelajahan saat ini. Atribut ini tidak diperlukan.	Nilai: Jika tidak ada pengalihan atau jika ada pengalihan yang tidak memiliki asal yang sama dengan dokumen tujuan, nilai yang dikembalikan adalah 0. Level 1: Tidak tersedia Level 2: entryData.redirectCount
redirectStart	Nomor	Waktu ketika pengalihan HTTP pertama dimulai.	Nilai: Jika tidak ada pengalihan atau jika ada pengalihan yang tidak memiliki asal yang sama dengan dokumen tujuan, nilai yang dikembalikan adalah 0. Level 1: entryData.redirectStart > 0 ? entryData.redirectStart - entryData.navigationStart : 0 Level 2: entryData.redirectStart
redirectTime	Nomor	Waktu yang dibutuhkan untuk pengalihan HTTP. Inilah perbedaan antara redirectStart dan redirectEnd.	Level 1: : entryData.redirectEnd - entryData.redirectStart Level 2: : entryData.redirectEnd - entryData.redirectStart
workerStart	Nomor	Ini adalah properti antarmuka PerformanceResourceTiming. Ini menandai awal operasi thread pekerja. Atribut ini tidak diperlukan.	Nilai: Jika thread Service Worker sudah berjalan, atau segera sebelum memulai thread Service Worker, properti ini mengembalikan waktu segera sebelum pengiriman FetchEvent. Ini mengembalikan 0 jika sumber daya tidak dicegat Service Worker. Level 1: Tidak tersedia Level 2: entryData.workerStart
workerTime	Nomor	Jika sumber daya dicegat oleh Service Worker, ini mengembalikan waktu yang diperlukan untuk operasi thread pekerja. Atribut ini tidak diperlukan.	Level 1: Tidak tersedia Level 2: entryData.workerStart > 0 ? entryData.fetchStart - entryData.workerStart : 0
fetchStart	Nomor	Waktu ketika browser siap untuk mengambil dokumen menggunakan permintaan HTTP. Ini sebelum memeriksa cache aplikasi apa pun.	Level 1: : entryData.fetchStart > 0 ? entryData.fetchStart - entryData.navigationStart : 0 Level 2: entryData.fetchStart
domainLookupStart	Angka	Waktu ketika pencarian domain dimulai.	Nilai: Jika koneksi persisten digunakan atau jika informasi disimpan dalam cache atau sumber daya lokal, nilai akan sama dengan fetchStart. Level 1: entryData.domainLookupStart > 0 ? entryData.domainLookupStart - entryData.navigationStart : 0 Level 2: EntryData. domainLookupStart
dns	Nomor	Waktu yang dibutuhkan untuk pencarian domain.	Nilai: Jika sumber daya dan catatan DNS di-cache, nilai yang diharapkan adalah 0. Level 1: EntryData. domainLookupEnd - EntryData. domainLookupStart Level 2: EntryData. domainLookupEnd - EntryData. domainLookupStart
nextHopProtocol	String	Sebuah string yang mewakili protokol jaringan yang digunakan untuk mengambil sumber daya. Atribut ini tidak diperlukan.	Level 1: Tidak tersedia Level 2: EntryData. nextHopProtocol
connectStart	Nomor	Waktu segera sebelum agen pengguna mulai membuat koneksi ke server untuk mengambil dokumen.	Nilai: Jika koneksi persisten RFC2616 digunakan, atau jika dokumen saat ini diambil dari cache aplikasi yang relevan atau sumber daya lokal, atribut ini mengembalikan nilai domainLookupEnd. Level 1: entryData.connectStart > 0 ? entryData.connectStart - entryData.navigationStart : 0 Level 2: entryData.connectStart
menghubungkan	Nomor	Mengukur waktu yang diperlukan untuk membuat koneksi transportasi atau untuk melakukan autentikasi SSL. Ini juga termasuk waktu yang diblokir yang diambil ketika ada terlalu banyak permintaan bersamaan yang dikeluarkan oleh browser.	Level 1: entryData.connectEnd - entryData.connectStart Level 2: entryData.connectEnd - entryData.connectStart
secureConnectionStart	Angka	Jika skema URL halaman saat ini adalah "https", atribut ini mengembalikan waktu segera sebelum agen pengguna memulai proses jabat tangan untuk mengamankan koneksi saat ini. Ini mengembalikan 0 jika HTTPS tidak digunakan. Untuk informasi selengkapnya tentang skema URL, silakan lihat representasi URL.	Rumus: EntryData. secureConnectionStart
tlsTime	Nomor	Waktu yang dibutuhkan untuk menyelesaikan jabat tangan SSL.	Level 1: entryData.secureConnectionStart > 0 ? entryData.connectEnd - entryData.secureConnectionStart : 0 Level 2: entryData.secureConnectionStart > 0 ? entryData.connectEnd - entryData.secureConnectionStart : 0
requestStart	Nomor	Waktu segera sebelum agen pengguna mulai meminta sumber daya dari server, atau dari cache aplikasi yang relevan, atau dari sumber daya lokal.	Level 1: : entryData.requestStart > 0 ? entryData.requestStart - entryData.navigationStart : 0 Level 2: entryData.requestStart
timeToFirstByte	Angka	Waktu yang dibutuhkan untuk menerima byte pertama informasi setelah permintaan dibuat. Waktu ini relatif terhadap startTime.	Level 1: entryData.responseStart - entryData.requestStart Level 2: entryData.responseStart - entryData.requestStart
responseStart	Nomor	Waktu segera setelah parser HTTP agen pengguna menerima byte pertama respons dari cache aplikasi yang relevan, atau dari sumber daya lokal, atau dari server.	Level 1: entryData.responseStart > 0 ? entryData.responseStart - entryData.navigationStart : 0 Level 2: entryData.responseStart
responseTime	String	Waktu yang dibutuhkan untuk menerima respons lengkap dalam bentuk byte dari cache aplikasi yang relevan, atau dari sumber daya lokal, atau dari server.	Level 1: entryData.responseStart > 0 ? entryData.responseEnd - entryData.responseStart : 0 Level 2: entryData.responseStart > 0 ? entryData.responseEnd - entryData.responseStart : 0
domInteractive	Nomor	Waktu ketika parser selesai bekerja pada dokumen utama, dan HTML DOM dibangun. Pada saat ini, perubahan Document.readyState ini menjadi "interaktif" dan peristiwa readystatechange yang sesuai dilemparkan.	Level 1: entryData.domInteractive > 0 ? entryData.domInteractive - entryData.navigationStart : 0 Level 2: entryData.domInteractive
domContentLoadedEventStart	Angka	Merupakan nilai waktu yang sama dengan waktu segera sebelum agen pengguna mengaktifkan ContentLoaded peristiwa DOM pada dokumen saat ini. ContentLoaded Peristiwa TheDOM diaktifkan ketika dokumen HTML awal telah dimuat dan diurai sepenuhnya. Pada saat ini, dokumen HTML utama telah selesai diuraikan, browser mulai membangun pohon render, dan subsumber daya masih harus dimuat. Ini tidak menunggu style sheet, citra, dan subframe untuk menyelesaikan pemuatan.	Level 1: entryData.domContentLoadedEventStart > 0 ? entryData.domContentLoadedEventStart - entryData.navigationStart : 0 Level 2: EntryData. domContentLoadedEventStart
domContentLoaded	Angka	Waktu mulai dan akhir konstruksi pohon render ini ditandai dengan domContentLoadedEventStart dan domContentLoadedEventEnd. Ini memungkinkan CloudWatch RUM melacak eksekusi. Properti adalah perbedaan antara domContentLoadedStart dan domContentLoadedEnd. Selama waktu ini, DOM dan CSSOM sudah siap. Properti ini menunggu eksekusi skrip, kecuali skrip asinkron dan dibuat secara dinamis. Jika skrip bergantung pada style sheet, domContentLoaded menunggu di style sheet juga. Ini tidak menunggu pada gambar. catatan Nilai sebenarnya dari domContentLoadedStart dan domContentLoadedEnd mendekati domContentLoaded di panel Jaringan Google Chrome. Ini menunjukkan waktu konstruksi pohon render HTML DOM + CSSOM dari awal proses pemuatan halaman. Dalam kasus metrik navigasi, nilai domContentLoaded mewakili perbedaan antara nilai awal dan akhir, yang merupakan waktu yang diperlukan untuk mengunduh subsumber daya dan konstruksi pohon render saja.	Level 2: EntryData. domContentLoadedEventEnd - EntryData. domContentLoadedEventStart Level 2: EntryData. domContentLoadedEventEnd - EntryData. domContentLoadedEventStart
domComplete	Nomor	Waktu segera sebelum browser mengatur kesiapan dokumen saat ini dari dokumen saat ini untuk diselesaikan. Di titik ini, pemuatan subsumber daya, seperti gambar, selesai. Ini termasuk waktu yang dibutuhkan untuk mengunduh konten pemblokiran seperti CSS dan sinkron. JavaScript Ini mendekati loadTime di panel Jaringan Google Chrome.	Level 1: entryData.domComplete > 0 ? entryData.domComplete - entryData.navigationStart : 0 Level 2: entryData.domComplete
domProcessingTime	Angka	Total waktu antara respons dan acara pemuatan dimulai.	Level 1: EntryData. loadEventStart - EntryData.responseEnd Level 2: EntryData. loadEventStart - EntryData.responseEnd
loadEventStart	Angka	Waktu segera sebelum peristiwa load dari dokumen saat ini terpicu.	Level 1: entryData.loadEventStart > 0 ? entryData.loadEventStart - entryData.navigationStart : 0 Level 2: EntryData. loadEventStart
loadEventTime	Angka	Perbedaan antara loadEventStart dan loadEventEnd . Fungsi atau logika tambahan yang menunggu peristiwa pemuatan ini akan diaktifkan selama waktu ini.	Level 1: EntryData. loadEventEnd - EntryData. loadEventStart Level 2: EntryData. loadEventEnd - EntryData. loadEventStart
durasi	String	Durasi adalah total waktu muat halaman. Ini mencatat waktu untuk mengunduh halaman utama dan semua subsumber daya sinkron, dan juga merender halaman. Sumber daya asinkron seperti skrip terus diunduh nanti. Ini adalah perbedaan antara properti loadEventEnd dan properti startTime.	Level 1: EntryData. loadEventEnd - EntryData.navigationStart Level 2: entryData.duration
headerSize	Nomor	Mengembalikan perbedaan antara transferSize dan encodedBodySize. Atribut ini tidak diperlukan.	Level 1: Tidak tersedia Level 2: EntryData.transferSize - EntryData. encodedBodySize Level 2: EntryData.transferSize - EntryData. encodedBodySize
compressionRatio	Nomor	Rasio encodedBodySize dan decodedBodySize. Nilai encodedBodySize adalah ukuran terkompresi dari sumber daya tidak termasuk header HTTP. Nilai decodedBodySize adalah ukuran sumber daya yang didekompresi tidak termasuk header HTTP. Atribut ini tidak diperlukan.	Level 1: Tidak tersedia. Level 2: entryData.encodedBodySize > 0 ? entryData.decodedBodySize / entryData.encodedBodySize : 0
navigationTimingLevel	Angka	Versi API waktu navigasi.	Nilai: 1 atau 2

Skema peristiwa sumber daya

Peristiwa sumber daya dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri performa.

Metrik stempel waktu didasarkan pada The DOM typedef. HighResTimeStamp Dengan API Level 2, secara default semua pengaturan waktu relatif terhadap startTime. Tetapi untuk API Level 1, metrik navigationStart dikurangi dari metrik stempel waktu untuk mendapatkan nilai relatif. Semua nilai timestamp dalam milidetik.

Peristiwa sumber daya yang dihasilkan oleh agen berisi properti berikut.

Nama	Tipe	Deskripsi	Catatan
targetUrl	String	Mengembalikan URL sumber daya.	Formula: entryData.name
initiatorType	String	Merupakan jenis sumber daya yang memulai peristiwa sumber daya performa.	Nilai: "sumber daya" Formula: entryData.initiatorType
durasi	String	Mengembalikan perbedaan antara properti responseEnd dan properti startTime. Atribut ini tidak diperlukan.	Formula: entryData.duration
transferSize	Nomor	Mengembalikan ukuran (dalam oktet) sumber daya yang diambil, termasuk bidang header respons dan tubuh muat respons. Atribut ini tidak diperlukan.	Formula: entryData.transferSize
fileType	String	Ekstensi berasal dari pola URL target.

Skema peristiwa catatan terbesar yang memuaskan

Peristiwa catatan terbesar yang memuaskan berisi properti berikut.

Peristiwa ini dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri performa.

Nama	Penjelasan
Nilai	Untuk informasi selengkapnya, silakan lihat Web Vitals.

Peristiwa penundaan input pertama

Peristiwa penundaan input pertama berisi properti berikut.

Peristiwa ini dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri performa.

Nama	Penjelasan
Nilai	Untuk informasi selengkapnya, silakan lihat Web Vitals.

Peristiwa pergeseran tata letak kumulatif

Peristiwa pergeseran tata letak kumulatif berisi properti berikut.

Peristiwa ini dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri performa.

Nama	Penjelasan
Nilai	Untuk informasi selengkapnya, silakan lihat Web Vitals.

Peristiwa HTTP

Peristiwa HTTP dapat berisi properti berikut. Ini akan berisi bidang Response atau bidang Error, tetapi tidak keduanya.

Peristiwa ini dikumpulkan hanya jika monitor aplikasi mengaktifkan telemetri HTTP.

Nama	Penjelasan
Permintaan	Kolom permintaan mencakup hal berikut ini: Bidang Method, yang dapat memiliki nilai-nilai seperti GET, POST, dan sebagainya. URL
Respons	Bidang respons mencakup hal berikut ini: Status, seperti 2xx, 4xx, atau 5xx Teks status
Kesalahan	Bidang kesalahan mencakup berikut ini: Tipe Pesan Nama file Nomor baris Nomor kolom Jejak tumpukan

Skema peristiwa jejak X-Ray

Peristiwa ini dikumpulkan hanya jika monitor aplikasi mengaktifkan pelacakan X-Ray.

Untuk informasi tentang skema peristiwa jejak X-Ray, silakan lihat dokumen segmen AWS X-Ray.