Anda sedang melihat dokumentasi Apigee dan Apigee Hybrid.
Lihat
dokumentasi Apigee Edge.
Tindakan pemecahan masalah adalah seni dan sains. Upaya konstan tim dukungan teknis Apigee adalah mengungkap seni dan mengungkap sains di balik identifikasi dan penyelesaian masalah.
Apa itu playbook?
Dikembangkan melalui kerja sama dengan tim Dukungan Teknis Apigee, playbook pemecahan masalah Apigee dirancang untuk memberikan solusi yang cepat dan efektif untuk mengatasi error atau masalah lain yang mungkin Anda alami saat menangani produk Apigee.
Audiens
Playbook pemecahan masalah ditujukan bagi pembaca yang memiliki pemahaman tingkat tinggi tentang Apigee dan arsitekturnya, serta pemahaman konsep dasar seperti kebijakan dan analisis.
Beberapa masalah hanya dapat didiagnosis dan diselesaikan oleh pengguna hybrid Apigee dan mungkin memerlukan pengetahuan tentang komponen internal seperti datastore Cassandra dan Postgres, Pemroses Pesan, serta Router.
Jika Anda menggunakan Apigee, kami dengan jelas menentukan kapan Anda dapat melakukan langkah-langkah pemecahan masalah yang ditunjukkan dan kapan Anda perlu menghubungi Dukungan Apigee untuk mendapatkan bantuan.
Playbook
Bagian ini menjelaskan playbook saat ini.
Untuk memfilter tabel ini, lakukan satu atau beberapa tindakan berikut: pilih kategori, pilih produk, ketik istilah penelusuran, atau klik judul kolom untuk mengurutkan.
| Kategori | Playbook/Deskripsi masalah | Pesan error | Playbook berlaku untuk |
|---|---|---|---|
| Cassandra | Memecahkan masalah pemulihan Cassandra | Selama pemulihan Cassandra pada Apigee Hybrid, Anda mungkin mengalami error dalam log pemulihan. | Khusus Apigee Hybrid |
| Penyampaian masalah otomatis | Tidak ada konektivitas jaringan antara bidang runtime dan bidang kontrol | Permintaan pengelolaan API Apigee gagal:
|
Khusus Apigee Hybrid |
| Penyampaian 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 |
| Penyampaian masalah otomatis | Host virtual tidak memiliki pemilih | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_VIRTUALHOST_MISSING_SELECTOR akan ditampilkan.
|
Khusus Apigee Hybrid |
| Penyampaian masalah otomatis | Ketidakcocokan sertifikat masuk | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_CERT_MISMATCH akan ditampilkan.
|
Khusus Apigee Hybrid |
| Penyampaian masalah otomatis | Masa berlaku sertifikat masuk | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_CERT_EXPIREY akan ditampilkan.
|
Khusus Apigee Hybrid |
| Penyampaian masalah otomatis | Masa berlaku sertifikat CA mTLS masuk | Setelah menjalankan kubectl -n apigee get apigeeissues, error AIS_INGRESS_MTLS_CA_CERT_EXPIREY akan ditampilkan.
|
Khusus Apigee Hybrid |
| Penyampaian masalah otomatis | Sertifikat CA mTLS masuk 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 | Pod Cassandra tidak dimulai di region sekunder |
Pod Cassandra gagal dimulai di salah satu region dalam penyiapan Hybrid multi-region.
Anda mungkin melihat pesan error node already exists di log pod Cassandra, atau peringatan FailedPreStopHook dalam 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 resolusi untuk masalah pada datastore Cassandra.
|
Khusus Apigee Hybrid |
| Deployment | Deployment proxy API gagal tanpa peringatan pod runtime aktif | Peringatan No active runtime pods ditampilkan dalam dialog Detail di sebelah pesan error Masalah deployment di ENVIRONMENT: REVISION_NUMBER di halaman proxy API. | Khusus Apigee Hybrid |
| Jalan Masuk | Panggilan API gagal dengan error waktu tunggu |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Khusus Apigee Hybrid |
| Jalan Masuk | 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 yang tidak konsisten/tidak ada yang diamati untuk entity di UI hybrid atau melalui Management API | Tidak ada pesan error yang diketahui ditampilkan dalam skenario ini. | Khusus Apigee Hybrid |
| Konfigurasi jaringan | Mengakses masalah pemilihan rute dengan Apigee |
Klien eksternal tidak dapat mengakses/terhubung ke Apigee dengan cara yang diinginkan. Hal ini termasuk kegagalan konektivitas jaringan (gagal handshake TLS) atau respons 4xx/5xx dari Apigee.
|
Apigee dan Apigee Hybrid |
| Konfigurasi jaringan | Masalah konektivitas Apigee dengan target PSC arah selatan |
Masalah koneksi jaringan atau waktu tunggu TCP antara Apigee dan layanan target akan muncul sebagai respons error 503 dan akan menampilkan error seperti di bawah ini 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 |
| Other | Memperluas jumlah replika properti Istio saat mengosongkan node | Saat menghabiskan pod Istio, beberapa node mungkin tidak dikosongkan karena memiliki jumlah replika 1, sementara 3 replika atau lebih diperlukan. Untuk menghindari hal ini, Anda harus menetapkan jumlah replika minimum untuk setiap properti ke minimal 3. | Khusus Apigee Hybrid |
| Other | Panduan pemecahan masalah pemroses pesan |
Satu atau beberapa pod runtime apigee tidak berada 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 |
| Other | 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 |
| Other | Error StreamingPull 100% |
Jika Anda melihat di dasbor metrik bahwa metode google.pubsub.vl.Subscriber.StreamingPull gagal dengan error 100%, Anda dapat mengabaikan masalah tersebut dengan aman. Ini adalah perilaku
yang diharapkan.
|
Khusus Apigee Hybrid |
| Deployment | Instance tidak melaporkan status untuk grup lingkungan | Deployment proxy API gagal dengan Instance INSTANCE_NAME tidak melaporkan status error ENV_GROUP_NAME grup lingkungan pada UI hybrid Apigee. | Khusus Apigee Hybrid |
| Deployment | Deployment proxy API gagal dengan apigee-serving-cert tidak ditemukan atau sudah tidak berlaku |
Deployment proxy API gagal dengan pesan error di log apigee-watcher.
|
Khusus Apigee Hybrid |
| Jalan Masuk | Memperluas jumlah replika properti Istio untuk menghindari masalah saat menghabiskan node Istio |
Saat menghabiskan pod Istio, beberapa node mungkin tidak dikosongkan karena memiliki
jumlah replika 1, sementara 3 atau lebih replika
diperlukan. Untuk menghindari hal ini, Anda harus menetapkan jumlah replika minimum
untuk setiap properti ke minimal 3.
|
Khusus Apigee Hybrid |
| Konfigurasi jaringan | Tidak ada pemecahan masalah ruang alamat IP gratis | Selama penyediaan Apigee, jika memilih rentang CIDR jaringan yang tidak sepenuhnya gratis, Anda mungkin melihat pesan error. | Apigee dan Apigee Hybrid |
| Konfigurasi jaringan | Error Peering VPC 503 Layanan Tidak Tersedia dengan TARGET_CONNECT_TIMEOUT | Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki error "503 Service Tidak Tersedia" dengan TARGET_CONNECT_TIMEOUT saat menggunakan peering VPC. | Apigee |
| Konfigurasi jaringan | Waktu tunggu Gateway 504 - Waktu tunggu baca target habis | Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki error "504 Gateway Timeout" dengan alasan TARGET_READ_TIMEOUT. | Apigee dan Apigee Hybrid |
| Other | Memecahkan masalah Apigee Hybrid yang macet saat membuat atau merilis status |
Dokumen ini menjelaskan cara mereset komponen hybrid Apigee saat komponen tersebut terjebak dalam status creating atau releasing.
|
Khusus Apigee Hybrid |