Memantau traffic API terbaru

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Dasbor Terbaru memungkinkan Anda memantau traffic API terbaru untuk semua proxy API dan layanan yang ditargetkan di organisasi Anda selama satu jam terakhir. Data pemantauan API dapat ditampilkan sebagai daftar detail atau heat map. Jelajahi setiap tampilan di bagian berikut:

• Menggunakan tampilan Daftar
• Menggunakan Peta Panas

Menggunakan tampilan Daftar

Tampilan Daftar menampilkan informasi ringkasan untuk proxy dan layanan target API di organisasi Anda yang baru-baru ini memiliki traffic.

Menjelajahi tampilan daftar

Untuk menampilkan tampilan Daftar, pilih Analyze > API Monitoring > Recent di Edge UI.

Tampilan Daftar ditampilkan secara default. Kembali ke tampilan Daftar kapan saja dengan mengklik di Dasbor terbaru.

Seperti yang disorot dalam gambar, tampilan Daftar memungkinkan Anda untuk:

• Lihat informasi ringkasan untuk semua proxy dan layanan target API di organisasi Anda yang memiliki transaksi dalam satu jam terakhir. Proxy API dan layanan target dicantumkan berdasarkan region dan lingkungan. (Untuk pandangan historis yang lebih luas, lihat Mengidentifikasi tren dalam data pemantauan API Anda.)
• Mengidentifikasi proxy dan layanan target API yang memiliki pemberitahuan dengan cepat. (Lihat Menyiapkan pemberitahuan dan notifikasi untuk informasi tentang penyiapan pemberitahuan.)
• Klik nama proxy atau layanan target API dalam daftar untuk melihat data mendetail di panel kanan.

• Dengan menggunakan konteks saat ini, lakukan tugas berikut dengan cepat (opsi berwarna abu-abu jika tidak berlaku untuk konteks yang saat ini dipilih):

  • Buat laporan kustom dan tambahkan dimensi lain. Klik .
  • Buat notifikasi dan tambahkan kondisi notifikasi tambahan, siapkan notifikasi, serta buat laporan kustom berdasarkan notifikasi tersebut.
  • Lihat konteks saat ini di dasbor Linimasa atau Investigasi. Klik > Lihat di Linimasa atau Lihat di Investigasi.

