View a markdown version of this page

Informasi yang dikumpulkan oleh klien web CloudWatch RUM - Amazon CloudWatch

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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.

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, lihat Error.prototype.name.

Beberapa browser mungkin tidak mendukung jenis kesalahan.

Pesan kesalahan

String

Pesan kesalahan. Untuk informasi selengkapnya, lihat Error.prototype.message. Jika bidang kesalahan tidak ada, ini adalah pesan dari peristiwa kesalahan. Untuk informasi selengkapnya, 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, 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, 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. DOMHighResTimestamp 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: entri Data.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: entri Data.navigationStart - entri Data.navigationStart

Level 2: entri Data.startTime

membongkar EventStart

Bilangan

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: entri Data.unloadEventStart

cepat ForUnload

Bilangan

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: entri Data.unloadEventEnd - entri Data.unloadEventStart

Level 2: entri Data.unloadEventEnd - entri Data.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: entri Data.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: entri Data.redirectStart

redirectTime

Nomor

Waktu yang dibutuhkan untuk pengalihan HTTP. Inilah perbedaan antara redirectStart dan redirectEnd.

Level 1:: entri Data.redirectEnd - entri Data.redirectStart

Level 2:: entri Data.redirectEnd - entri Data.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: entri Data.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: entri Data.fetchStart

domain LookupStart

Bilangan

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: entri Data.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: entri Data.domainLookupEnd - entri Data.domainLookupStart

Level 2: entri Data.domainLookupEnd - entri Data.domainLookupStart

berikutnya HopProtocol

String

Sebuah string yang mewakili protokol jaringan yang digunakan untuk mengambil sumber daya.

Atribut ini tidak diperlukan.

Level 1: Tidak tersedia

Level 2: entri Data.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: entri Data.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: entri Data.connectEnd - entri Data.connectStart

Level 2: entri Data.connectEnd - entri Data.connectStart

aman ConnectionStart

Bilangan

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.

Formula: entri Data.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: entri Data.requestStart

waktu ToFirstByte

Bilangan

Waktu yang dibutuhkan untuk menerima byte pertama informasi setelah permintaan dibuat. Waktu ini relatif terhadap startTime.

Level 1: entri Data.responseStart - entri Data.requestStart

Level 2: entri Data.responseStart - entri Data.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: entri Data.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: entri Data.domInteractive

dom ContentLoadedEventStart

Bilangan

Merupakan nilai waktu yang sama dengan waktu segera sebelum agen pengguna mengaktifkan DOMContentLoaded acara pada dokumen saat ini. TheDOMContentLoaded peristiwa diaktifkan ketika dokumen HTML awal telah sepenuhnya dimuat dan diurai. 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: entri Data.domContentLoadedEventStart

dom ContentLoaded

Bilangan

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: entri Data.domContentLoadedEventEnd - entri Data.domContentLoadedEventStart

Level 2: entri Data.domContentLoadedEventEnd - entri Data.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: entri Data.domComplete

dom ProcessingTime

Bilangan

Total waktu antara respons dan acara pemuatan dimulai.

Level 1: entri Data.loadEventStart - entri Data.responseEnd

Level 2: entri Data.loadEventStart - entri Data.responseEnd

beban EventStart

Bilangan

Waktu segera sebelum peristiwa load dari dokumen saat ini terpicu.

Level 1:

entryData.loadEventStart > 0 ? entryData.loadEventStart - entryData.navigationStart : 0

Level 2: entri Data.loadEventStart

beban EventTime

Bilangan

Perbedaan antara loadEventStart dan loadEventEnd . Fungsi atau logika tambahan yang menunggu peristiwa pemuatan ini akan diaktifkan selama waktu ini.

Level 1: entri Data.loadEventEnd - entri Data.loadEventStart

Level 2: entri Data.loadEventEnd - entri Data.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: entri Data.loadEventEnd - entri Data.navigationStart

Level 2: entri Data.duration

headerSize

Nomor

Mengembalikan perbedaan antara transferSize dan encodedBodySize.

Atribut ini tidak diperlukan.

Level 1: Tidak tersedia

Level 2: entri Data.transferSize - entri Data.encodedBodySize

Level 2: entri Data.transferSize - entri Data.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

navigasi TimingLevel

Bilangan

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 typedef. DOMHighResTimeStamp 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: entri Data.name

initiatorType

String

Merupakan jenis sumber daya yang memulai peristiwa sumber daya performa.

Nilai: "sumber daya"

Formula: entri Data.initiatorType

durasi

String

Mengembalikan perbedaan antara properti responseEnd dan properti startTime.

Atribut ini tidak diperlukan.

Formula: entri Data.duration

transferSize

Nomor

Mengembalikan ukuran (dalam oktet) sumber daya yang diambil, termasuk bidang header respons dan tubuh muat respons.

Atribut ini tidak diperlukan.

Formula: entri Data.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 Deskripsi

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 Deskripsi

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 Deskripsi

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 Deskripsi

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

X-Ray melacak skema acara

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

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