Application Real-Time Monitoring Service:Konfigurasikan event interaksi kustom

Event interaksi merupakan fitur penting dalam analisis data. Dengan mengubah dimensi data dan granularitas analisis, Anda dapat memperoleh wawasan yang lebih mendalam dari data Anda. Analisis Trace memungkinkan Anda menetapkan event interaksi untuk bidang dan atribut suatu span. Jenis event interaksi yang tersedia meliputi:

• Open Logstore: Mengalihkan ke halaman Logstore target di Simple Log Service (SLS).

• Custom HTTP Link: Mengalihkan ke URL HTTP target.

• Open in Editor: Menampilkan nilai bidang dalam format teks atau JSON di jendela pop-up.

• Open Saved Search: Mengalihkan ke halaman pencarian tersimpan target di Simple Log Service (SLS).

Tambahkan event interaksi kustom

1. Pada halaman Trace Explorer, klik TraceID suatu trace.

2. Pilih span target, lalu pada panel Span Details di sebelah kanan, klik Event Config.

3. Pada panel Drilldown Config, pilih cakupan untuk event interaksi.

   Event kustom memiliki dua cakupan: service event configuration dan global event configuration. Konfigurasi event layanan hanya berlaku untuk trace dari aplikasi saat ini, sedangkan konfigurasi event global berlaku untuk semua trace di wilayah saat ini.

   Pada tab service event configuration, klik Add Field untuk menambahkan bidang SpanId dan TraceID.

4. Klik Add Field, pilih bidang yang akan dikonfigurasi untuk event tersebut, lalu klik OK.

5. Klik Add Event dan pilih event interaksi dari daftar drop-down.

   Event interaksi yang tersedia mencakup Open Logstore, Custom HTTP Link, Open in Editor, dan Open Saved Search.

6. Konfigurasikan parameter event dan klik OK.

   Untuk detail parameter, lihat Parameter event interaksi.

   Pada tab service event configuration, tambahkan event untuk bidang SpanId. Konfigurasikan Custom Name dan pilih Text Type. Anda dapat mengklik Add Event untuk menambahkan lebih banyak event interaksi.

Memicu event kustom

Pada panel Span Details, arahkan kursor ke bidang yang disorot berwarna biru. Tooltip akan muncul, menampilkan event kustom yang telah dikonfigurasi. Klik nama event untuk memicu event interaksi tersebut.

Sebagai contoh, ketika Anda mengarahkan kursor ke nilai bidang SpanId, bagian Custom Events pada menu pop-up menampilkan event yang telah dikonfigurasi, seperti Open in Editor dan Query Associated Logs.

Parameter event interaksi

Open Logstore

Saat Anda memicu event interaksi Open Logstore, konsol akan mengalihkan Anda ke halaman Logstore SLS target.

• Prasyarat

  Logstore target harus sudah dibuat. Untuk informasi selengkapnya, lihat Manage Logstores.

• Parameter

  Parameter	Wajib	Deskripsi
  Custom name	Ya	Nama event interaksi kustom. Nama ini ditampilkan pada tooltip event kustom.
  Select region	Ya	Wilayah tempat proyek SLS target berada.
  Select project	Ya	Nama proyek SLS target.
  Select logstore	Ya	Nama Logstore target. Saat Anda memicu event interaksi, konsol akan mengalihkan ke Logstore ini.
  Open in new window	Tidak	Jika Anda mengaktifkan opsi ini, Logstore target akan terbuka di jendela browser baru saat Anda memicu event interaksi.
  Time range	Tidak	Menentukan rentang waktu kueri untuk Logstore target. Opsi: Preset: Setelah Anda membuka Logstore target, SLS menggunakan rentang waktu kueri default, yaitu 15 menit (relatif). Inherit current query time: Setelah Anda membuka Logstore target, rentang waktu kueri diwariskan dari halaman Analisis Trace pada saat Anda memicu event interaksi. Inherit data point time: Setelah Anda membuka Logstore target, waktu mulai kueri adalah nilai Time Range Field dikurangi Time Range Offset, dan waktu akhir adalah nilai Time Range Field ditambah Time Range Offset. Relative Time: Setelah Anda membuka Logstore target, waktu kueri adalah rentang waktu relatif yang ditentukan. Time Frame: Setelah Anda membuka Logstore target, waktu kueri adalah jangka waktu yang ditentukan.
  Filter statement	Tidak	Masukkan pernyataan filter. Sistem akan menyinkronkannya ke Logstore target dan menambahkannya di awal pernyataan kueri dengan operator AND. Klik Add Variable dalam pernyataan filter untuk menyisipkan nilai bidang sebagai kondisi filter. Contoh: traceId=${{TraceID}} AND spanId=${{SpanId}}

Custom HTTP Link

Saat Anda memicu event interaksi Custom HTTP Link, konsol akan mengalihkan Anda ke URL HTTP target.

• Prasyarat

  URL HTTP tersedia.

• Parameter

  Parameter	Wajib	Deskripsi
  Custom name	Ya	Nama event interaksi kustom. Nama ini ditampilkan pada tooltip event kustom.
  Protocol	Ya	Protokol URL HTTP, seperti HTTP atau HTTPS.
  URL	Ya	URL tujuan. Jalur dalam URL HTTP merepresentasikan jalur hirarkis ke resource target. Anda dapat mengklik Add Variable untuk menyisipkan variabel ke dalam jalur URL. Saat tautan diklik, sistem akan mengganti variabel tersebut dengan nilai bidang yang sesuai dan mengalihkan ke URL yang telah diperbarui.
  Encode URL	Tidak	Jika Anda mengaktifkan Encode URL, konten tautan akan di-encode dalam format URL.
  Open in new window	Tidak	Jika Anda mengaktifkan opsi ini, URL HTTP target akan terbuka di jendela browser baru saat event interaksi dipicu.