• Telusuri tampilan Daftar menurut nama atau URL (misalnya, https://acme.com/api). Masukkan semua atau sebagian string yang relevan dalam kotak penelusuran. Anda dapat menelusuri konten di kolom Proxy, Target, atau Region.

  Catatan: Jika filter Hanya pemberitahuan dipilih, hanya proxy API atau layanan target yang memiliki pemberitahuan yang akan dicantumkan di hasil penelusuran.

• Aktifkan atau nonaktifkan muat ulang otomatis halaman, sebagaimana diperlukan.

• Tampilkan dan sembunyikan detail layanan target dalam daftar.

Mengidentifikasi proxy dan layanan target API yang memiliki pemberitahuan

Saat melihat tampilan Daftar, ikon peringatan merah dan garis batas kiri merah menunjukkan proxy API dan layanan target mana yang memiliki pemberitahuan.

Klik Hanya laporan untuk hanya menampilkan proxy atau target layanan API yang memiliki pemberitahuan.

Untuk melihat ringkasan sekilas jumlah kesalahan 4xx dan 5xx, serta tingkat kesalahan secara keseluruhan, arahkan kursor mouse ke salah satu nilai numerik dalam tabel.

Melihat data mendetail untuk proxy atau layanan target API

Untuk melihat data detail untuk proxy atau layanan target API, klik namanya dalam tampilan Daftar. Data yang mendetail akan ditampilkan di panel sebelah kanan.

Klik tab berikut untuk melihat informasi selengkapnya:

• Detail
• Tren
• Log

Selain itu, dengan menggunakan konteks saat ini, Anda dapat melakukan tugas berikut dengan cepat:

Catatan: Opsi berwarna abu-abu jika tidak berlaku untuk konteks yang saat ini dipilih.

• Buat laporan kustom dan tambahkan dimensi lain. Klik .
• Buat notifikasi dan tambahkan kondisi notifikasi tambahan, siapkan notifikasi, serta buat laporan kustom berdasarkan notifikasi tersebut. Klik > Buat Notifikasi.
• Lihat konteks saat ini di dasbor Linimasa atau Investigasi. Klik > Lihat di Linimasa atau Lihat di Investigasi.

Detail

Tab Detail memberikan tampilan cepat data traffic untuk linimasa yang ditentukan (ditunjukkan di gambar sebelumnya), termasuk:

Detail	Deskripsi
Total Traffic	Jumlah total transaksi.
Total Error	Jumlah total error.
Total Tingkat Error	Persentase traffic yang mengakibatkan error (Total Error/Total Traffic). Catatan: Pemantauan API membandingkan persentase ini dengan kondisi pemberitahuan yang Anda tetapkan. Jika total rasio error melebihi nilai minimum, indikator pemberitahuan akan ditampilkan di UI.
TPS Rata-Rata	Rata-rata transaksi per detik.
Total Latensi (P99)	Total nilai latensi respons di persentil ke-99 yang dihitung selama periode yang berkelanjutan 5 menit. Catatan: Hanya ditampilkan untuk proxy API.
Latensi Target (P99)	Nilai latensi respons target di persentil ke-99 yang dihitung selama periode yang berkelanjutan 5 menit. Catatan: Hanya ditampilkan untuk proxy API.
Sumber Error	Perincian dan persentase total error paket proxy API (4xx dan 5xx) yang terjadi.

Trends

Tab Trends menampilkan grafik berikut untuk komponen yang dipilih:

• Tingkat Error untuk error 4xx dan 5xx
• Lalu lintas (TPS)
• Total Latensi (mdtk)

• Semua Target Latensi

Arahkan kursor ke berbagai titik pada grafik untuk menampilkan persentase error sekilas, jumlah total traffic, dan latensi di setiap titik.

Log

Di tab Logs, filter menurut 4xx, 5xx, atau All error, dan persempit sumber error dengan proxy API, target layanan (layanan Anda), atau Apigee (infrastruktur Apigee).

Klik error untuk membuka dialog log dan meluaskan detailnya dalam daftar.

Menggunakan Peta Panas

Heat Map memberikan tampilan blok warna yang memungkinkan Anda mengidentifikasi lingkungan yang memiliki peringatan.

• Hijau menunjukkan bahwa nilai minimum kondisi pemberitahuan belum terlampaui.
• Merah menunjukkan batas kondisi pemberitahuan telah terlampaui dan pemberitahuan telah dipicu.

Menjelajahi heat map

Klik di halaman Recent untuk menampilkan Heat Map, yang ditampilkan di gambar berikut.

Seperti yang ditampilkan dalam gambar sebelumnya, Peta Panas memungkinkan Anda untuk:

• Identifikasi proxy dan layanan target API yang memiliki pemberitahuan dengan cepat. (Lihat Menyiapkan pemberitahuan dan notifikasi untuk informasi tentang cara menyiapkan pemberitahuan.)
• Filter tampilan dengan memilih komponen dari daftar drop-down atau mengklik dua kali kotak untuk melihat perincian lebih lanjut. Di menu drop-down Proxy dan Target, Anda dapat memfilter menggunakan koleksi. Misalnya:
• Klik blok di heat map untuk melihat data mendetail di panel kanan.

• Dengan menggunakan konteks saat ini, lakukan tugas berikut dengan cepat (Opsi berwarna abu-abu jika tidak berlaku untuk konteks yang saat ini dipilih):

  • Buat laporan kustom dan tambahkan dimensi lain. Klik .
  • Buat notifikasi dan tambahkan kondisi notifikasi tambahan, siapkan notifikasi, serta buat laporan kustom berdasarkan notifikasi tersebut. Klik > Buat Notifikasi.
  • Lihat konteks saat ini di dasbor Linimasa atau Investigasi. Klik > Lihat di Linimasa atau Lihat di Investigasi.

• Tetapkan skala tampilan peta panas dengan menetapkan diskalakan menurut ke logaritmik atau linear. Ukuran linear kotak sesuai dengan rasio traffic keseluruhan. Misalnya, proxy dengan 200 panggilan dua kali ukuran proxy dengan 100 panggilan.

  

• Telusuri Peta Panas dengan memasukkan semua atau sebagian string yang relevan dalam kotak penelusuran. Anda dapat menelusuri konten di peta wilayah, lingkungan, proxy, atau target, bergantung pada apa yang saat ini ditampilkan.

  Catatan: Jika filter Hanya pemberitahuan dipilih, hanya proxy API atau layanan target yang memiliki pemberitahuan yang akan dicantumkan di hasil penelusuran.

• Aktifkan atau nonaktifkan muat ulang otomatis halaman, sebagaimana diperlukan.

Mengidentifikasi proxy dan layanan target API yang memiliki pemberitahuan

Saat melihat Heat Map, blok red menunjukkan lingkungan, proxy API, dan layanan target yang memiliki peringatan. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan pemberitahuan, lihat Menyiapkan pemberitahuan dan notifikasi.

Misalnya, gambar berikut menunjukkan dua lingkungan:

• lingkungan pengujian berwarna red karena persentase error traffic-nya telah melebihi nilai minimum kondisi pemberitahuan yang Anda tetapkan untuk linimasa yang ditentukan.
• lingkungan prod berwarna hijau karena persentase error traffic-nya belum melebihi nilai minimum kondisi pemberitahuan untuk linimasa yang ditentukan.

Filter tampilan dengan memilih komponen dari menu drop-down. Atau klik dua kali kotak untuk melihat perincian dari peta lingkungan ke peta proxy API, dan dari peta proxy API ke peta target layanan untuk proxy API tersebut guna mengidentifikasi proxy API dan layanan target yang memiliki pemberitahuan.

Lingkungan >>	Proxy >>	Target

Klik Hanya laporan untuk hanya menampilkan lingkungan, proxy API, atau target layanan yang memiliki pemberitahuan, bergantung pada hal yang saat ini ditampilkan.

Untuk kembali ke atas level, klik .

Melihat data terperinci untuk lingkungan, proxy API, atau layanan target

Untuk melihat data detail untuk lingkungan, proxy API, atau layanan target, klik kotak yang sesuai di Heat Map. Data yang mendetail akan ditampilkan di panel sebelah kanan.

Tab menyediakan informasi yang sama dengan yang diberikan di tampilan Daftar. Untuk informasi selengkapnya, lihat:

• Detail
• Tren
• Log

Mengeklik kotak di peta juga menampilkan sekilas jumlah panggilan dan tingkat kesalahan selama satu jam terakhir.

Membuat laporan kustom dari Dasbor terbaru

Buat laporan kustom berdasarkan kumpulan kondisi yang dipilih. Anda dapat mengedit laporan kustom setelah dibuat, untuk menambahkan atau menghapus metrik dan dimensi, sesuai kebutuhan. Misalnya, Anda mungkin ingin mempersempit penyelidikan ke token akses, aplikasi developer, atau proxy API tertentu. Untuk informasi selengkapnya, lihat Referensi metrik, dimensi, dan filter Analytics.

Untuk informasi selengkapnya, lihat Membuat laporan kustom.

Untuk membuat laporan khusus dari Dasbor terbaru:

1. Klik Analyze > API Monitoring > Recent di Edge UI.

2. Pilih proxy atau layanan target API di menu drop-down Tampilan Daftar atau filter Peta Panas untuk melihat detail selengkapnya. Catatan: Laporan kustom tidak tersedia jika filter Proxy dan Target ditetapkan ke All.

3. Di pojok kanan, klik .

   

   Halaman laporan kustom ditampilkan di tab baru dengan kolom yang relevan dan telah diisi otomatis serta dimensi dan metrik default. Secara default, laporan kustom diberi nama sebagai berikut: API Monitoring Recent Generated Catatan: Jika laporan kustom sudah ada untuk konteks saat ini, laporan akan dibuka.

4. Edit laporan kustom sesuai keinginan, lalu klik Simpan.

5. Klik nama laporan pada daftar dan jalankan laporan kustom.