Anda dapat mengonfigurasi event interaksi untuk satu atau beberapa atribut jejak guna menyelidiki lebih dalam bidang atau hasil kueri tertentu. Event interaksi memungkinkan Anda melakukan kueri detail jejak atau melihat log dan metrik terkait.
Event interaksi memungkinkan Anda beralih antar dimensi atau tingkat granularitas untuk memperoleh informasi yang lebih rinci. Trace Explorer mendukung konfigurasi event interaksi untuk bidang span dan atributnya. Jenis event berikut tersedia:
-
Buka log library: mengarahkan ke Logstore Simple Log Service (SLS) yang ditentukan.
-
Kustomisasi Tautan HTTP: mengarahkan ke URL HTTP yang ditentukan.
-
Buka dari kotak edit: menampilkan nilai bidang dalam format teks atau JSON di jendela pop-up.
-
Buka Quick Search: mengarahkan ke pencarian tersimpan SLS.
Konfigurasikan event interaksi kustom
-
Pada halaman Trace Explorer, klik ID jejak.
-
Klik antarmuka, lalu klik Event Config di bagian Span Details.
-
Di panel Drilldown Config, pilih mode efektif untuk event interaksi.
Event interaksi kustom mendukung dua mode: Service event configuration dan Global event configuration. Dalam mode Service event configuration, event berlaku untuk semua jejak pada aplikasi saat ini. Dalam mode Global event configuration, event berlaku untuk semua jejak di wilayah saat ini.
Secara default, bidang spanID dan traceID sudah dikonfigurasi. Anda dapat mengklik Add fields untuk menambahkan bidang baru atau mengklik ikon hapus untuk menghapus yang sudah ada.
-
Klik Add fields, pilih bidang, lalu klik OK.
Misalnya, pada tab Service Event Config di kotak dialog Drilldown Config, pilih bidang spanID dari daftar drop-down.
-
Klik Add event dan pilih event interaksi dari daftar drop-down.
Event yang tersedia adalah Open Logstore, Custom HTTP Link, Open in Editor, dan Open Quick Search.
-
Atur parameter untuk event tersebut, lalu klik OK.
Untuk informasi selengkapnya tentang parameter, lihat bagian Parameter event interaksi.
Panel konfigurasi memiliki dua tab: Service Event Config dan Global Event Config. Pilih item untuk membuka formulir konfigurasinya, tempat Anda dapat menentukan parameter seperti Custom Name dan Text type. Anda dapat menambahkan lebih banyak event dengan mengklik tombol Add event di bagian bawah.
Picu event interaksi kustom
Di bagian Span Details, arahkan pointer ke bidang berwarna biru. Tooltip akan menampilkan event interaksi kustom yang dikonfigurasi untuk bidang tersebut. Klik nama event untuk memicu event tersebut.
Misalnya, jika Anda mengarahkan kursor ke nilai bidang spanID, tooltip akan muncul. Bagian CUSTOM EVENT menampilkan event yang telah dikonfigurasi, seperti Open in Editor dan Query Associated Logs.
Parameter event interaksi
Open the log library
Saat dipicu, event Open the log library akan mengarahkan ke Logstore yang ditentukan.
-
Prasyarat
Logstore telah dibuat. Untuk informasi selengkapnya, lihat Manage a logstore.
-
Parameter
Parameter
Wajib
Deskripsi
Custom Name
Ya
Masukkan nama event interaksi kustom. Nama ini akan ditampilkan di tooltip.
Please select region
Ya
Pilih wilayah tempat proyek SLS berada.
Please select the project
Ya
Pilih nama proyek SLS.
Please select a log repository
Ya
Pilih nama Logstore SLS. Saat event dipicu, halaman akan dialihkan ke Logstore tersebut.
Open a new window
Tidak
Tentukan apakah Logstore akan dibuka di jendela pop-up saat event dipicu.
Time range
Tidak
Pilih rentang waktu data yang akan dikueri di Logstore. Nilai yang valid:
-
Default: Menggunakan rentang waktu default, yaitu 15 Menit (Relatif).
-
Use Query Time: Menggunakan rentang waktu yang ditentukan di Trace Explorer saat event dipicu.
-
Data Point Time: Waktu mulai rentang waktu adalah nilai parameter Time Range Field dikurangi nilai parameter Time range field difference. Waktu akhir rentang waktu adalah nilai parameter Time Range Field ditambah nilai parameter Time range field difference.
-
Relative time range: Menggunakan rentang waktu relatif yang ditentukan.
-
Time frame: Menggunakan titik per jam dalam jangka waktu yang ditentukan.
Filter statement
Tidak
Masukkan pernyataan filter untuk disinkronkan ke Logstore, lalu tambahkan sebelum pernyataan kueri menggunakan operator
AND.Klik Add variables untuk menambahkan bidang sebagai variabel ke dalam pernyataan filter dan gunakan nilai bidang tersebut sebagai kondisi filter.
Contoh:
traceId=${{traceID}} AND spanId=${{spanID}} -
Customize HTTP Link
Saat dipicu, event Customize HTTP Link akan mengarahkan ke URL HTTP yang ditentukan.
-
Prasyarat
URL HTTP tersedia.
-
Parameter
Parameter
Wajib
Deskripsi
Custom Name
Ya
Masukkan nama event interaksi kustom. Nama ini akan ditampilkan di tooltip.
agreement
Ya
Pilih protokol untuk URL HTTP.
Link address
Ya
Masukkan URL HTTP.
Jalur dalam URL HTTP menentukan hierarki menuju resource target. Klik Add variables untuk menambahkan bidang sebagai variabel dalam jalur tersebut. Saat event dipicu, nilai bidang akan menggantikan variabel dalam URL.
Whether to transcode
Tidak
Tentukan apakah URL HTTP akan di-encode.
Open a new window
Tidak
Tentukan apakah navigasi ke URL HTTP dilakukan di jendela pop-up saat event dipicu.
Open from the edit box
Saat dipicu, event Open from the edit box akan menampilkan nilai bidang dalam format teks atau JSON di jendela pop-up.
|
Parameter |
Wajib |
Deskripsi |
|
Custom Name |
Ya |
Masukkan nama event interaksi kustom. Nama ini akan ditampilkan di tooltip. |
|
Text type |
Tidak |
Pilih format untuk menampilkan nilai bidang. Nilai yang valid: text dan JSON. |
Open Quick Search
Saat dipicu, event Open Quick Search akan mengarahkan ke pencarian tersimpan SLS.
-
Prasyarat
Pencarian tersimpan telah dibuat di SLS. Untuk informasi selengkapnya, lihat Saved search.
Jika Anda ingin mengonfigurasi variabel untuk event interaksi, pastikan variabel tersebut telah dikonfigurasi dalam pernyataan kueri pencarian tersimpan. Untuk informasi selengkapnya, lihat Gunakan variabel untuk memodifikasi parameter pernyataan kueri secara dinamis.
-
Parameter
Parameter
Wajib
Deskripsi
Custom Name
Ya
Masukkan nama event interaksi kustom. Nama ini akan ditampilkan di tooltip.
Please select region
Ya
Pilih wilayah tempat proyek SLS berada.
Please select the project
Ya
Pilih nama proyek SLS.
Please select Quick Search
Ya
Pilih pencarian tersimpan. Saat event dipicu, halaman akan dialihkan ke pencarian tersimpan tersebut.
Open a new window
Tidak
Tentukan apakah pencarian tersimpan akan dibuka di jendela pop-up saat event dipicu.
Time range
Tidak
Pilih rentang waktu untuk mengkueri pencarian tersimpan. Nilai yang valid:
-
Default: Menggunakan rentang waktu default, yaitu 15 Menit (Relatif).
-
Use Query Time: Menggunakan rentang waktu yang ditentukan di Trace Explorer saat event dipicu.
-
Data Point Time: Waktu mulai rentang waktu adalah nilai parameter Time Range Field dikurangi nilai parameter Time range field difference. Waktu akhir rentang waktu adalah nilai parameter Time Range Field ditambah nilai parameter Time range field difference.
-
Relative time range: Menggunakan rentang waktu relatif yang ditentukan.
-
Relative time range: Menggunakan rentang waktu relatif yang ditentukan.
Filter statement
Tidak
Masukkan pernyataan filter untuk disinkronkan ke Logstore, lalu tambahkan sebelum pernyataan kueri menggunakan operator
AND.Klik Add variables untuk menambahkan bidang sebagai variabel ke dalam pernyataan filter dan gunakan nilai bidang tersebut sebagai kondisi filter.
Dynamic variables
Tidak
SLS memungkinkan Anda memodifikasi pernyataan kueri pencarian tersimpan menggunakan variabel. Jika variabel yang Anda tentukan di sini sama dengan yang ditentukan dalam pernyataan kueri, maka variabel yang ditentukan di sini akan digunakan.
CatatanAnda dapat menambahkan hingga lima variabel dinamis dan lima variabel statis.
-
Variabel dinamis
-
Variable: nama variabel.
-
Variable Value Column: kolom tempat nilai variabel berada. Nilai ini digunakan untuk mengganti variabel secara dinamis dalam pencarian tersimpan.
-
-
Variabel statis
-
Variable: nama variabel.
-
Value: nilai variabel statis, yang digunakan untuk mengganti placeholder variabel dalam pencarian tersimpan.
-
Static variables
Tidak
-
Event interaksi preset (pengaturan lanjutan)
Trace Explorer menyediakan event interaksi preset berikut.
Mengklik nilai bidang di panel Span Details akan membuka menu pop-up. Bagian Advanced Settings berisi event interaksi preset, sedangkan bagian CUSTOM EVENT berisi event buatan pengguna. Untuk mengelola event ini, klik Event Config di bagian bawah.
|
Event |
Bidang efektif |
Deskripsi |
|
Gunakan kondisi saat ini untuk mengkueri jejak |
Semua kecuali Span Events |
Menambahkan bidang sebagai kondisi kueri. |
|
Lihat detail aplikasi |
serviceName |
Mengarahkan ke tab Application Overview di halaman detail aplikasi. |
|
Lihat layanan yang disediakan |
spanName |
Mengarahkan ke tab Provided Services di halaman detail aplikasi. |
|
Lihat detail pemantauan instans |
IP |
Mengarahkan ke tab Instance Monitoring di halaman detail aplikasi. |
|
Lihat data jejak mentah |
TraceID dan SpanId |
Menampilkan data jejak mentah yang disimpan di SLS. |
Catatan penggunaan
Jika Anda mengakses Trace Explorer melalui nama domain virtual (misalnya, dengan menyematkan halaman konsol ARMS ke aplikasi web yang dikelola sendiri), memicu event Open the log library atau Open Quick Search akan mengarahkan Anda ke halaman login SLS, bukan ke konsol SLS. Jika Anda tidak menggunakan nama domain virtual, Anda dapat menggunakan event Customize HTTP Link untuk mengonfigurasi dua pengalihan. Lakukan langkah-langkah berikut:
-
Konfigurasikan event Customize HTTP Link.
-
Pilih protokol HTTPS dan masukkan URL halaman konsol SLS di bidang Link Address.
-
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 shareable URLs.
-
Jika Anda ingin menyertakan parameter kueri saat mengakses Logstore, klik Add variables untuk menambahkannya sebagai variabel.
URL berikut membuka Logstore bernama test-logstore dengan proyek test-project, serta mencari jejak saat ini.
https://sls.console.alibabacloud.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{traceID}}