Open in Editor

Saat Anda memicu event interaksi Open in Editor, konsol akan menampilkan nilai bidang dalam format teks atau JSON di jendela pop-up.

Open Saved Search

Saat Anda memicu event interaksi Open Saved Search, konsol akan mengalihkan Anda ke halaman pencarian tersimpan SLS target.

• Prasyarat

  Pencarian tersimpan target harus sudah dibuat di SLS. Untuk informasi selengkapnya, lihat Saved searches.

  Untuk menggunakan variabel, konfigurasikan variabel tersebut dalam pernyataan kueri pencarian tersimpan target. Untuk informasi selengkapnya, lihat Dynamically adjust query statement parameters by using variables.

• Parameter

  Parameter	Wajib	Deskripsi
  Custom name	Ya	Nama event interaksi kustom. Nama ini ditampilkan pada tooltip event kustom.
  Select region	Ya	Wilayah tempat proyek SLS target berada.
  Select project	Ya	Nama proyek SLS target.
  Select saved search	Ya	Pencarian tersimpan target di SLS. Setelah Anda memicu event interaksi, konsol akan membuka halaman untuk pencarian tersimpan ini.
  Open in new window	Tidak	Jika Anda mengaktifkan opsi ini, halaman pencarian tersimpan target akan terbuka di jendela browser baru saat event interaksi dipicu.
  Time range	Tidak	Menentukan rentang waktu kueri untuk pencarian tersimpan target. Opsi: Preset: Setelah Anda membuka halaman pencarian tersimpan target, SLS menggunakan rentang waktu kueri default, yaitu 15 menit (relatif). Inherit current query time: Setelah Anda membuka halaman pencarian tersimpan target, rentang waktu kueri diwariskan dari halaman Analisis Trace pada saat Anda memicu event interaksi. Inherit data point time: Setelah Anda membuka halaman pencarian tersimpan target, waktu mulai kueri adalah nilai Time Range Field dikurangi Time Range Offset, dan waktu akhir adalah nilai Time Range Field ditambah Time Range Offset. Relative Time: Setelah Anda membuka halaman pencarian tersimpan target, waktu kueri adalah rentang waktu relatif yang ditentukan. Time Frame: Setelah Anda membuka halaman pencarian tersimpan target, waktu kueri adalah jangka waktu yang ditentukan.
  Filter statement	Tidak	Masukkan pernyataan filter. Sistem akan menyinkronkannya ke halaman pencarian tersimpan target dan menambahkannya di awal pernyataan kueri dengan operator AND. Klik Add Variable dalam pernyataan filter untuk menyisipkan nilai bidang sebagai kondisi filter.
  Dynamic variables	Tidak	SLS memungkinkan Anda menggunakan variabel untuk secara fleksibel memodifikasi pernyataan kueri dalam pencarian tersimpan target. Jika variabel yang ditambahkan di sini memiliki nama yang sama dengan variabel dalam kueri pencarian tersimpan target, nilai bidang yang memicu event interaksi akan menggantikan variabel tersebut dalam pernyataan kueri. Catatan Anda dapat menambahkan hingga lima variabel dinamis dan lima variabel statis. Dynamic variables Variable name: Nama variabel. Variable value column: Kolom yang nilainya secara dinamis menggantikan variabel dalam kueri pencarian tersimpan. Static variables Variable name: Nama variabel. Static value: Nilai tetap yang menggantikan variabel dalam kueri pencarian tersimpan.
  Static variables	Tidak

Event interaksi preset

Analisis Trace mencakup event interaksi preset berikut:

Saat Anda mengklik kanan nilai bidang span, menu konteks akan muncul. Menu ini terbagi menjadi bagian Advanced Configuration dan Custom Events. Bagian Advanced Configuration menampilkan event bawaan, seperti Query Trace with Current Condition dan View Application Details. Bagian Custom Events menampilkan event yang dikonfigurasi pengguna. Opsi Event Config di bagian bawah menu memungkinkan Anda mengelola event kustom.

FAQ

Jika Anda mengakses halaman Analisis Trace menggunakan nama domain virtual (misalnya, jika halaman ARMS disematkan di halaman web yang dikelola sendiri), memicu event Open Logstore atau Open Saved Search dapat mengalihkan Anda ke halaman login alih-alih konsol SLS. Untuk mengatasi masalah ini, gunakan event interaksi Custom HTTP Link untuk mencapai efek yang sama. Ikuti langkah-langkah berikut:

1. Buat event interaksi Custom HTTP Link.

2. Pilih https sebagai Protocol dan masukkan URL tujuan di bidang URL.

3. Siapkan URL SLS target. Ganti nama domain standar (sls.console.alibabacloud.com) dengan nama domain virtual SLS (sls4servims.console.alibabacloud.com). Untuk informasi selengkapnya, lihat Prepare a shareable link. Nonaktifkan Encode URL dan aktifkan Open in new window.

4. Jika Anda ingin meneruskan parameter kueri saat mengalihkan ke Logstore, klik Add Variable dan pilih variabel yang akan ditambahkan.

   Contoh URL berikut membuka Logstore bernama test-logstore dalam proyek test-project dan memfilter log di mana traceId sama dengan TraceID trace saat ini.

   https://sls4servims.console.alibabacloud.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{TraceID}}