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 web CloudWatch RUM (opsional)
<a name="CloudWatch-RUM-modify-snippet"></a>

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.](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md)

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

## Mencegah pengumpulan sumber daya URLs yang mungkin berisi informasi pribadi
<a name="CloudWatch-RUM-resourceURL"></a>

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

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

## Merekam tampilan halaman secara manual
<a name="CloudWatch-RUM-pageload"></a>

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](https://github.com/aws-observability/aws-rum-web/blob/main/docs/configuration.md) pada. GitHub

**Contoh skrip tersemat:**

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

**JavaScript contoh modul:**

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

## Mengaktifkan penelusuran X-Ray end-to-end
<a name="CloudWatch-RUM-xraytraceheader"></a>

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**  
Mengonfigurasi 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](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md). 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](https://github.com/aws-observability/aws-rum-web/blob/main/docs/cdn_installation.md#http)

## Mengirim permintaan yang tidak ditandatangani ke CloudWatch RUM
<a name="CloudWatch-RUM-unsigned"></a>

Secara default, klien web RUM menandatangani semua permintaan yang dikirim ke RUM. Jika Anda mengatur `signing:false` konfigurasi klien, permintaan akan dibatalkan saat dikirim ke CloudWatch RUM. Data akan dicerna ke RUM hanya jika ada kebijakan berbasis sumber daya publik yang dilampirkan ke monitor aplikasi. Untuk informasi selengkapnya, lihat [Menggunakan kebijakan berbasis sumber daya dengan RUM CloudWatch](CloudWatch-RUM-resource-policies.md).