Memvisualisasikan data dari Azure Data Explorer di Grafana

Grafana adalah platform analitik tempat Anda dapat mengkueri dan memvisualisasikan data, lalu membuat dan berbagi dasbor berdasarkan visualisasi Anda. Grafana menyediakan plug-in Azure Data Explorer, yang memungkinkan Anda menyambungkan dan memvisualisasikan data dari Azure Data Explorer. Plug-in berfungsi dengan Azure Managed Grafana dan Grafana yang dihost sendiri.

Dalam artikel ini, Anda mempelajari cara mengonfigurasi kluster Anda sebagai sumber data untuk Grafana dan memvisualisasikan data di Grafana untuk Azure Managed Grafana dan Grafana yang dihost sendiri. Untuk mengikuti contoh dalam artikel ini, serap data sampel StormEvents. Himpunan data sampel StormEvents berisi data terkait cuaca dari Pusat Nasional untuk Informasi Lingkungan.

Prasyarat

• Untuk Azure Managed Grafana, akun Azure dan instans Azure Managed Grafana .
• Untuk Grafana yang dihost sendiri, Grafana versi 5.3.0 atau yang lebih baru untuk sistem operasi Anda dan plug-in Azure Data Explorer untuk Grafana. Anda memerlukan plug-in versi 3.0.5 atau yang lebih baru untuk menggunakan penyusun kueri Grafana.
• Kluster dan database Azure Data Explorer. Anda dapat membuat kluster gratis atau membuat kluster lengkap. Untuk memutuskan mana yang terbaik untuk Anda, periksa perbandingan fitur.

Konfigurasikan sumber data

Untuk mengonfigurasi Azure Data Explorer sebagai sumber data, ikuti langkah-langkah untuk lingkungan Grafana Anda.

Azure Managed Grafana

Menambahkan identitas terkelola ke peran Penampil

Grafana Terkelola membuat identitas terkelola yang ditetapkan sistem untuk setiap ruang kerja baru, secara default. Anda dapat menggunakannya untuk mengakses kluster Azure Data Explorer Anda.

1. Di portal Azure, buka kluster Azure Data Explorer Anda.

2. Di bagian Gambaran Umum , pilih database yang memiliki data sampel StormEvents .

   

3. Pilih Izin>Tambahkan>Penampil.

   

4. Dalam kotak pencarian, masukkan nama ruang kerja Grafana Terkelola Anda.

5. Di hasil pencarian, pilih hasil yang cocok dengan nama ruang kerja Anda, lalu pilih Pilih.

   

Menyiapkan Azure Data Explorer sebagai sumber data Grafana

Ruang kerja Grafana terkelola dilengkapi dengan plug-in Azure Data Explorer yang telah diinstal sebelumnya.

1. Di portal Azure, buka ruang kerja Grafana Terkelola Anda.

2. Di bawah Gambaran Umum, pilih tautan Titik Akhir untuk membuka UI Grafana.

3. Di Grafana, di menu sebelah kiri, pilih ikon gigi. Lalu pilih Sumber Data.

   

4. Pilih Azure Data Explorer Datasource.

   

5. Di Detail Koneksi, masukkan URL kluster Azure Data Explorer Anda.

   

6. Pilih Simpan & Uji.

Grafana yang dihost sendiri

Buat perwakilan layanan

Anda dapat membuat perwakilan layanan di portal Azure atau dengan menggunakan pengalaman baris perintah Azure CLI. Setelah membuat perwakilan layanan, Anda mendapatkan nilai untuk empat properti koneksi yang akan Anda gunakan di langkah-langkah selanjutnya.

portal Microsoft Azure

1. Ikuti instruksi dalam dokumentasi portal Azure. Gunakan informasi spesifik ini:

   1. Di bagian Tetapkan aplikasi ke peran, tetapkan jenis peran Pembaca ke kluster Azure Data Explorer Anda.

   2. Di bagian Dapatkan nilai untuk masuk , salin nilai untuk tiga properti yang tercakup dalam langkah-langkah: ID Direktori (ID penyewa), ID Aplikasi, dan Kata Sandi.

2. Di portal Microsoft Azure, pilih Langganan. Kemudian salin ID untuk langganan tempat Anda membuat perwakilan layanan.

   

Azure CLI

1. Gunakan perintah berikut untuk membuat perwakilan layanan. Atur cakupan yang sesuai dan jenis readerperan .

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Untuk informasi selengkapnya, lihat Membuat perwakilan layanan Azure dengan Azure CLI.

2. Perintah mengembalikan tataan hasil seperti contoh berikut. Salin nilai untuk appIdproperti , password, dan tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Dapatkan daftar langganan Anda:

   az account list --output table
   

   Salin ID langganan yang sesuai.

   

