Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Lihat dokumentasi Apigee Edge.
Tindakan pemecahan masalah adalah seni sekaligus ilmu pengetahuan. Upaya berkelanjutan tim dukungan teknis Apigee adalah untuk menjelaskan seni dan memaparkan ilmu di balik identifikasi dan penyelesaian masalah.
Apa itu playbook?
Dikembangkan melalui kolaborasi dengan tim Dukungan Teknis Apigee, playbook pemecahan masalah Apigee dirancang untuk memberikan solusi cepat dan efektif atas error atau masalah lain yang mungkin Anda alami saat menggunakan produk Apigee.
Audiens
Playbook pemecahan masalah ditujukan bagi pembaca yang memiliki pemahaman tingkat tinggi tentang Apigee dan arsitekturnya, serta beberapa pemahaman tentang konsep dasar seperti kebijakan dan analisis.
Beberapa masalah hanya dapat didiagnosis dan diselesaikan oleh pengguna Apigee hybrid dan mungkin memerlukan pengetahuan tentang komponen internal seperti datastore Cassandra, Message Processor, dan Sinkronisasi.
Jika Anda menggunakan Apigee, kami akan secara jelas menentukan kapan Anda dapat melakukan langkah-langkah pemecahan masalah yang ditunjukkan dan kapan Anda perlu menghubungi Layanan Pelanggan Google Cloud untuk mendapatkan bantuan.
Playbook
Bagian ini menjelaskan playbook saat ini.
Untuk memfilter tabel ini, lakukan satu atau beberapa hal berikut: pilih kategori, pilih produk, ketik istilah penelusuran, atau klik judul kolom untuk mengurutkan.
| Kategori | Deskripsi playbook/masalah | Pesan error | Playbook berlaku untuk |
|---|---|---|---|
| Cassandra | Kegagalan verifikasi sertifikat TLS Cassandra | Jika sertifikat CA Apigee tidak cocok di seluruh cluster, verifikasi sertifikat TLS di Cassandra dapat gagal. | Khusus Apigee hybrid |
| Cassandra | Memecahkan masalah pemulihan Cassandra | Selama pemulihan Cassandra di Apigee hybrid, Anda mungkin mengalami error dalam log pemulihan. | Khusus Apigee hybrid |
| Pemunculan masalah otomatis | Tidak ada konektivitas jaringan antara bidang runtime dan bidang kontrol | Permintaan pengelolaan API Apigee gagal:
|
Khusus Apigee hybrid |
| Penemuan masalah otomatis | Host virtual tidak memiliki grup lingkungan | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_VIRTUALHOST_MISSING_ENVGROUP akan ditampilkan.
|
Khusus Apigee hybrid |
| Pemunculan masalah otomatis | Pemilih host virtual tidak ada | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_VIRTUALHOST_MISSING_SELECTOR akan ditampilkan.
|
Khusus Apigee hybrid |
| Penemuan masalah otomatis | Ketidakcocokan sertifikat Ingress | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_CERT_MISMATCH akan ditampilkan.
|
Khusus Apigee hybrid |
| Pemunculan masalah otomatis | Masa berlaku sertifikat Ingress | Setelah menjalankan kubectl -n apigee get apigeeissues, error
AIS_INGRESS_CERT_EXPIREY akan ditampilkan.
|
Khusus Apigee hybrid |
| Pemunculan masalah otomatis | Masa berlaku sertifikat CA mTLS Ingress | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_MTLS_CA_CERT_EXPIREY akan ditampilkan.
|
Khusus Apigee hybrid |
| Penemuan masalah otomatis | Sertifikat CA mTLS Ingress tidak valid | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_MTLS_CA_CERT_INVALID akan ditampilkan.
|
Khusus Apigee Hybrid |
| Cassandra | Kegagalan replikasi data Cassandra |
Saat mereplikasi data selama perluasan multi-region, status CassandraDataReplication mungkin menampilkan status error dan replikasi data mungkin gagal.
|
Khusus Apigee hybrid |
| Cassandra | Masalah ruang heap Java Cassandra |
Masalah heap Cassandra dapat menyebabkan kelambatan dalam eksekusi proxy Apigee hybrid atau bahkan error Datastore. Terkadang log menjadi indikator awal, bahkan sebelum gejala muncul.
|
Khusus Apigee Hybrid |
| Cassandra | Pod Cassandra tidak dimulai di region sekunder |
Pod Cassandra gagal dimulai di salah satu region dalam konfigurasi Hybrid multi-region.
Anda mungkin melihat pesan error node already exists di log pod Cassandra, atau
peringatan FailedPreStopHook di status pod Cassandra.
|
Khusus Apigee Hybrid |
| Cassandra | Panduan pemecahan masalah Cassandra |
Saat menggunakan kubectl untuk melihat status pod, Anda akan melihat bahwa satu atau beberapa pod Cassandra macet. Panduan ini menjelaskan diagnosis
dan penyelesaian masalah terkait datastore Cassandra.
|
Khusus Apigee hybrid |
| Deployment | Deployment proxy API gagal dengan peringatan tidak ada pod runtime yang aktif | Peringatan No active runtime pods ditampilkan dalam dialog Details di samping pesan error Deployment issues on ENVIRONMENT: REVISION_NUMBER di halaman proxy API. | Khusus Apigee hybrid |
| Ingressgateway | Panggilan API gagal dengan error waktu tunggu habis |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Khusus Apigee hybrid |
| Ingressgateway | Panggilan API gagal dengan error TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Khusus Apigee Hybrid |
| Logging | Memecahkan masalah log Apigee yang tidak ada di Cloud Logging | Tidak ada pesan error yang diketahui ditampilkan dalam skenario ini. | Apigee dan Apigee hybrid |
| Pengelolaan/UI | Data tidak konsisten/tidak ada untuk entitas di UI hybrid atau melalui Management API | Tidak ada pesan error yang diketahui ditampilkan dalam skenario ini. | Khusus Apigee hybrid |
| Konfigurasi jaringan | Masalah pemilihan rute akses dengan Apigee |
Klien eksternal tidak dapat mengakses/terhubung ke Apigee dengan cara yang diinginkan. Hal ini mencakup kegagalan konektivitas jaringan (TLS handshake gagal) atau respons 4xx/5xx dari Apigee.
|
Apigee dan Apigee hybrid |
| Konfigurasi jaringan | Masalah konektivitas Apigee dengan Private Service Connect northbound |
Penyiapan Private Service Connect ke utara tidak berfungsi seperti yang diharapkan, dan status grup endpoint jaringan tetap dalam Pending.
|
Khusus Apigee |
| Konfigurasi jaringan | Masalah konektivitas Apigee dengan target Private Service Connect southbound |
Masalah koneksi jaringan atau waktu tunggu TCP antara Apigee dan
layanan target akan muncul sebagai respons error 503 dan
akan menampilkan error yang mirip dengan di bawah jika Anda membuat sesi debug.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee dan Apigee hybrid |
| Lainnya | Memperluas jumlah replika properti Istio saat menguras node | Saat mengosongkan pod Istio, beberapa node mungkin tidak dikosongkan karena memiliki jumlah replika 1, sedangkan diperlukan 3 replika atau lebih. Untuk menghindari hal ini, Anda harus menetapkan jumlah replika minimum untuk setiap properti minimal 3. | Khusus Apigee Hybrid |
| Lainnya | Panduan pemecahan masalah pemroses pesan |
Satu atau beberapa pod apigee-runtime tidak dalam status Ready.
Saat menggunakan kubectl untuk mendeskripsikan pod apigee-runtime yang gagal, Anda akan melihat error:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Khusus Apigee Hybrid |
| Lainnya | Mencetak info build |
buildinfo API menampilkan informasi tentang build saat ini untuk komponen runtime. Informasi ini mungkin berguna jika Anda perlu menghubungi dukungan.
|
Khusus Apigee Hybrid |
| Lainnya | Error StreamingPull 100% |
Jika Anda melihat di dasbor metrik bahwa metode
google.pubsub.vl.Subscriber.StreamingPull gagal dengan
error 100%, Anda dapat mengabaikan masalah ini dengan aman. Ini adalah perilaku yang diharapkan.
|
Khusus Apigee hybrid |
| Deployment | Instance tidak melaporkan status untuk grup lingkungan | Deployment proxy API gagal dengan error Instance INSTANCE_NAME tidak melaporkan status untuk grup lingkungan ENV_GROUP_NAME di UI Apigee hybrid. | Khusus Apigee Hybrid |
| Deployment | Deployment proxy API gagal dengan pesan error apigee-serving-cert tidak ditemukan atau sudah tidak berlaku |
Deployment proxy API gagal dengan pesan error di log apigee-watcher.
|
Khusus Apigee hybrid |
| Ingressgateway | Perbanyak jumlah replika properti Istio untuk menghindari masalah saat mengosongkan node Istio |
Saat menguras pod Istio, beberapa node mungkin tidak dikuras karena memiliki
jumlah replika 1, sedangkan 3 atau lebih replika
diperlukan. Untuk menghindarinya, Anda harus menetapkan jumlah replika minimum
untuk setiap properti ke setidaknya 3.
|
Khusus Apigee hybrid |
| Konfigurasi jaringan | Pemecahan masalah ruang alamat IP gratis tidak ada | Selama penyediaan Apigee, jika Anda memilih rentang CIDR jaringan yang tidak sepenuhnya gratis, Anda mungkin akan melihat pesan error. | Apigee dan Apigee hybrid |
| Konfigurasi jaringan | Error 503 Service Unavailable dengan TARGET_CONNECT_TIMEOUT (target peering Internet dan VPC) | Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki error "503 Layanan Tidak Tersedia" dengan TARGET_CONNECT_TIMEOUT saat menggunakan target peering VPC atau internet. | Apigee |
| Konfigurasi jaringan | 504 Gateway timeout - Target read timeout | Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki error "504 Gateway Timeout" dengan alasan TARGET_READ_TIMEOUT. | Apigee dan Apigee hybrid |
| Runtime | Permintaan API gagal dengan error TARGET CONNECT HOST NOT REACHABLE | Dokumen ini menjelaskan cara mendiagnosis dan mengatasi error kode status respons HTTP 503 dengan alasan "TARGET_CONNECT_HOST_NOT_REACHABLE". | Apigee dan Apigee hybrid |
| Runtime | Permintaan API gagal dengan error 502 Bad Gateway "Unexpected EOF at target" | Playbook ini menjelaskan cara mendiagnosis dan menyelesaikan error 502 Bad Gateway Unexpected EOF. | Apigee dan Apigee hybrid |
| Lainnya | Memecahkan masalah Apigee Hybrid yang macet dalam status pembuatan atau pelepasan |
Dokumen ini menjelaskan cara mereset komponen Apigee hybrid saat komponen tersebut macet dalam status creating atau releasing.
|
Khusus Apigee hybrid |
| Lainnya | Segera menghapus organisasi Apigee atau Apigee hybrid |
Dokumen ini menguraikan cara segera menghapus organisasi Apigee atau
Apigee hybrid tanpa retensi menggunakan
opsi NO_RETENTION.
|
Apigee dan Apigee hybrid |
| Penginstalan dan upgrade Apigee Hybrid | Pod Cassandra dalam Status CrashLoopBackOff | Pod Cassandra terjebak dalam status CrashLoopBackOff setelah penginstalan atau upgrade. | Khusus Apigee hybrid |
| Penginstalan dan upgrade Apigee Hybrid | Pod Apigee Metrics dalam status CrashLoopBackOff | Pod Metrik Apigee tetap dalam status CrashLoopBackOff setelah penginstalan atau upgrade. | Khusus Apigee Hybrid |
| Penginstalan dan upgrade Apigee Hybrid | Pod gateway masuk Apigee menampilkan 1 dari 2 container yang berjalan |
Pod apigee-ingressgateway Anda hanya menampilkan 1 dari 2 container yang berjalan saat Anda mendapatkan listingan pod. |
Khusus Apigee Hybrid |
| Penginstalan dan upgrade Apigee hybrid | Error pod UDCA | Pod UDCA dan Connect Agent menampilkan error masalah izin. | Khusus Apigee Hybrid |
| Penginstalan dan upgrade Apigee hybrid | Reset koneksi selama TLS handshake untuk klien non-SNI | Reset koneksi diamati selama TLS handshake untuk klien non-SNI. | Khusus Apigee Hybrid |
| Penginstalan dan upgrade Apigee Hybrid | Kapasitas Disk Tidak Mencukupi di Cassandra | Proses penginstalan Apigee hybrid gagal karena kapasitas disk tidak cukup untuk database Cassandra. | Khusus Apigee Hybrid |
| Penginstalan dan upgrade Apigee hybrid | CPU tidak memadai |
Saat menggunakan kubectl untuk melihat status pod, Anda akan melihat satu atau beberapa pod dalam status CrashLoopBackoff atau FailedScheduling. |
Khusus Apigee hybrid |