Papan kendali pemantauan dan pencatatan GraphQL (pratinjau)
Nota
Fitur Dasbor Pemantauan dan Pengelogan untuk Fabric API untuk GraphQL berada dalam pratinjau .
Setelah menyebarkan API untuk GraphQL di Fabric, Anda mungkin ingin memahami bagaimana API digunakan oleh klien dan memecahkan masalah kesalahan jika ada masalah dengan API. Gunakan dasbor pemantauan Fabric GraphQL untuk memvisualisasikan, memantau, dan memecahkan masalah aktivitas permintaan API GraphQL Anda. Fitur ini saat ini dalam pratinjau. Artikel ini menjelaskan cara mengaktifkan pemantauan dan menggunakan komponen dasbor secara efektif.
Prasyarat
- Mengaktifkan pemantauan ruang kerja. Untuk informasi selengkapnya, lihatGambaran Umum Pemantauan Ruang Kerjadan ikuti langkah-langkah untuk mengaktifkan pemantauan ruang kerja.
- Sebelum mulai menggunakan kemampuan pemantauan dan pengelogan, Anda harus memiliki API untuk GraphQL di Fabric. Untuk informasi selengkapnya, lihat Membuat API untuk GraphQL di Fabric dan menambahkan data.
Nota
Mengaktifkan pemantauan GraphQL API
Di bagian ini, kami memanding Anda melalui langkah-langkah yang diperlukan untuk mengaktifkan pemantauan untuk API Anda untuk GraphQL. Secara default, fitur ini dinonaktifkan.
Untuk mengaktifkan metrik dan/atau pengalaman pengelogan untuk setiap API GraphQL di tenant Anda, buka GraphQL API Anda lalu pilih ikon Pengaturan:
Dari jendela pengaturan API, pilih opsi Pemantauan (pratinjau) dari menu sebelah kiri. Jika pemantauan ruang kerja belum diaktifkan, Anda akan melihat catatan yang memandu Anda untuk masuk ke pengaturan ruang kerja untuk mengaktifkannya.
Setelah Anda mengaktifkan pemantauan untuk ruang kerja, Anda akan melihat opsi untuk mengaktifkan Metrik saja (dasbor API), Pencatatan saja (permintaan API), atau keduanya. Metrik dan log disimpan ke tabel terpisah di Kusto, dan Anda dapat mengaktifkan setiap fitur secara terpisah tergantung pada persyaratan Anda. Secara default, kedua opsi dinonaktifkan:
Nota
Metrik dan data pengelogan dikirim secara terpisah ke database Kusto yang terkait dengan ruang kerja dan dikenakan biaya tambahan. Untuk informasi lebih lanjut tentang biaya dan penggunaan konsumsi, lihat pengumuman Pemantauan Ruang Kerja .
Aktivitas permintaan API
Setelah pemantauan diaktifkan, opsi aktivitas permintaan API di pita atas dari API GraphQL menjadi aktif. Pilih untuk mengakses detail pemantauan.
Aktivitas permintaan API terdiri dari dua tampilan utama:
- dasbor API (untuk metrik): Halaman ini menampilkan semua indikator dan grafik untuk rentang waktu yang ditentukan.
- permintaan API (untuk Pengelogan): Halaman ini mencantumkan permintaan API dalam rentang waktu yang ditentukan.
Di bagian berikut, kami menjelaskan fungsionalitas setiap opsi.
Metrik (dasbor API)
Dasbor API menyediakan gambaran umum aktivitas API untuk Anda dengan berbagai metrik dan visual. Untuk mengakses, dari halaman aktivitas permintaan API, pilih tab dasbor API. Anda sekarang dapat melihat sekilas parameter berikut untuk rentang waktu tertentu:
Secara keseluruhan indeks GraphQL API Health yang mencakup:
- Permintaan API per detik
- Tingkat keberhasilan
- Status Kesehatan
Jumlah permintaan API
Latensi
Jumlah permintaan dalam bagan batang yang mengilustrasikan jumlah keberhasilan dan kesalahan
Dengan menggerakkan mouse ke grafik, Anda dapat melihat informasi terperinci untuk titik data tertentu dalam tooltip.
Fitur Utama Metrik:
Pilihan Rentang Waktu: Anda dapat memilih rentang waktu yang berbeda untuk data yang ditampilkan dalam grafik pemantauan. Perhatikan bahwa karena batas pemantauan ruang kerja, retensi data hanya tersedia selama 30 hari.
Permintaan API/detik: Anda dapat melihat jumlah permintaan API yang dibuat setiap detik dalam rentang waktu yang dipilih.
Tingkat keberhasilan: Anda dapat melihat tingkat keberhasilan yang merupakan jumlah permintaan yang berhasil atas jumlah total permintaan dalam rentang waktu yang dipilih.
Secara keseluruhan indeks GraphQL API Health berdasarkan tingkat keberhasilan per API:
Hijau: 75-100% dari permintaan berhasil (Sehat)
Kuning: 50 - 74% permintaan berhasil (Perlu Perhatian)
Merah: Permintaan sukses di bawah 50% (Tidak Sehat)
Jumlah Total permintaan API: Anda dapat melihat jumlah total permintaan API dalam rentang waktu yang dipilih.
latensi bagan garis: Dengan mengarahkan mouse ke atas grafik, Anda akan dapat melihat latensi dan tanggal untuk setiap titik data.
Jumlah permintaan bagan batang, membedakan antara permintaan keberhasilan dan kesalahan: Dengan mengarahkan mouse ke atas grafik, Anda akan dapat melihat tanggal dan jumlah keberhasilan dan kesalahan untuk setiap titik data.
Ketika Anda melihat perilaku abnormal di dasbor yang memerlukan perhatian Anda, Anda dapat menyelidiki lebih lanjut dengan melihat log untuk mengidentifikasi potensi masalah dan mencari tahu permintaan mana yang gagal dan memiliki latensi yang lebih tinggi dan mulai mencari detail log untuk memecahkan masalah. Untuk mengakses detail pencatatan, pilih tab permintaan API dari halaman aktivitas permintaan API.
Pengelogan (permintaan API)
Halaman permintaan API menyediakan informasi terperinci tentang semua permintaan API yang terjadi dalam jangka waktu tertentu. Untuk mengakses, pilih tab permintaan API dari halaman aktivitas permintaan API .
Fitur Utama Pengelogan :
- Pilihan Rentang Waktu: Anda dapat memilih rentang waktu yang berbeda untuk data yang ditampilkan dalam daftar permintaan (Jam/Hari/Minggu/Bulan). Perhatikan bahwa ada batas retensi 30 hari.
- Lihat daftar permintaan API terbaru dan permintaan sebelumnya yang tercantum dengan ID Permintaan.
- Menampilkan jenis operasi (Kueri atau Mutasi).
- Lihat protokol transportasi yang digunakan oleh permintaan (HTTP).
- Lihat waktu permintaan.
- Urutkan daftar permintaan menurut waktu naik/turun.
- Lihat durasi permintaan.
- Urutkan daftar permintaan dengan durasi naik/turun.
- Lihat ukuran respons.
- Lihat Status (Berhasil atau Gagal).
- Lihat detail permintaan, termasuk pesan respons/peringatan/kesalahan tertentu.
- Memfilter dan mencari string atau kalimat tertentu.
- Mengubah ukuran kolom dan mengurutkan kolom (naik/turun) dari tabel laporan.