Menambahkan perwakilan layanan ke peran Penampil

Sekarang setelah Anda memiliki perwakilan layanan, Anda menambahkannya ke peran Penampil di database Azure Data Explorer. Anda bisa melakukan tugas ini di bawah Izin di portal Azure, atau di bawah Kueri dengan menggunakan perintah manajemen.

portal Azure: Izin

1. Di portal Azure, buka kluster Azure Data Explorer Anda.

2. Di bagian Gambaran Umum , pilih database yang memiliki data sampel StormEvents.

   

3. Pilih Izin>Tambahkan.

   

4. Di bawah Tambahkan Izin Database, pilih peran Penampil , lalu pilih Pilih prinsipal.

   

5. Cari perwakilan layanan yang Anda buat. Pilih prinsipal, lalu pilih Pilih.

   

6. Pilih Simpan.

   

Perintah manajemen: Kueri

1. Di portal Azure, buka kluster Azure Data Explorer Anda, lalu pilih Kueri.

   

2. Jalankan perintah berikut ini di jendela kueri. Gunakan ID aplikasi dan ID penyewa dari portal Azure atau Azure CLI.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   Perintah mengembalikan tataan hasil. Dalam contoh berikut, baris pertama adalah untuk pengguna yang sudah ada dalam database. Baris kedua adalah untuk perwakilan layanan yang baru saja Anda tambahkan.

   

Tentukan properti dan uji koneksi

Dengan perwakilan layanan yang ditetapkan ke peran Penampil, Anda sekarang menentukan properti dalam instans Grafana Anda dan menguji koneksi ke Azure Data Explorer.

1. Di Grafana, di menu sebelah kiri, pilih ikon gigi. Lalu pilih Sumber Data.

   

2. Pilih Tambahkan sumber data.

3. Pada halaman Sumber Data/Baru, masukkan nama untuk sumber data, lalu pilih jenis Azure Data Explorer Datasource.

   

4. Di Pengaturan>Detail koneksi, masukkan nama kluster Anda dalam formulir https://{ClusterName}.{Region}.kusto.windows.net. Masukkan nilai lain dari portal Azure atau Azure CLI. Gunakan informasi pemetaan berikut sebagai panduan.

   Grafana UI	portal Microsoft Azure	Azure CLI
   Id Langganan	ID LANGGANAN	SubscriptionId
   Id Penyewa	ID Direktori	tenant
   ID Klien	ID aplikasi	appId
   Rahasia klien	Kata sandi	password

   

5. Pilih Simpan & Uji.

   Jika pengujian berhasil, buka bagian berikutnya. Jika Anda memiliki masalah, periksa nilai yang Anda tentukan di Grafana dan tinjau langkah-langkah sebelumnya.

Optimalkan kueri

Anda bisa menggunakan dua fitur untuk pengoptimalan kueri:

• Mengoptimalkan performa penyajian kueri dasbor
• Aktifkan konsistensi yang lemah

Untuk melakukan pengoptimalan, diPengaturan>Sumber> DataPengoptimalan Kueri, buat perubahan yang diperlukan.

Mengoptimalkan performa penyajian kueri dasbor

Saat dasbor atau visual dirender lebih dari sekali oleh satu atau beberapa pengguna, Grafana mengirimkan setidaknya satu kueri ke Azure Data Explorer secara default. Aktifkan penembolokan hasil Kueri untuk meningkatkan performa penyajian dasbor dan untuk mengurangi beban pada kluster Azure Data Explorer.

Selama rentang waktu yang ditentukan, Azure Data Explorer akan menggunakan cache hasil untuk mengambil hasil sebelumnya dan tidak akan menjalankan kueri yang tidak perlu. Kemampuan ini sangat efektif dalam mengurangi beban pada sumber daya dan meningkatkan performa ketika beberapa pengguna menggunakan dasbor yang sama.

Untuk mengaktifkan penyajian cache hasil, lakukan hal berikut ini di panel Pengoptimalan Kueri :

1. Nonaktifkan Gunakan penembolokan dinamis.
2. Di Cache Max Age, masukkan jumlah menit di mana Anda ingin menggunakan hasil cache.

Aktifkan konsistensi yang lemah

Kluster dikonfigurasi dengan konsistensi yang kuat. Konfigurasi default ini menjamin bahwa hasil kueri sudah diperbarui dengan semua perubahan dalam kluster.

Saat Anda mengaktifkan konsistensi yang lemah, hasil kueri dapat memiliki jeda 1 hingga 2 menit setelah perubahan kluster. Namun, konsistensi yang lemah dapat meningkatkan waktu penyajian visual. Jika konsistensi langsung tidak penting dan performa marginal, aktifkan konsistensi yang lemah untuk meningkatkan performa. Untuk informasi selengkapnya, lihat Konsistensi kueri.

