Menyelidiki masalah

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

Dasbor Investigasi memungkinkan Anda melihat tabel pivot metrik dan atribut untuk semua traffic API dan membandingkan aktivitas relasional antar-metrik guna menyelidiki dan mendiagnosis masalah dengan lebih cepat. Anda dapat mengakses data dari 30 hari terakhir di dasbor.

Pilih Analyze > API Monitoring > checkout di UI Edge untuk membuka dasbor Investivate. Dasbor ini memiliki dua area utama:

• Kode Status memungkinkan Anda menyelidiki metrik kode status untuk proxy API dan layanan target.
• Latensi memungkinkan Anda menyelidiki masalah latensi untuk proxy API dan layanan target.

Anda juga dapat menyelidiki masalah yang disebabkan oleh pemberitahuan tertentu di dasbor Investigasi. Saat notifikasi muncul, klik nama notifikasi di halaman Histori Notifikasi untuk membuka notifikasi di dasbor Invesitgate.

Menggunakan dasbor Investigasi untuk mendiagnosis masalah

Misalnya, Anda menerima peringatan yang menunjukkan bahwa tingkat error 5xx melebihi nilai minimum yang ditentukan. Untuk menyelidiki masalah ini, Anda dapat melakukan tugas berikut di dasbor Investigasi:

1. Lihat matriks kode kesalahan versus waktu untuk melihat aktivitas kode kesalahan selama satu jam terakhir.
2. Beralihlah ke matriks kode masalah versus status HTTP untuk mengidentifikasi kode status HTTP tertentu yang terkait dengan kode kesalahan yang jumlahnya meningkat selama satu jam terakhir, seperti yang diidentifikasi pada langkah sebelumnya.
3. Beralihlah ke matriks kode error versus Proxy untuk mengidentifikasi proxy API yang memicu kode kesalahan yang diidentifikasi pada langkah sebelumnya.
4. Klik kotak dalam matriks yang terkait dengan proxy API dengan volume kode kesalahan yang tinggi untuk melihat detail selengkapnya dan mengakses log.
5. Siapkan notifikasi dan buat laporan kustom untuk membantu mendiagnosis masalah lebih lanjut.

6. Pecahkan masalah proxy API lebih lanjut menggunakan rekaman aktivitas dan alat lainnya untuk mengidentifikasi penyelesaian masalah.

Menggunakan dasbor Kode Status

Dasbor Kode Status memungkinkan Anda menyelidiki metrik kode status untuk proxy API dan layanan target di organisasi Anda. Anda dapat melihat metrik kode status untuk periode satu jam atau empat jam kapan saja dalam 30 hari terakhir.

Mempelajari dasbor Kode Status

Untuk menampilkan dasbor Kode Status, pilih Analyze > API Monitoring > Identify di UI Edge. Dasbor Kode Status ditampilkan secara default:

Seperti yang disorot dalam gambar, dasbor Investigasi memungkinkan Anda:

• Konfigurasi setiap matriks dengan menetapkan sumbu x dan sumbu y untuk membandingkan aktivitas relasional antarmetrik dan mendapatkan lebih banyak insight.
• Identifikasi dengan cepat metrik yang mengalami volume relatif tertinggi berdasarkan bayangan warna blok. Semakin gelap blok, semakin tinggi volume relatifnya.
• Klik blok dalam matriks untuk melihat detail metrik.
• Filter data berdasarkan hal berikut:
  • Lingkungan
  • Wilayah
  • Proxy
  • Kode status (termasuk semua traffic, semua error, 2xx, 4xx, atau 5xx)
  • Tanggal dan waktu dalam 30 hari terakhir
  • Jendela 1 jam atau 4 jam

Gunakan dasbor untuk melakukan tugas berikut dengan cepat:

• Akses log di panel detail metrik.
• Lihat konteks saat ini di Terbaru atau Linimasa atau dasbor dengan mengklik > Lihat di Terbaru atau Lihat di Linimasa.
• Buat laporan kustom dan tambahkan dimensi lainnya dengan mengklik .
• Buat notifikasi dan tambahkan kondisi notifikasi tambahan, siapkan notifikasi, serta buat laporan kustom berdasarkan notifikasi tersebut.

Mengonfigurasi matriks Kode Status

Saat Anda memilih dasbor Kode Status, matriks berikut akan muncul secara default:

• Kode masalah versus waktu
• Kode masalah versus status HTTP
• Sumber kesalahan versus proxy API

Konfigurasi setiap matriks untuk membandingkan dua metrik berikut dengan memilih nilai untuk menu drop-down x- dan sumbu y:

• Kode masalah
• Kebijakan kerusakan
• Sumber masalah
• Status HTTP
• Proxy
• Waktu
• Wilayah
• Target (Layanan target atau kebijakan ServiceCallout. Jika targetnya adalah kebijakan ServiceCallout, nilai yang ditampilkan akan diawali dengan sc://. Misalnya, sc://my.endpoint.net.)

Lihat detail metrik Kode Status

Lihat detail metrik tertentu dengan mengklik bloknya di matriks.

Detail yang berkaitan dengan dugaan penyebab ditampilkan di panel kanan, termasuk:

• Lingkungan
• Organisasi
• Wilayah
• Sumber Kesalahan (proxy, target, atau infrastruktur Apigee)

Detail juga dapat mencakup:

• Kebijakan Kesalahan - Informasi tentang kebijakan yang memicu error runtime, termasuk jenis kebijakan (nama internal) dan nama kebijakan yang ditentukan pengguna. Anda menentukan nama tersebut saat melampirkan kebijakan ke alur proxy API.
• Nama proxy
• Kode Status HTTP
• Kode Kesalahan

Jika kardinalitas lebih besar dari satu untuk metrik tertentu, panel detail dapat menyertakan detail distribusi error, seperti Distribusi menurut Aplikasi Developer, Distribusi menurut Kebijakan Kesalahan, Distribusi menurut Kode Kesalahan, Distribusi menurut Status HTTP, dan sebagainya. Contoh:

Jika sumber kesalahan ditargetkan, panel detail akan menyertakan Tingkat Error berdasarkan Target. Contoh:

Menggunakan dasbor Latensi

Dasbor Latensi menampilkan informasi latensi untuk proxy API dan layanan target di organisasi Anda. Anda dapat menyelidiki metrik latensi untuk wow satu jam kapan saja dalam 30 hari terakhir.

Mempelajari dasbor Latensi

Untuk menampilkan dasbor Latency, pilih Analyze > API Monitoring > checkout di UI Edge. Dasbor Kode Status ditampilkan secara default. Pilih Latensi di area filter untuk menampilkan dasbor Latensi.:

Saat Anda memilih dasbor Latensi, matriks berikut akan muncul secara default:

• Proxy vs Waktu (latensi maksimum dalam milidetik)
• Latensi Proxy vs Total (latensi maksimum dalam milidetik)
• Latensi Proxy vs Semua target (latensi maksimum dalam milidetik)

Gunakan kotak drop-down Proxy untuk memilih Target guna melihat latensi target.

Secara default, dasbor Latensi menampilkan informasi untuk 10 proxy dengan total latensi P99 tertinggi selama satu jam sebelumnya. Atau, gunakan kotak drop-down Top 10 untuk memilih proxy atau koleksi tertentu.

Dasbor Latensi memiliki semua fitur dasbor Kode Status, dengan perbedaan berikut:

• Anda hanya mengonfigurasi persentil total latensi respons (p50, p90, p95, p99).
• Anda hanya dapat memilih periode satu jam untuk metrik latensi.
• Anda tidak dapat memilih Semua untuk Wilayah di filter. Anda harus memilih wilayah spesifik untuk dilihat.

Lihat detail metrik Latensi

Lihat detail metrik tertentu dengan mengklik bloknya di matriks.

Detail yang berkaitan dengan latensi untuk proxy (garis biru) dan target (garis ungu) ditampilkan di panel kanan, termasuk:

• Total latensi (latensi proxy ditambah latensi target)
• Latensi per target (target waktu respons)
• Distribusi berdasarkan Status HTTP

Arahkan kursor ke atas grafik untuk melihat informasi mendetail:

Grafik Latensi per target menampilkan 16 target teratas berdasarkan latensi maksimum, dengan satu grafik per target. Arahkan kursor ke grafik atau pilih daftar dropdown untuk menentukan grafik yang sesuai dengan setiap target.

Lihat log dari detail metrik

Saat melihat detail metrik untuk kode status atau latensi, klik Lihat log guna melihat semua log untuk metrik yang dipilih:

Dialog Log Traffic akan terbuka dan menampilkan maksimum 1.000 entri log. Klik entri log untuk meluaskan detailnya dalam daftar:

Anda dapat memfilter log lebih lanjut menurut:

• Sumber traffic
• Jenis error
• Waktu respons minimum

Anda tidak dapat mendownload data log dari dialog Log Traffic. Namun, Anda dapat membuat laporan kustom atau mendownload data analisis ke repositori data Anda sendiri, seperti Google Cloud Storage atau BigQuery, untuk melakukan analisis data sendiri.

Membuat laporan kustom dari dasbor Investigasi

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 investigasi ke token akses, aplikasi developer, atau proxy API tertentu. Untuk informasi selengkapnya, lihat Referensi filter, dimensi, dan metrik Analytics.

Untuk informasi selengkapnya, lihat Membuat laporan kustom.

Untuk membuat laporan khusus

1. Klik blok dalam matriks untuk menampilkan detail selengkapnya.

   

2. Di panel kanan, klik .

   

   Halaman laporan kustom ditampilkan di tab baru dengan kolom yang relevan telah terisi otomatis.

   Catatan: Lihat Membuat laporan kustom untuk informasi selengkapnya tentang setelan laporan kustom default.

   

3. Edit laporan kustom, sebagaimana yang diperlukan. Lihat artikel Mengelola laporan kustom.

4. Klik Simpan untuk menyimpan laporan kustom.

Secara default, laporan dijalankan menggunakan data yang dikumpulkan selama satu jam terakhir dan data tersebut ditampilkan di dasbor laporan kustom. Lihat Menjelajahi dasbor laporan kustom.

Di halaman Laporan, laporan kustom yang dibuat menggunakan Pemantauan API diberi nama menggunakan format berikut: API Monitoring Investigate Generated.

Menyelidiki notifikasi tertentu

Untuk menyelidiki notifikasi tertentu, pilih nama notifikasi di halaman Alert History. Dasbor Investigasi akan muncul. Perhatikan bahwa dasbor ini berisi grafik di bagian atas dasbor, dan hanya menyertakan informasi yang spesifik untuk pemberitahuan:

• Lihat detail traffic API saat notifikasi dipicu.
• Melihat informasi kontekstual tentang notifikasi, termasuk waktu notifikasi dipicu di bagian tengah grafik.
• Klik Detail kondisi untuk menampilkan detail kondisi pemberitahuan di jendela pop-up.

• Klik Playbook (jika tersedia) untuk melihat playbook untuk mendapatkan notifikasi:

  

• Klik Kelola notifikasi untuk mengedit notifikasi.

• Klik Lihat laporan (jika tersedia) untuk melihat laporan kustom.

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