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

Memodifikasi cuplikan kode untuk mengkonfigurasi klien CloudWatch RUM web (opsional)

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

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

Mencegah pengumpulan sumber daya URLs yang mungkin berisi informasi pribadi

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

Jika ini adalah kasus untuk aplikasi Anda, kami sangat menyarankan agar Anda menonaktifkan pengumpulan sumber daya URLs 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 kapan riwayat browser API 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. Misalnya, pertimbangkan aplikasi web yang memiliki URI pengenal variabel, seperti /entity/123 atau/entity/456. Secara default, CloudWatch RUM buat acara tampilan halaman untuk masing-masing 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, pilih Lacak layanan saya dengan AWS X-Raymemungkinkan penelusuran XMLHttpRequest dan fetch permintaan yang dibuat selama sesi pengguna yang diambil sampelnya oleh monitor aplikasi. Anda kemudian dapat melihat jejak dari HTTP permintaan ini di CloudWatch RUM dasbor, 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 CloudWatch RUM web menambahkan header jejak X-Ray ke HTTP permintaan.

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>

Untuk informasi selengkapnya, lihat dokumentasi klien CloudWatch RUM web