Anda sedang melihat dokumentasi Apigee Edge.
Buka
Dokumentasi Apigee X. info
Anda sedang melihat dokumentasi Apigee X.
Lihat
Dokumentasi Apigee Edge.
Memberikan informasi yang detail dan diperlukan dalam kasus dukungan akan memudahkan Tim Dukungan Google Cloud Apigee untuk merespons Anda dengan cepat dan efisien. Saat tim dukungan Anda tidak memiliki detail penting, kita perlu meminta informasi lebih lanjut, yang mungkin melibatkan bolak-balik beberapa kali. Hal ini memerlukan waktu yang lebih lama dan dapat menyebabkan keterlambatan penyelesaian masalah. Panduan Praktik Terbaik ini memberi tahu Anda informasi yang kami perlukan untuk menyelesaikan masalah teknis kasus dukungan dengan lebih cepat.
Mendeskripsikan masalah
Masalah harus berisi informasi yang menjelaskan detail tentang apa yang terjadi dan apa yang terjadi apa yang diharapkan terjadi, serta kapan dan bagaimana hal itu terjadi. Kasus dukungan Apigee yang baik harus berisi informasi utama berikut untuk setiap produk Apigee:
Informasi utama | Deskripsi | Apigee Edge untuk Cloud Publik | Apigee Edge untuk Private Cloud |
---|---|---|---|
Produk | Produk Apigee tertentu yang mengamati masalah, termasuk versi jika perlu. |
|
|
Detail Masalah | Deskripsi masalah yang jelas dan mendetail yang menguraikan masalah, termasuk jika ada. |
|
|
Waktu | Stempel waktu spesifik kapan masalah mulai terjadi dan berapa lama masalah tersebut berlangsung. |
|
|
Penyiapan | Informasi mendetail tempat masalah diamati. |
|
|
Bagian berikut menjelaskan konsep-konsep ini secara lebih mendetail.
Produk
Terdapat berbagai produk Apigee, yaitu Apigee Edge di Public Cloud dan Apigee Edge di Private Cloud, sehingga kita memerlukan informasi produk tertentu yang mengalami masalah.
Tabel berikut berisi beberapa contoh yang menunjukkan informasi lengkap di kolom TINDAKAN, dan informasi yang tidak lengkap di kolom Kolom LARANGAN:
ANJURAN | LARANGAN |
---|---|
Deployment proxy API OAuth2 gagal di organisasi Public Cloud kami ... |
Deployment proxy API gagal (Kami perlu mengetahui produk Apigee yang bermasalah.) |
Penginstalan gagal dengan error berikut pada Edge Private Cloud versi 4.50.00 ... |
Penginstalan gagal pada penyiapan Private Cloud kami. (Informasi versi tidak ada) |
Detail Masalah
Berikan informasi akurat tentang masalah yang sedang diamati, termasuk pesan error (jika setiap) dan perilaku yang diharapkan serta aktual yang diamati.
Tabel berikut menyediakan beberapa contoh yang menampilkan informasi lengkap di kolom TINDAKAN, dan informasi tidak lengkap di kolom LARANGAN:
ANJURAN | LARANGAN |
---|---|
Proxy
|
Proxy (Nama proxy tidak diketahui. Tidak jelas apakah {i>proxy<i} menampilkan kesalahan atau respons yang tidak diharapkan.) |
Klien kami mendapatkan
|
Klien kami mendapatkan Error
(Hanya menyampaikan |
Waktu
Waktu adalah informasi yang sangat kritis. Penting bagi Teknisi Dukungan untuk mengetahui kapan Anda pertama kali melihat masalah ini, berapa lama masalah itu terjadi, dan apakah masalah tersebut masih terjadi.
Engineer Dukungan yang menyelesaikan masalah ini mungkin tidak menggunakan zona waktu Anda, jadi pernyataan yang bersifat relatif tentang waktu akan membuat masalah itu lebih sulit untuk didiagnosis. Oleh karena itu, sebaiknya gunakan Format ISO 8601 untuk tanggal dan waktu stempel waktu untuk memberikan informasi waktu tepat tentang kapan masalah itu ditemukan.
Tabel berikut menampilkan beberapa contoh yang menunjukkan waktu dan durasi yang akurat saat terjadi di kolom TINDAKAN, dan informasi yang ambigu atau tidak jelas tentang kapan terjadi di kolom LARANGAN:
ANJURAN | LARANGAN |
---|---|
Sejumlah besar 503s diamati kemarin antara 06-11-2020 pukul 17.30 PDT
dan 2020-11-06 17:35 PDT... |
Sejumlah besar (Kami terpaksa menggunakan tanggal tersirat dan juga tidak jelas di zona waktu mana masalah ini muncul diamati.) |
Latensi tinggi diamati di Proxy API berikut dari 2020-11-09 15:30 IST hingga 09-11-2020 18:10 IST ... |
Latensi tinggi diamati di beberapa Proxy API minggu lalu. (Tidak jelas hari dan durasi mana masalah ini diamati dalam seminggu terakhir.) |
Penyiapan
Kami perlu mengetahui detail tentang lokasi masalah yang Anda alami. Bergantung pada pada produk yang Anda gunakan, kami memerlukan informasi berikut:
- Jika Anda menggunakan Apigee Cloud, Anda mungkin memiliki lebih dari satu organisasi, jadi kami perlu
untuk mengetahui organisasi spesifik dan detail lain tempat Anda mengamati masalah:
- Nama Organisasi dan Lingkungan
- Nama proxy dan nomor revisi API (untuk kegagalan permintaan API)
- Jika menggunakan Private Cloud, Anda mungkin menggunakan salah satu dari banyak opsi yang didukung topologi penginstalan. Jadi kami perlu tahu topologi apa yang Anda gunakan, termasuk rincian seperti jumlah pusat data dan {i>node<i}.
Tabel berikut menyediakan beberapa contoh yang menampilkan informasi lengkap di kolom TINDAKAN, dan informasi tidak lengkap di kolom LARANGAN:
ANJURAN | LARANGAN |
---|---|
Detail penyiapan Edge:
Detail API yang gagal adalah sebagai berikut:
Error:
|
(Laporan ini tidak memberikan informasi apa pun tentang produk yang digunakan, karena kapan masalahnya yang diamati atau detail penyiapan apa pun.) |
Tidak dapat memulai Pemroses Pesan di Edge Private Cloud versi 4.19.06 setelah dan menambahkan node gateway tambahan. Log diagnostik:
Topologi jaringan:
|
Tidak dapat memulai Pemroses Pesan di Edge Private Cloud versi 4.19.06 setelah dan menambahkan node gateway tambahan. (Log Pemroses Pesan dan topologi jaringan tidak ada.) |
Artefak berguna
Memberikan artefak yang terkait dengan masalah kepada kami akan mempercepat penyelesaian masalah, karena ini akan membantu kami memahami perilaku sebenarnya yang Anda amati dan mendapatkan lebih banyak wawasan.
Bagian ini menjelaskan beberapa artefak berguna yang berguna untuk semua produk Apigee:
Artefak umum untuk semua produk Apigee
Artefak berikut berguna untuk semua produk Apigee: Apigee Edge di Public Cloud dan Apigee Edge di Private Cloud:
Artefak | Deskripsi |
---|---|
Output alat rekaman aktivitas | Output alat Trace berisi informasi mendetail tentang permintaan API yang mengalir
Produk Apigee. Hal ini berguna untuk error runtime seperti 4XX ,
5XX , dan masalah latensi. |
Screenshot | Screenshot membantu menyampaikan konteks perilaku sebenarnya atau error yang diamati. Penting berguna untuk setiap error atau masalah yang diamati, seperti di UI atau Analytics. |
HAR (Http ARchive) | HAR adalah file yang direkam oleh alat sesi HTTP untuk proses debug masalah terkait UI. Gambar ini dapat direkam menggunakan browser seperti Chrome, Firefox, atau Internet Explorer. |
tcpdumps |
Alat tcpdump menangkap paket TCP/IP yang ditransfer atau diterima melalui
jaringan. Cara ini berguna untuk masalah terkait jaringan
seperti kegagalan TLS handshake,
502 error, dan masalah latensi, dll. |
Artefak tambahan untuk Apigee Edge untuk Private Cloud
Untuk Apigee Edge untuk Private Cloud, kami mungkin memerlukan beberapa artefak tambahan yang akan memfasilitasi lebih cepat diagnosis masalah.
Artefak | Deskripsi |
---|---|
Topologi jaringan | Diagram topologi penginstalan Edge yang menjelaskan penyiapan Private Cloud Anda termasuk semua pusat data, {i>node<i}, dan komponen yang diinstal di setiap {i>node<i}. |
Log diagnostik komponen Edge | Log diagnostik yang terkait dengan komponen Apigee Edge tertentu seperti Message Processor, Router, atau Cassandra. |
File Konfigurasi Penginstalan | File konfigurasi senyap yang digunakan saat menginstal atau mengupgrade Apigee Edge.
File ini berguna untuk memvalidasi apakah semua setelan sudah benar jika terjadi masalah penginstalan atau migrasi. |
Heap dump | Heap dump adalah snapshot dari proses memori Java. Hal ini membantu jika memori tinggi
pemanfaatan atau error OutOfMemory terlihat pada komponen Edge tertentu. |
Thread dump | Thread dump adalah snapshot dari semua thread dari proses Java yang sedang berjalan.
Hal ini sangat membantu jika CPU atau Beban yang tinggi diamati pada komponen Edge tertentu. |
Template kasus dan contoh kasus
Bagian ini menyediakan template kasus dan contoh kasus untuk berbagai produk berdasarkan praktik terbaik yang dijelaskan dalam dokumen ini:
Apigee Edge di Cloud Publik
Template
Bagian ini menyediakan {i>template<i} contoh untuk Apigee Edge di Cloud Publik.
Masalah:
<Berikan deskripsi terperinci tentang masalah atau perilaku yang Anda amati. Sertakan nama dan versi produk jika ada.>
Pesan error:
<Sertakan pesan error lengkap yang diamati (jika ada)>
Masalah waktu mulai (format ISO 8601):
Masalah waktu berakhir (format ISO 8601):
Detail penyiapan Apigee:
Nama organisasi:
Nama Env:
Nama proxy API:
Nomor revisi:
Langkah-langkah untuk mereproduksi bug:
<Berikan langkah-langkah untuk merekonstruksi masalah jika memungkinkan>
Informasi diagnostik:
<Daftar file terlampir>
Contoh kasus
Bagian ini memberikan contoh kasus untuk Apigee Cloud (Apigee on Google Cloud/Apigee Edge di Cloud Publik).
Masalah:
Kami melihat tingginya error Layanan Tidak Tersedia 503 di akun Public Cloud kami org. Dapatkah Anda melihat masalah tersebut dan menyelesaikannya atau memberi tahu kami cara mengatasinya?
Pesan error:
{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}
Waktu mulai masalah (format ISO 8601): 2020-10-04 06:30 IST
Waktu berakhir masalah (format ISO 8601): Masalah masih terjadi.
Detail penyiapan Apigee Cloud:
Nama organisasi: myorg
Nama Env: dev
Nama proxy API: myproxy
Nomor revisi: 3
Langkah-langkah untuk mereproduksi bug:
Jalankan perintah curl
berikut untuk mereproduksi masalah:
curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'
Informasi diagnostik:
Output alat rekaman aktivitas (trace-503.xml
)
Apigee Edge untuk Private Cloud
Template
Bagian ini menyediakan {i>template<i} contoh untuk Apigee Edge untuk Private Cloud.
Masalah:
<Berikan deskripsi terperinci tentang masalah atau perilaku yang Anda amati. Sertakan nama dan versi produk jika ada.>
Pesan error:
<Sertakan pesan error lengkap yang diamati (jika ada)>
Masalah waktu mulai (format ISO 8601):
Masalah waktu berakhir (format ISO 8601):
Detail penyiapan Edge Private Cloud:
<Lampirkan topologi jaringan yang menjelaskan penyiapan Private Cloud Anda, termasuk pusat data dan node>
Langkah-langkah untuk mereproduksi bug:
<Berikan langkah-langkah untuk merekonstruksi masalah jika memungkinkan>
Informasi diagnostik
<Daftar file terlampir>
Contoh kasus
Bagian ini memberikan contoh kasus untuk Apigee Edge untuk Private Cloud.
Masalah:
Ketika kami menginstal Server Pengelolaan Apigee di Node #10 sebagai bagian dari Edge Private Cloud 4.19.06 di Linux RHEL 7.6, kita menemukan error berikut.
Pesan Error:
<snipped as the output is too long>
Checking for management-server uuid ................................................
Unable to get uuid for management-server.
Error: setup.sh: /opt/apigee/apigee-service/bin/apigee-service exited with unexpected status 1
Masalah waktu mulai (format ISO 8601): Terjadi setiap kali kami menginstal
Masalah waktu berakhir (format ISO 8601): Tidak berlaku
Detail penyiapan Edge Private Cloud:
Kami telah melampirkan file network-topology.png
Langkah-langkah untuk mereproduksi bug:
Berikut adalah perintah yang menghasilkan error di atas:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt
Informasi diagnostik:
Terlampir file berikut:
output.txt
berisi output lengkap dari perintah di atas termasuk pesan error- Pengelolaan log server dan
- File konfigurasi
NonProdConfig.txt