Mengonfigurasi sumber data Azure Data Explorer

Azure Data Explorer adalah layanan eksplorasi data log & telemetri. Dalam panduan ini, Anda mempelajari cara menambahkan sumber data Azure Data Explorer ke Grafana dan Anda mempelajari cara mengonfigurasi Azure Data Explorer menggunakan setiap opsi autentikasi yang tersedia untuk sumber data ini.

Prasyarat

• Ruang kerja Azure Managed Grafana dalam paket Standar.
• Database Azure Data Explorer

Menambahkan sumber data Azure Data Explorer

Tambahkan sumber data Azure Data Explorer ke Grafana dengan mengikuti langkah-langkah di bawah ini.

1. Buka ruang kerja Azure Managed Grafana di portal Azure.
2. Di bagian Gambaran Umum , buka URL Titik Akhir.
3. Di portal Grafana, buka data baru, lalu cari dan pilih > Azure Data Explorer.

Mengonfigurasi sumber data Azure Data Explorer

Masukkan pengaturan konfigurasi Azure Data Explorer.

1. Di tab Pengaturan, secara opsional edit Nama sumber data.

   

2. Di bawah Detail Koneksi, masukkan URL Kluster database Azure Data Explorer.

3. Pilih opsi autentikasi pilihan Anda antara Identitas Terkelola, Pendaftaran Aplikasi (perwakilan layanan) atau Pengguna Saat Ini (autentikasi berbasis pengguna).

   Identitas terkelola

   Autentikasi dengan identitas terkelola tanpa menggunakan kredensial eksplisit.

   Menambahkan izin baru

   1. Di portal Azure, buka kluster Azure Data Explorer Anda.
   2. Pilih Database Data>dari menu sebelah kiri, lalu pilih database yang berisi data Anda.
   3. Pilih Izin > Tambahkan > Penampil.
   4. Dalam kotak pencarian, masukkan nama ruang kerja Azure Managed Grafana Anda, pilih ruang kerja lalu pilih Pilih. Pemberitahuan keberhasilan muncul.

   Mengonfigurasi sumber data di Grafana

   1. Kembali ke Grafana, di bawah Metode Autentikasi, pilih Identitas Terkelola.
   2. Pilih Simpan & uji. Pemberitahuan "Berhasil" yang ditampilkan menunjukkan bahwa Grafana dapat mengambil data dari database.

   Pendaftaran aplikasi

   Autentikasi dengan pendaftaran aplikasi menggunakan perwakilan layanan Microsoft Entra.

   Penyetelan awal

   1. Ikuti langkah-langkah dalam Mendaftarkan aplikasi dengan ID Microsoft Entra dan membuat perwakilan layanan.
   2. Tetapkan peran Pembaca ke aplikasi di langkah panduan berikutnya.
   3. Ambil detail aplikasi yang diperlukan pada langkah berikutnya untuk mengonfigurasi sumber data di Grafana:

      1. Temukan ID direktori (penyewa) Anda:

         1. Di portal Microsoft Azure, masukkan ID Microsoft Entra di Cari sumber daya, layanan, dan dokumen (G+ /).
         2. Pilih Microsoft Entra ID.
         3. Pilih Properti dari menu sebelah kiri.
         4. Temukan ID Penyewa bidang dan simpan nilainya.

      2. Temukan ID klien Anda:

         1. Di portal Microsoft Azure, di ID Microsoft Entra, pilih Pendaftaran aplikasi dari menu sebelah kiri.
         2. Pilih aplikasi Anda.
         3. Di Gambaran Umum, temukan bidang ID Aplikasi (klien) dan simpan nilainya.

      3. Buat rahasia aplikasi:

         1. Di portal Microsoft Azure, di ID Microsoft Entra, pilih Pendaftaran aplikasi dari menu sebelah kiri.
         2. Pilih aplikasi Anda.
         3. Pilih Sertifikat & rahasia dari menu sebelah kiri.
         4. Pilih Rahasia klien baru.
         5. Buat rahasia klien baru dan simpan nilainya.

   Mengonfigurasi sumber data di Grafana

   1. Di Grafana, di bawah Metode Autentikasi, pilih Pendaftaran Aplikasi.

   2. Untuk Azure Cloud, pilih Azure Cloud Anda. Misalnya, Azure.

      

   3. Masukkan ID Direktori (penyewa), ID Aplikasi (klien) dan Rahasia Klien

   4. Secara opsional juga edit bagian Pengoptimalan Kueri, Pengaturan skema database, dan Pelacakan .

   5. Pilih Simpan & uji untuk memvalidasi koneksi. Pemberitahuan "Berhasil" yang ditampilkan menunjukkan bahwa Grafana dapat tersambung ke database.

   Pengguna saat ini

   Gunakan metode autentikasi berbasis pengguna, memanfaatkan kredensial ID Microsoft Entra pengguna Grafana saat ini di sumber data yang dikonfigurasi.

   Saat Anda mengonfigurasi sumber data Azure Data Explorer dengan metode autentikasi Pengguna Saat Ini, Grafana meminta Azure Data Explorer menggunakan kredensial pengguna.

   Perhatian

   Autentikasi berbasis pengguna di sumber data Grafana bersifat eksperimental.

   Perhatian

   Fitur ini tidak kompatibel dengan kasus penggunaan yang memerlukan akses mesin yang selalu aktif ke data yang dikueri, termasuk Pemberitahuan, Pelaporan, Penembolokan kueri, dan dasbor Publik. Metode autentikasi Pengguna Saat Ini bergantung pada pengguna yang sedang masuk, dalam sesi interaktif, agar Grafana mencapai database. Saat autentikasi berbasis pengguna digunakan dan tidak ada pengguna yang masuk, tugas otomatis tidak dapat berjalan di latar belakang. Untuk memanfaatkan tugas otomatis untuk Azure Data Explorer, sebaiknya siapkan sumber data Azure Data Explorer lain menggunakan metode autentikasi lain.

   Menambahkan izin baru

   Tambahkan izin baru untuk akun pengguna Anda untuk mengakses database.

   1. Di portal Azure, buka sumber daya Database Azure Data Explorer, dan pilih Izin>>

   2. Masukkan nama atau alamat email Anda di bilah pencarian, pilih akun pengguna Anda dan pilih Pilih.

      

   3. Pemberitahuan mengonfirmasi bahwa izin telah ditambahkan ke database.

   Mengonfigurasi sumber data di Grafana

   1. Di Grafana, di bawah Metode Autentikasi, pilih Pengguna Saat Ini.
   2. Pilih Simpan & uji. Pemberitahuan "Berhasil" yang ditampilkan menunjukkan bahwa Grafana dapat mengambil data dari database.

