operator render
Menginstruksikan agen pengguna untuk merender hasil kueri dengan cara tertentu.
range x from 0.0 to 2*pi() step 0.01 | extend y=sin(x) | render linechart
Catatan
- Operator render harus menjadi operator terakhir dalam kueri, dan hanya digunakan dengan kueri yang menghasilkan satu hasil aliran data tabular.
- Operator render tidak mengubah data. Ini menginjeksi anotasi ("Visualisasi") ke dalam properti hasil yang diperluas. Anotasi berisi informasi yang diberikan oleh operator dalam kueri.
- Interpretasi informasi visualisasi dilakukan oleh agen pengguna. Agen yang berbeda (seperti Kusto.Explorer, Kusto.WebExplorer) mungkin mendukung visualisasi yang berbeda.
Sintaks
T|renderVisualization [with(PropertyName=PropertyValue [, ...] )]
Argumen
- Visualisasi menunjukkan jenis visualisasi yang akan digunakan. Nilai yang didukung adalah:
| Visualisasi | Deskripsi | Contoh |
|---|---|---|
anomalychart |
Mirip dengan bagan waktu, tetapi menyoroti anomali menggunakan fungsi series_decompose_anomalies. | Klik untuk menjalankan kueri sampel |
areachart |
Grafik area. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. | Klik untuk menjalankan kueri sampel |
barchart |
Kolom pertama adalah sumbu x dan dapat berupa teks, tanggalwaktu atau numerik. Kolom lainnya adalah numerik, ditampilkan sebagai strip horizontal. | Klik untuk menjalankan kueri sampel |
card |
Rekaman hasil pertama diperlakukan sebagai set nilai skalar dan ditampilkan sebagai kartu. | Klik untuk menjalankan kueri sampel |
columnchart |
Seperti barchart dengan strip vertikal bukan strip horizontal. |
Klik untuk menjalankan kueri sampel |
ladderchart |
Dua kolom terakhir adalah sumbu x, kolom lainnya adalah sumbu y. | |
linechart |
Grafik garis. Kolom pertama adalah sumbu x, dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. | Klik untuk menjalankan kueri sampel |
piechart |
Kolom pertama adalah sumbu warna, kolom kedua adalah numerik. | Klik untuk menjalankan kueri sampel |
pivotchart |
Menampilkan tabel pivot dan bagan. Pengguna dapat secara interaktif memilih data, kolom, baris, dan berbagai jenis bagan. | |
scatterchart |
Grafik poin. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. | Klik untuk menjalankan kueri sampel |
stackedareachart |
Grafik area bertumpuk. Kolom pertama adalah sumbu x, dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. | Klik untuk menjalankan kueri sampel |
table |
Default - hasil ditampilkan sebagai tabel. | Klik untuk menjalankan kueri sampel |
timechart |
Grafik garis. Kolom pertama adalah sumbu x, dan harus datetime. Kolom (numerik) lainnya adalah sumbu y. Ada satu kolom karakter yang nilainya digunakan untuk "grup" kolom numerik dan membuat garis yang berbeda dalam bagan (kolom karakter lebih lanjut diabaikan). | Klik untuk menjalankan kueri sampel |
timepivot |
Navigasi interaktif melalui garis waktu peristiwa (berputar pada sumbu waktu) |
Catatan
Visualisasi ladderchart, pivotchart, dan timepivot dapat digunakan di Kusto.Explorer tetapi tidak tersedia di antarmuka pengguna Web Azure Data Explorer.
| Visualisasi | Deskripsi |
|---|---|
areachart |
Grafik area. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. |
barchart |
Kolom pertama adalah sumbu x dan dapat berupa teks, tanggalwaktu atau numerik. Kolom lainnya adalah numerik, ditampilkan sebagai strip horizontal. |
columnchart |
Seperti barchart dengan strip vertikal bukan strip horizontal. |
piechart |
Kolom pertama adalah sumbu warna, kolom kedua adalah numerik. |
scatterchart |
Grafik poin. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y. |
table |
Default - hasil ditampilkan sebagai tabel. |
timechart |
Grafik garis. Kolom pertama adalah sumbu x, dan harus tanggalwaktu. Kolom (numerik) lainnya adalah sumbu y. Ada satu kolom karakter yang nilainya digunakan untuk "grup" kolom numerik dan membuat garis yang berbeda dalam bagan (kolom karakter lebih lanjut diabaikan). |
- PropertyName/PropertyValue menunjukkan informasi tambahan untuk digunakan saat merender. Semua properti bersifat opsional. Properti yang didukung adalah:
| PropertyName | PropertyValue |
|---|---|
accumulate |
Apakah nilai dari setiap ukuran akan ditambahkan ke semua pendahulunya. (true atau false) |
kind |
Elaborasi lebih lanjut dari jenis visualisasi. Lihat di bawah ini. |
legend |
Apakah akan menampilkan legenda atau tidak (visible atau hidden). |
series |
Daftar kolom yang dibatasi koma yang nilai per-rekaman gabungannya menentukan seri yang dimiliki rekaman tersebut. |
ymin |
Nilai minimum yang akan ditampilkan pada sumbu Y. |
ymax |
Nilai maksimum yang akan ditampilkan pada sumbu Y. |
title |
Judul visualisasi (tipe string). |
xaxis |
Cara menskalakan sumbu x (linear atau log). |
xcolumn |
Kolom mana dalam hasil yang digunakan untuk sumbu x. |
xtitle |
Judul sumbu x (tipe string). |
yaxis |
Cara menskalakan sumbu y (linear atau log). |
ycolumns |
Daftar kolom yang dibatasi koma yang terdiri dari nilai yang diberikan per nilai kolom x. |
ysplit |
Cara membagi beberapa visualisasi. Lihat di bawah ini. |
ytitle |
Judul sumbu y (tipe string). |
anomalycolumns |
Properti yang relevan hanya untuk anomalychart. Daftar kolom yang dibatasi koma yang akan dianggap sebagai seri anomali dan ditampilkan sebagai titik pada bagan |
| PropertyName | PropertyValue |
|---|---|
kind |
Elaborasi lebih lanjut dari jenis visualisasi. Lihat di bawah ini. |
series |
Daftar kolom yang dibatasi koma yang nilai per-rekaman gabungannya menentukan seri yang dimiliki rekaman tersebut. |
title |
Judul visualisasi (tipe string). |
yaxis |
Cara menskalakan sumbu y (linear atau log). |
Beberapa visualisasi dapat diuraikan lebih lanjut dengan menyediakan kind properti.
Persyaratannya adalah:
| Visualisasi | kind |
Deskripsi |
|---|---|---|
areachart |
default |
Setiap "area" berdiri sendiri. |
unstacked |
Sama seperti default. |
|
stacked |
Tumpuk "area" di sebelah kanan. | |
stacked100 |
Tumpuk "area" ke kanan dan rentangkan masing-masing ke lebar yang sama dengan yang lain. | |
barchart |
default |
Setiap "bar" berdiri sendiri. |
unstacked |
Sama seperti default. |
|
stacked |
Tumpuk "bar". | |
stacked100 |
Tumpuk "bar" dan rentangkan masing-masing ke lebar yang sama dengan yang lain. | |
columnchart |
default |
Setiap "kolom" berdiri sendiri. |
unstacked |
Sama seperti default. |
|
stacked |
Tumpuk "kolom" satu di atas yang lain. | |
stacked100 |
Tumpuk "kolom" dan rentangkan masing-masing ke ketinggian yang sama dengan yang lain. | |
scatterchart |
map |
Kolom yang diharapkan adalah [Garis bujur, Garis lintang] atau titik GeoJSON. Kolom seri bersifat opsional. |
piechart |
map |
Kolom yang diharapkan adalah [Garis bujur, Garis lintang] atau titik GeoJSON, sumbu warna dan numerik. Didukung di desktop Kusto Explorer. |
Beberapa visualisasi mendukung pemisahan menjadi beberapa nilai sumbu y:
ysplit |
Deskripsi |
|---|---|
none |
Sumbu y tunggal ditampilkan untuk semua data seri. (Default) |
axes |
Bagan tunggal ditampilkan dengan beberapa sumbu y (satu per seri). |
panels |
Satu bagan dirender untuk setiap ycolumn nilai (hingga batas tertentu). |
Catatan
Model data operator render melihat data tabular seolah-olah memiliki tiga jenis kolom:
- Kolom sumbu x (ditunjukkan oleh
xcolumnproperti). - Kolom seri (sejumlah kolom yang ditunjukkan oleh
seriesproperti.) Untuk setiap rekaman, nilai gabungan dari kolom ini mendefinisikan satu tunggal, dan bagan memiliki seri sebanyak ada nilai gabungan yang berbeda. - Kolom sumbu y (sejumlah kolom yang ditunjukkan oleh
ycolumnsproperti). Untuk setiap rekaman, seri ini memiliki banyak pengukuran ("titik" dalam bagan) karena ada kolom sumbu y.
Tip
- Gunakan
where,summarizedantopuntuk membatasi volume yang Anda tampilkan. - Urutkan data untuk menentukan urutan sumbu x.
- Agen pengguna bebas untuk "menebak" nilai properti yang tidak ditentukan oleh kueri. Secara khusus, memiliki kolom "tidak menarik" dalam skema hasil mungkin diterjemahkan ke dalamnya salah menebak. Coba proyeksikan kolom seperti itu ketika itu terjadi.
Contoh
range x from -2 to 2 step 0.1
| extend sin = sin(x), cos = cos(x)
| extend x_sign = iif(x > 0, "x_pos", "x_neg")
| extend sum_sign = iif(sin + cos > 0, "sum_pos", "sum_neg")
| render linechart with (ycolumns = sin, cos, series = x_sign, sum_sign)
Catatan
Model data operator render melihat data tabular seolah-olah memiliki tiga jenis kolom:
- Kolom sumbu x (ditunjukkan oleh
xcolumnproperti). - Kolom seri (sejumlah kolom yang ditunjukkan oleh
seriesproperti.) - Kolom sumbu y (sejumlah kolom yang ditunjukkan oleh
ycolumnsproperti). Untuk setiap rekaman, seri ini memiliki banyak pengukuran ("titik" dalam bagan) karena ada kolom sumbu y.
Tip
- Gunakan
where,summarizedantopuntuk membatasi volume yang Anda tampilkan. - Urutkan data untuk menentukan urutan sumbu x.
- Agen pengguna bebas untuk "menebak" nilai properti yang tidak ditentukan oleh kueri. Secara khusus, memiliki kolom "tidak menarik" dalam skema hasil mungkin diterjemahkan ke dalamnya salah menebak. Coba proyeksikan kolom seperti itu ketika itu terjadi.
Contoh
InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart