Pengantar playbook hybrid Apigee dan Apigee

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Lihat Dokumentasi Apigee Edge.

Tindakan pemecahan masalah adalah seni dan sains. Upaya yang konstan tim dukungan teknis Apigee adalah untuk menjelaskan suatu seni dan mengekspos ilmu di balik identifikasi dan penyelesaian masalah.

Apa yang dimaksud dengan playbook?

Dikembangkan melalui kolaborasi dengan tim Dukungan Teknis Apigee, Apigee playbook pemecahan masalah dirancang untuk memberikan solusi untuk kesalahan atau masalah lain yang mungkin Anda temui saat bekerja dengan Produk Apigee.

Audiens

Playbook pemecahan masalah ditujukan bagi pembaca yang memiliki pemahaman memahami Apigee dan arsitekturnya, serta beberapa konsep dasar seperti kebijakan dan analitik.

Beberapa masalah hanya dapat didiagnosis dan diselesaikan oleh pengguna hybrid Apigee dan mungkin memerlukan pengetahuan tentang komponen internal seperti Cassandra dan Postgres datastore, Message Processors, dan Router.

Jika Anda menggunakan Apigee, kami dengan jelas menentukan kapan Anda dapat melakukan menunjukkan langkah-langkah pemecahan masalah dan kapan Anda perlu menghubungi Google Cloud Customer Care 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 Memecahkan masalah pemulihan Cassandra Selama pemulihan Cassandra di Apigee Hybrid, Anda mungkin mengalami yang terjadi di log pemulihan. Khusus Apigee Hybrid
Masalah otomatis muncul Tidak ada konektivitas jaringan antara bidang runtime dan bidang kontrol

Permintaan pengelolaan API Apigee gagal:

  • Produk API, Developer, Aplikasi tidak diisi di UI Apigee.
  • Deployment proxy API tidak selesai.
  • Permintaan pengelolaan API Apigee gagal.
Khusus Apigee Hybrid
Masalah otomatis muncul Grup lingkungan tidak ditemukan di host virtual Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_VIRTUALHOST_MISSING_ENVGROUP ditampilkan. Khusus Apigee Hybrid
Masalah otomatis muncul Tidak ada pemilih di host virtual Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_VIRTUALHOST_MISSING_SELECTOR ditampilkan. Khusus Apigee Hybrid
Masalah otomatis muncul Sertifikat masuk tidak cocok Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_INGRESS_CERT_MISMATCH ditampilkan. Khusus Apigee Hybrid
Masalah otomatis muncul Masa berlaku sertifikat masuk Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_INGRESS_CERT_EXPIREY ditampilkan. Khusus Apigee Hybrid
Masalah otomatis muncul Masa berlaku sertifikat CA mTLS masuk Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_INGRESS_MTLS_CA_CERT_EXPIREY ditampilkan. Khusus Apigee Hybrid
Masalah otomatis muncul Sertifikat CA mTLS masuk tidak valid Setelah menjalankan kubectl -n apigee get apigeeissues, Error AIS_INGRESS_MTLS_CA_CERT_INVALID ditampilkan. Khusus Apigee Hybrid
Cassandra Kegagalan replikasi data Cassandra Saat mereplikasi data selama perluasan multi-region, Status CassandraDataReplication mungkin menunjukkan status dan data error replikasi mungkin akan gagal. Khusus Apigee Hybrid
Cassandra Masalah ruang heap Java Cassandra Masalah heap Cassandra dapat menyebabkan kelambatan pada proxy hybrid Apigee atau bahkan error Datastore. Terkadang log merupakan titik awal indikator, bahkan sebelum timbulnya gejala. 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 dengan {i>datastore Cassandra<i}. Khusus Apigee Hybrid
Deployment Deployment proxy API gagal tanpa peringatan pod runtime yang aktif Peringatan Tidak ada pod runtime yang aktif ditampilkan di Detail dialog di samping pesan error Masalah deployment pada 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 karena 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 hilang di Cloud Logging Tidak ada pesan error yang 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 ditampilkan dalam skenario ini. Khusus Apigee Hybrid
Konfigurasi jaringan Masalah pemilihan rute akses dengan Apigee Klien eksternal tidak dapat mengakses/terhubung ke Apigee di cara yang diinginkan. Termasuk di antaranya kegagalan konektivitas jaringan (TLS handshake gagal) atau respons 4xx/5xx dari Apigee. Apigee dan Apigee Hybrid
Konfigurasi jaringan Masalah konektivitas Apigee dengan target PSC menuju selatan Masalah koneksi jaringan atau waktu tunggu TCP antara Apigee dan layanan target akan muncul sebagai respons error 503 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
Lainnya Memperluas jumlah replika properti Istio saat mengosongkan node Saat menghabiskan pod Istio, beberapa node mungkin tidak terkuras karena memiliki jumlah replika 1, sedangkan diperlukan 3 replika atau lebih. Untuk Untuk menghindarinya, Anda harus menetapkan jumlah replika minimum untuk setiap properti menjadi setidaknya 3. Khusus Apigee Hybrid
Lainnya Panduan pemecahan masalah pemroses pesan Satu atau beberapa pod apigee-runtime tidak berada dalam status Ready. Saat Anda menggunakan kubectl untuk mendeskripsikan error pod apigee-runtime, Anda akan melihat error:
Readiness probe failed: HTTP probe failed with statuscode: 500
Khusus Apigee Hybrid
Lainnya Cetak info build buildinfo API menampilkan informasi tentang untuk sebuah 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 ini google.pubsub.vl.Subscriber.StreamingPull gagal dengan 100% error, Anda dapat mengabaikannya dengan aman. Diharapkan perilaku model. Khusus Apigee Hybrid
Deployment Instance tidak melaporkan status untuk grup lingkungan Deployment proxy API gagal dengan Instance INSTANCE_NAME tidak melaporkan status untuk grup lingkungan ENV_GROUP_NAME error 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 apigee-watcher log. Khusus Apigee Hybrid
Jalan Masuk Memperluas jumlah replika properti Istio untuk menghindari masalah saat pengosongan Node Istio Saat menghabiskan pod Istio, beberapa node mungkin tidak terkuras karena memiliki jumlah replika 1, sedangkan 3 atau lebih replika tidak diperlukan. Untuk menghindari hal ini, Anda harus menetapkan jumlah replika minimum untuk setiap properti hingga minimal 3. Khusus Apigee Hybrid
Konfigurasi jaringan Tidak ada pemecahan masalah ruang alamat IP gratis Selama penyediaan Apigee, jika Anda memilih rentang CIDR jaringan yang tidak sepenuhnya gratis, Anda akan melihat pesan {i>error<i}. Apigee dan Apigee Hybrid
Konfigurasi jaringan Error Layanan Peering VPC 503 Tidak Tersedia dengan TARGET_CONNECT_TIMEOUT Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki "Layanan 503 Tidak Tersedia" {i>error <i}dengan TARGET_CONNECT_TIMEOUT saat menggunakan peering VPC. Apigee
Konfigurasi jaringan Waktu tunggu Gateway 504 - Waktu tunggu baca target Dokumen ini menjelaskan cara mendiagnosis dan memperbaiki "504 Gateway Timeout" {i>error <i}dengan alasan TARGET_READ_TIMEOUT. Apigee dan Apigee Hybrid
Lainnya Memecahkan masalah Apigee Hybrid yang terhenti dalam membuat atau merilis status Dokumen ini menjelaskan cara mereset komponen hybrid Apigee saat peristiwa tertahan di creating atau releasing status. Khusus Apigee Hybrid