Ringkasan API Analitik Log Azure Monitor
API Kueri Analitik Log adalah REST API yang dapat Anda gunakan untuk mengkueri kumpulan data lengkap yang dikumpulkan oleh log Azure Monitor. Anda dapat menggunakan bahasa kueri yang sama yang digunakan di seluruh layanan. Gunakan API ini untuk mengambil data, membangun visualisasi baru data Anda, dan memperluas kemampuan Analitik Log.
Autentikasi API Analitik Log
Anda harus mengautentikasi untuk mengakses API Analitik Log:
- Untuk mengkueri ruang kerja, Anda harus menggunakan autentikasi Microsoft Entra.
- Untuk menjelajahi API dengan cepat tanpa menggunakan autentikasi Microsoft Entra, Anda dapat menggunakan kunci API untuk mengkueri data sampel di lingkungan non-produksi.
Autentikasi Microsoft Entra untuk data ruang kerja
API Analitik Log mendukung autentikasi Microsoft Entra dengan tiga alur Microsoft Entra ID OAuth2 yang berbeda:
- Kode otorisasi
- Implisit
- Informasi masuk klien
Alur kode otorisasi dan alur implisit memerlukan setidaknya satu pengguna masuk interaktif ke aplikasi Anda. Jika Anda memerlukan alur non-interaktif, gunakan alur kredensial klien.
Setelah Anda menerima token, proses untuk memanggil API Analitik Log sama untuk semua alur. Permintaan memerlukan Authorization: Bearer header, diisi dengan token yang diterima dari aliran OAuth2.
Autentikasi kunci API untuk data sampel
Untuk menjelajahi API dengan cepat tanpa menggunakan autentikasi Microsoft Entra, kami menyediakan ruang kerja demonstrasi dengan data sampel. Anda dapat mengautentikasi dengan menggunakan kunci API.
Catatan
Saat Anda menggunakan autentikasi Microsoft Entra, mungkin perlu waktu hingga 60 menit agar REST API Application Insights mengenali izin kontrol akses berbasis peran baru. Saat izin menyebar, panggilan REST API mungkin gagal dengan kode kesalahan 403.
Batas kueri API Analitik Log
Untuk informasi tentang batas kueri, lihat bagian API Kueri dari halaman web ini.
Coba API Analitik Log
Untuk mencoba API tanpa menulis kode apa pun, Anda dapat menggunakan:
- Klien favorit Anda seperti Fiddler atau Postman untuk menghasilkan kueri secara manual dengan antarmuka pengguna.
- cURL dari baris perintah. Kemudian pipa output ke jsonlint untuk mendapatkan JSON yang dapat dibaca.
Alih-alih memanggil REST API secara langsung, Anda dapat menggunakan pustaka klien Kueri Azure Monitor idiomatik:
Setiap pustaka klien adalah pembalut di sekitar REST API yang memungkinkan Anda mengambil data log dari ruang kerja.