Kirim peristiwa kustom - Amazon CloudWatch

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

Kirim peristiwa kustom

CloudWatch RUM mencatat dan mencerna peristiwa yang tercantum diInformasi yang dikumpulkan oleh klien web CloudWatch RUM. Jika Anda menggunakan versi 1.12.0 atau yang lebih baru dari klien web CloudWatch RUM, Anda dapat menentukan, merekam, dan mengirim acara khusus tambahan. Anda menentukan nama jenis peristiwa dan data yang akan dikirim untuk setiap jenis peristiwa yang Anda tentukan. Setiap muatan peristiwa khusus dapat mencapai 6 KB.

Peristiwa kustom hanya diserap jika monitor aplikasi telah mengaktifkan peristiwa kustom. Untuk memperbarui setelan konfigurasi monitor aplikasi Anda, gunakan konsol CloudWatch RUM atau UpdateAppMonitorAPI.

Setelah mengaktifkan peristiwa kustom, dan kemudian menentukan dan mengirim peristiwa kustom, Anda dapat mencarinya. Untuk mencarinya, gunakan tab Acara di konsol CloudWatch RUM. Cari menggunakan jenis peristiwa.

Persyaratan dan sintaks

Peristiwa kustom terdiri atas jenis peristiwa dan detail peristiwa. Persyaratan untuk ini adalah sebagai berikut:

  • Jenis peristiwa

    • Ini bisa berupa jenis atau nama peristiwa Anda. Misalnya, tipe acara bawaan CloudWatch RUM yang disebut JsErrormemiliki tipe acaracom.amazon.rum.js_error_event.

    • Harus antara 1 hingga 256 karakter.

    • Dapat berupa kombinasi karakter alfanumerik, garis bawah, tanda hubung, dan titik.

  • Detail peristiwa

    • Berisi data aktual yang ingin Anda rekam dalam CloudWatch RUM.

    • Harus berupa objek yang terdiri atas bidang dan nilai.

Contoh merekam peristiwa kustom

Ada dua cara untuk merekam peristiwa khusus di klien web CloudWatch RUM.

  • Gunakan recordEvent API klien web CloudWatch RUM.

  • Gunakan plugin yang disesuaikan.

Kirim peristiwa kustom menggunakan API recordEvent, contoh NPM

awsRum.recordEvent('my_custom_event', { location: 'IAD', current_url: 'amazonaws.com', user_interaction: { interaction_1 : "click", interaction_2 : "scroll" }, visit_count:10 } )

Kirim peristiwa kustom menggunakan API recordEvent, contoh skrip yang ditanamkan

cwr('recordEvent', { type: 'my_custom_event', data: { location: 'IAD', current_url: 'amazonaws.com', user_interaction: { interaction_1 : "click", interaction_2 : "scroll" }, visit_count:10 } })

Contoh pengiriman peristiwa khusus menggunakan plugin yang disesuaikan

// Example of a plugin that listens to a scroll event, and // records a 'custom_scroll_event' that contains the timestamp of the event. class MyCustomPlugin implements Plugin { // Initialize MyCustomPlugin. constructor() { this.enabled; this.context; this.id = 'custom_event_plugin'; } // Load MyCustomPlugin. load(context) { this.context = context; this.enable(); } // Turn on MyCustomPlugin. enable() { this.enabled = true; this.addEventHandler(); } // Turn off MyCustomPlugin. disable() { this.enabled = false; this.removeEventHandler(); } // Return MyCustomPlugin Id. getPluginId() { return this.id; } // Record custom event. record(data) { this.context.record('custom_scroll_event', data); } // EventHandler. private eventHandler = (scrollEvent: Event) => { this.record({timestamp: Date.now()}) } // Attach an eventHandler to scroll event. private addEventHandler(): void { window.addEventListener('scroll', this.eventHandler); } // Detach eventHandler from scroll event. private removeEventHandler(): void { window.removeEventListender('scroll', this.eventHandler); } }