Untuk mengaktifkan konsistensi yang lemah, pada panel Pengoptimalan Kueri , pilih Konsistensi data>Lemah.

Memvisualisasikan data

Anda selesai mengonfigurasi Azure Data Explorer sebagai sumber data untuk Grafana. Sekarang saatnya untuk memvisualisasikan data.

Contoh dasar berikut menggunakan mode penyusun kueri dan mode mentah editor kueri. Kami menyarankan agar Anda melihat kueri tulis untuk Azure Data Explorer contoh kueri lain untuk dijalankan terhadap himpunan data.

1. Di Grafana, di menu sebelah kiri, pilih ikon plus. Lalu pilih Dasbor.

   

2. Di bawah tab Tambahkan , pilih Grafik.

   

3. Pada panel grafik, pilihEditJudul> Panel.

   

4. Di bagian bawah panel, pilih Sumber Data, lalu pilih sumber data yang Anda konfigurasi.

   

Mode penyusun kueri

Gunakan mode penyusun kueri untuk menentukan kueri Anda.

1. Di bawah sumber data, pilih Database dan pilih database Anda dari daftar dropdown.

2. Pilih Dari dan pilih tabel Anda dari daftar dropdown.

   

3. Sekarang setelah tabel ditentukan, filter data:

   1. Pilih + di sebelah kanan Di mana (filter) untuk memilih satu atau beberapa kolom di tabel Anda.
   2. Untuk setiap filter, tentukan nilai dengan menggunakan operator yang berlaku. Pilihan ini mirip dengan menggunakan operator di mana dalam Bahasa Kueri Kusto.

4. Pilih nilai yang akan disajikan dalam tabel:

   1. Pilih + di sebelah kanan kolom Nilai untuk memilih kolom nilai yang akan muncul di panel.

   2. Untuk setiap kolom nilai, atur jenis agregasi.

      Anda dapat mengatur satu atau beberapa kolom nilai. Pilihan ini setara dengan menggunakan operator ringkasan.

5. Pilih + di sebelah kanan Kelompokkan menurut (ringkas) untuk memilih satu atau beberapa kolom yang akan digunakan untuk menyusun nilai ke dalam grup. Pilihan ini setara dengan ekspresi grup di summarize operator.

6. Pilih Jalankan Kueri.

   

   Tip

   Saat Anda menyelesaikan pengaturan di penyusun kueri, kueri Bahasa Kueri Kusto dibuat. Kueri ini memperlihatkan logika yang Anda buat dengan menggunakan editor kueri grafis.

7. Pilih Edit KQL untuk berpindah ke mode mentah. Edit kueri Anda dengan menggunakan fleksibilitas dan kekuatan Bahasa Kueri Kusto.

Mode mentah

Gunakan mode mentah untuk mengedit kueri Anda.

1. Pada panel kueri, tempelkan kueri berikut, lalu pilih Jalankan. Kueri membuat wadah jumlah peristiwa menurut hari untuk himpunan data sampel.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. Grafik tidak menampilkan hasil apa pun karena terlingkup (secara default) ke data dari enam jam terakhir. Di menu atas, pilih 6 jam terakhir.

   

3. Tentukan rentang kustom yang mencakup 2007, tahun yang disertakan dalam himpunan data sampel StormEvents. Lalu, pilih Terapkan.

   

   Sekarang grafik menunjukkan data dari 2007, di-bucket berdasarkan hari.

   

4. Di menu atas, pilih ikon simpan: .

Untuk beralih ke mode penyusun kueri, pilih Beralih ke penyusun. Grafana akan mengonversi kueri ke logika yang tersedia di penyusun kueri. Logika penyusun kueri terbatas, sehingga Anda mungkin kehilangan perubahan manual yang Anda buat pada kueri.

Membuat peringatan

1. Di Dasbor Beranda, pilihSaluran PemberitahuanPemberitahuan> untuk membuat saluran pemberitahuan baru.

   

2. Masukkan nama dan ketik di bawah Saluran Pemberitahuan Baru, lalu pilih Simpan.

   

3. Di dasbor, pilih Edit dari daftar dropdown.

   

4. Pilih ikon bel pemberitahuan untuk membuka panel Pemberitahuan . Pilih Buat Pemberitahuan, lalu selesaikan properti untuk pemberitahuan tersebut.

   

5. Pilih ikon Simpan dasbor untuk menyimpan perubahan Anda.

Konten terkait

• Menulis kueri untuk Azure Data Explorer