(Opsional) Langkah 3: Secara manual memodifikasi cuplikan kode untuk mengkonfigurasi klien web CloudWatch RUM

Anda dapat memodifikasi potongan kode sebelum memasukkannya ke dalam aplikasi Anda, untuk mengaktifkan atau menonaktifkan beberapa opsi. Untuk informasi selengkapnya, lihat dokumentasi klien web CloudWatch RUM.

Ada tiga opsi konfigurasi yang harus Anda ketahui, seperti yang dibahas di bagian ini.

Mencegah pengumpulan URL sumber daya yang mungkin berisi informasi pribadi

Secara default, klien web CloudWatch RUM dikonfigurasi untuk merekam URL sumber daya yang diunduh oleh aplikasi. Sumber daya ini termasuk file HTML, gambar, file CSS, JavaScript file, dan sebagainya. Untuk beberapa aplikasi, URL mungkin berisi informasi pengenal pribadi (PII).

Jika ini kasus untuk aplikasi Anda, kami sangat menyarankan agar Anda menonaktifkan pengumpulan URL sumber daya dengan mengatur recordResourceUrl: false dalam konfigurasi potongan kode, sebelum memasukkannya ke dalam aplikasi Anda.

Merekam tampilan halaman secara manual

Secara default, klien web mencatat tampilan halaman saat halaman pertama kali dimuat dan saat API riwayat browser dipanggil. ID halaman default adalah window.location.pathname. Namun demikian, dalam beberapa kasus Anda mungkin ingin mengganti perilaku ini dan instrumen aplikasi untuk merekam tampilan halaman secara terprogram. Melakukannya memberi Anda kendali atas ID halaman dan kapan direkam. Sebagai contoh, pertimbangkan aplikasi web yang memiliki URI dengan pengenal variabel, seperti /entity/123 atau /entity/456. Secara default, CloudWatch RUM menghasilkan peristiwa tampilan halaman untuk setiap URI dengan ID halaman berbeda yang cocok dengan nama jalur, tetapi Anda mungkin ingin mengelompokkannya dengan ID halaman yang sama. Untuk mencapai hal ini, nonaktifkan otomatisasi tampilan halaman klien web menggunakan konfigurasi disableAutoPageView, dan gunakan perintah recordPageView untuk mengatur ID halaman yang diinginkan. Untuk informasi selengkapnya, lihat Konfigurasi Khusus Aplikasi pada. GitHub

Contoh skrip tersemat:

cwr('recordPageView', { pageId: 'entityPageId' });

JavaScript contoh modul:

awsRum.recordPageView({ pageId: 'entityPageId' });

Mengaktifkan penelusuran X-Ray end-to-end

Saat Anda membuat monitor aplikasi, memilih Lacak layanan saya dengan AWS X-Ray memungkinkan pelacakan permintaan XMLHttpRequest dan fetch yang dibuat selama sesi pengguna yang diambil sampelnya oleh monitor aplikasi. Anda kemudian dapat melihat jejak dari permintaan HTTP ini di dasbor CloudWatch RUM, dan halaman detail X-Ray Trace Map dan Trace.

Secara default, jejak sisi klien ini tidak terhubung ke jejak sisi server hilir. Untuk menghubungkan jejak sisi klien ke jejak sisi server dan mengaktifkan end-to-end penelusuran, atur addXRayTraceIdHeader opsi ke klien web. true Hal ini menyebabkan klien web CloudWatch RUM menambahkan header jejak X-Ray ke permintaan HTTP.

Blok kode berikut menunjukkan contoh penambahan jejak sisi klien. Beberapa opsi konfigurasi dihilangkan dari sampel ini untuk kemudahan pembacaan.

<script>
    (function(n,i,v,r,s,c,u,x,z){...})(
        'cwr',
        '00000000-0000-0000-0000-000000000000',
        '1.0.0',
        'us-west-2',
        'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
        {
            enableXRay: true,
            telemetries: [ 
                'errors', 
                'performance',
                [ 'http', { addXRayTraceIdHeader: true } ]
            ]
        }
    );
</script>

Awas

Mengkonfigurasi klien web CloudWatch RUM untuk menambahkan header jejak X-Ray ke permintaan HTTP dapat menyebabkan berbagi sumber daya lintas asal (CORS) gagal atau membatalkan tanda tangan permintaan jika permintaan ditandatangani dengan SigV4. Untuk informasi selengkapnya, lihat dokumentasi klien web CloudWatch RUM. Kami sangat menyarankan Anda menguji aplikasi Anda sebelum menambahkan header jejak sinar X sisi klien di lingkungan produksi.

Untuk informasi selengkapnya, lihat dokumentasi klien web CloudWatch RUM