Membuat sumber data Azure Data Explorer

Di Azure CLI, tambahkan dan konfigurasikan sumber data Azure Data Explorer, dengan menjalankan perintah az grafana data-source create . Pilih metode autentikasi pilihan Anda dan lihat tab terkait di bawah ini untuk detailnya.

Saat menjalankan perintah ini, ganti semua tempat penampung dengan informasi Anda sendiri.

Identitas terkelola

Autentikasi dengan identitas terkelola tanpa menggunakan kredensial eksplisit.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Pendaftaran aplikasi

Autentikasi dengan pendaftaran aplikasi menggunakan perwakilan layanan Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Pengguna saat ini

Autentikasi dengan metode pengguna saat ini. Metode ini memanfaatkan kredensial ID Microsoft Entra pengguna Grafana saat ini di sumber data yang dikonfigurasi.

Saat Anda mengonfigurasi sumber data Azure Data Explorer dengan metode autentikasi Pengguna Saat Ini, Grafana meminta Azure Data Explorer menggunakan kredensial pengguna.

Perhatian

Autentikasi berbasis pengguna di sumber data Grafana bersifat eksperimental.

Perhatian

Fitur ini tidak kompatibel dengan kasus penggunaan yang memerlukan akses mesin yang selalu aktif ke data yang dikueri, termasuk Pemberitahuan, Pelaporan, Penembolokan kueri, dan dasbor Publik. Metode autentikasi Pengguna Saat Ini bergantung pada pengguna yang sedang masuk, dalam sesi interaktif, agar Grafana mencapai database. Saat autentikasi berbasis pengguna digunakan dan tidak ada pengguna yang masuk, tugas otomatis tidak dapat berjalan di latar belakang. Untuk memanfaatkan tugas otomatis untuk Azure Data Explorer, sebaiknya siapkan sumber data Azure Data Explorer lain menggunakan metode autentikasi lain.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Memperbarui sumber data Azure Data Explorer

Untuk memperbarui sumber data Azure Data Explorer, ikuti langkah-langkah di bawah ini. Saat menjalankan perintah ini, ganti semua tempat penampung dengan informasi Anda sendiri.

1. Dapatkan ID sumber data Azure Data Explorer untuk diperbarui dengan daftar sumber data az grafana.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Jalankan perintah az grafana data-source update untuk memperbarui sumber data.

   Misalnya, perbarui nama dan URL kluster sumber data Azure Data Explorer dengan perintah berikut.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Langkah selanjutnya

Membuat dasbor