Parameter drop-down buku kerja
Dengan menggunakan parameter dropdown, Anda dapat mengumpulkan satu atau beberapa nilai input dari set yang diketahui. Misalnya, Anda dapat menggunakan parameter dropdown untuk memilih salah satu permintaan aplikasi Anda. Parameter dropdown juga menyediakan cara yang mudah digunakan untuk mengumpulkan input arbitrer dari pengguna. Parameter dropdown secara khusus berguna dalam mengaktifkan pemfilteran dalam laporan interaktif Anda.
Cara termudah untuk menentukan parameter dropdown adalah dengan menyediakan daftar statis dalam pengaturan parameter. Cara yang lebih menarik adalah mendapatkan daftar secara dinamis melalui kueri KQL. Anda juga dapat menentukan apakah itu tunggal atau multipilih dengan menggunakan pengaturan parameter. Jika multipilih, Anda dapat menentukan seperti apa tataan hasil harus diformat, misalnya, sebagai pemisah atau kutipan.
Membuat parameter dropdown statis
Mulai dengan buku kerja kosong dalam mode edit.
Pilih Tambahkan parameter>Tambahkan Parameter.
Di panel parameter baru yang terbuka, masukkan:
- Nama parameter:
Environment
- Jenis parameter:
Drop down
- Diperlukan:
checked
- Izinkan banyak pilihan:
unchecked
- Dapatkan data dari:
JSON
- Nama parameter:
Di blok teks Input JSON, sisipkan cuplikan kode JSON ini:
[ { "value":"dev", "label":"Development" }, { "value":"ppe", "label":"Pre-production" }, { "value":"prod", "label":"Production", "selected":true } ]
Pilih Perbarui.
Pilih Simpan untuk membuat parameter.
Parameter Lingkungan adalah daftar dropdown dengan tiga nilai.
Membuat daftar dropdown statik dengan grup item
Jika hasil kueri/JSON Anda berisi group
bidang, daftar dropdown menampilkan grup nilai. Ikuti sampel sebelumnya, tetapi gunakan JSON berikut:
[
{ "value":"dev", "label":"Development", "group":"Development" },
{ "value":"dev-cloud", "label":"Development (Cloud)", "group":"Development" },
{ "value":"ppe", "label":"Pre-production", "group":"Test" },
{ "value":"ppe-test", "label":"Pre-production (Test)", "group":"Test" },
{ "value":"prod1", "label":"Prod 1", "selected":true, "group":"Production" },
{ "value":"prod2", "label":"Prod 2", "group":"Production" }
]
Membuat parameter dropdown dinamis
Mulai dengan buku kerja kosong dalam mode edit.
Pilih Tambahkan parameter>Tambahkan Parameter.
Di panel parameter baru yang terbuka, masukkan:
- Nama parameter:
RequestName
- Jenis parameter:
Drop down
- Diperlukan:
checked
- Izinkan banyak pilihan:
unchecked
- Dapatkan data dari:
Query
- Nama parameter:
Di blok teks Input JSON, sisipkan cuplikan kode JSON ini:
requests | summarize by name | order by name asc
Pilih Jalankan Kueri.
Pilih Simpan untuk membuat parameter.
Parameter RequestName adalah daftar dropdown dengan nama semua permintaan di aplikasi.
Mereferensikan parameter dropdown
Anda dapat mereferensikan parameter dropdown.
Dalam KQL
Pilih Tambahkan kueri untuk menambahkan kontrol kueri, lalu pilih sumber daya Application Insights.
Di editor KQL, masukkan cuplikan kode ini:
requests | where name == '{RequestName}' | summarize Requests = count() by bin(timestamp, 1h)
Cuplikan kode meluas pada waktu evaluasi kueri untuk:
requests | where name == 'GET Home/Index' | summarize Requests = count() by bin(timestamp, 1h)
Jalankan kueri untuk melihat hasilnya. Secara opsional, buat sebagai bagan.
Nilai parameter, label, pilihan, dan grup
Kueri yang digunakan dalam parameter dropdown dinamis sebelumnya mengembalikan daftar nilai yang dirender dengan benar di daftar dropdown. Namun, bagaimana jika Anda ingin nama tampilan lain atau salah satu dari nama untuk dipilih? Parameter dropdown menggunakan nilai, label, pilihan, dan kolom grup untuk fungsionalitas ini.
Contoh berikut ini menunjukkan cara mendapatkan daftar dependensi Application Insights yang nama tampilannya ditata dengan emoji, yang pertama dipilih, dan dikelompokkan menurut nama operasi:
dependencies
| summarize by operation_Name, name
| where name !contains ('.')
| order by name asc
| serialize Rank = row_number()
| project value = name, label = strcat('🌐 ', name), selected = iff(Rank == 1, true, false), group = operation_Name
Opsi parameter dropdown
Parameter | Deskripsi | Contoh |
---|---|---|
{DependencyName} |
Nilai yang dipilih | GET fabrikamaccount |
{DependencyName:label} |
Label yang dipilih | 🌐 GET fabrikamaccount |
{DependencyName:value} |
Nilai yang dipilih | GET fabrikamaccount |
Beberapa pilihan
Contoh sejauh ini secara eksplisit mengatur parameter untuk memilih hanya satu nilai di daftar dropdown. Parameter dropdown juga mendukung beberapa pilihan. Untuk mengaktifkan opsi ini, pilih kotak centang Izinkan beberapa pilihan.
Anda dapat menentukan format tataan hasil melalui Pemisah dan Kutipan dengan pengaturan. Default mengembalikan nilai sebagai koleksi dalam formulir a, b, c. Anda juga dapat membatasi jumlah pilihan.
KQL yang mereferensikan parameter perlu berubah agar berfungsi dengan format hasilnya. Cara paling umum untuk mengaktifkannya adalah melalui operator in
.
dependencies
| where name in ({DependencyName})
| summarize Requests = count() by bin(timestamp, 1h), name
Contoh ini menunjukkan parameter dropdown multipilih di tempat kerja:
Pilihan khusus dropdown
Parameter dropdown juga memungkinkan Anda menentukan nilai khusus yang juga akan muncul di menu dropdown:
- Yang mana saja
- Ketiganya
- ...
- Setiap 100
- Batas kustom apa pun
- Semua
Ketika item khusus ini dipilih, nilai parameter secara otomatis diatur ke jumlah item tertentu, atau semua nilai.
Casing Khusus Semua
Saat Anda memilih opsi Semua , bidang tambahan muncul, yang memungkinkan Anda menentukan bahwa nilai khusus akan digunakan untuk parameter jika opsi Semua dipilih. Nilai khusus ini berguna untuk kasus di mana "Semua" bisa menjadi sejumlah besar item dan dapat menghasilkan kueri yang sangat besar.
Dalam kasus spesifik ini, string []
digunakan alih-alih nilai. String ini dapat digunakan untuk menghasilkan array kosong dalam kueri log, seperti:
let selection = dynamic([{Selection}]);
SomeQuery
| where array_length(selection) == 0 or SomeField in (selection)
Jika semua item dipilih, nilainya Selection
adalah []
, menghasilkan array kosong untuk selection
variabel dalam kueri. Jika tidak ada nilai yang dipilih, nilai Selection
akan menjadi string kosong, juga menghasilkan array kosong. Jika ada nilai yang dipilih, nilai tersebut diformat di dalam bagian dinamis kueri, menyebabkan array memiliki nilai tersebut. Anda kemudian dapat menguji array_length
0 agar filter tidak diterapkan atau menggunakan in
operator untuk memfilter nilai dalam array.
Contoh umum lainnya menggunakan '*' sebagai nilai penanda khusus saat parameter diperlukan, lalu uji dengan:
| where "*" in ({Selection}) or SomeField in ({Selection})
Langkah berikutnya
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk