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 antarmetrik untuk menyelidiki dan mendiagnosis masalah dengan lebih cepat. Anda dapat mengakses data dari 30 hari terakhir di dasbor.

Pilih Analyze > API Monitoring > dilaksanakan 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 dan layanan target API.

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

Menggunakan dasbor Investigasi untuk mendiagnosis masalah

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

1. Lihat matriks kode error versus waktu untuk melihat aktivitas kode kesalahan selama satu jam terakhir.
2. Beralihlah ke matriks kode error versus status HTTP untuk mengidentifikasi kode status HTTP tertentu yang terkait dengan kode kesalahan yang jumlahnya telah 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 masalah yang tinggi untuk melihat detail selengkapnya dan mengakses log.
5. Siapkan notifikasi dan buat laporan kustom untuk membantu mendiagnosis masalah lebih lanjut.

6. troubleshoot proxy API lebih lanjut menggunakan pelacakan 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.

Menjelajahi dasbor Kode Status

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

Seperti yang disorot dalam gambar, dasbor Investigasi memungkinkan Anda untuk:

• Konfigurasi setiap matriks dengan menetapkan sumbu x dan sumbu y untuk membandingkan aktivitas relasional antarmetrik dan mendapatkan lebih banyak insight.
• Identifikasi metrik yang mengalami volume relatif tertinggi dengan cepat berdasarkan bayangan warna blok. Semakin gelap bloknya, 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 > > atau >.
• Buat laporan kustom dan tambahkan dimensi lain 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 Status Code, matriks berikut akan muncul secara default:

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

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

• Kode kesalahan
• Kebijakan kesalahan
• Sumber kesalahan
• 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

Melihat detail untuk metrik tertentu dengan mengklik bloknya di matriks.

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

• Lingkungan
• Organisasi
• Wilayah
• Sumber Kesalahan (proksi, 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 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 berdasarkan 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 dan layanan target API di organisasi Anda. Anda dapat menyelidiki metrik latensi selama satu jam kapan saja dalam 30 hari terakhir.

Mempelajari dasbor Latensi

Untuk menampilkan dasbor Latensi, pilih Analyze > API Monitoring > Exploring di Edge UI. 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)
• Proxy vs Total latensi (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 latensi respons total (p50, p90, p95, p99).
• Anda hanya dapat memilih periode satu jam untuk metrik latensi.
• Anda tidak dapat memilih Any untuk Wilayah dalam filter. Anda harus memilih wilayah tertentu untuk ditampilkan.

Lihat detail metrik Latensi

Melihat detail untuk 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 masing-masing target.

Melihat 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 berdasarkan:

• 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 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

1. Klik sebuah blok dalam matriks untuk menampilkan detail selengkapnya.

   

2. Di panel kanan, klik .

   

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

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

   

3. Edit laporan kustom, sesuai kebutuhan. Lihat artikel Mengelola laporan kustom.

4. Klik Simpan untuk menyimpan laporan kustom.

Laporan dijalankan menggunakan data yang dikumpulkan selama satu jam terakhir secara default dan data ditampilkan di dasbor laporan kustom. Lihat Menjelajahi dasbor laporan kustom.

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

Menyelidiki pemberitahuan tertentu

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

• Melihat detail traffic API pada 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) guna melihat playbook untuk mendapatkan pemberitahuan:

  

• Klik Kelola notifikasi untuk mengedit notifikasi.

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

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