Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Tidak ada padanan
Dokumentasi Apigee Edge untuk topik ini.
Topik ini membahas langkah-langkah yang dapat Anda ambil untuk memecahkan dan memperbaiki masalah dengan
pemroses pesan. Pesan
adalah bagian dari
Komponen apigee-runtime
. Lihat juga
Ringkasan konfigurasi layanan runtime.
Pemeriksaan kesiapan gagal dengan status HTTP kode 500
Gejala
Satu atau beberapa pod apigee-runtime
tidak dalam status Siap.
Pesan error
Ketika menggunakan kubectl
untuk mendeskripsikan pod apigee-runtime
yang gagal, Anda akan melihat
{i>error<i}:
Readiness probe failed: HTTP probe failed with statuscode: 500
Contoh:
kubectl describe pod -n hybrid \ apigee-runtime-apigee-gcp-prod1-test-blue-67db4f457b-9c7c7 ... apigee-runtime-apigee-gcp-prod1-test-blue-67db4f457b-9c7c7 Readiness probe failed: HTTP probe failed with statuscode: 500 ...
Kemungkinan penyebab
Error ini menunjukkan bahwa tidak ada kontrak aktif yang tersedia bagi pemroses pesan untuk menyalurkan kemacetan. Dalam status ini, pemroses pesan tidak dapat menyebut dirinya "siap".
Penyebab | Deskripsi |
---|---|
Masalah koneksi bidang pengelolaan yang disinkronkan | Sinkronisasi tidak dapat terhubung ke bidang pengelolaan. Masalah ini biasanya
terjadi saat Anda mengganti URL contractProvider dan mengaitkan
akun layanan yang salah. Misalnya, jika Anda mengonfigurasi akun layanan untuk deployment staging dengan
URL contractProvider yang mengarah ke server produksi.
|
Masalah koneksi prosesor pesan ke sinkronisasi | Jika MP baru muncul sebagai bagian dari penskalaan otomatis atau pod dimulai ulang, Anda mungkin melihat error ini. Umumnya, masalah ini terjadi ketika sinkronisasi mati dan MP tidak dapat memuat kontrak-nya. |
Diagnosis: Menyinkronkan ke pengelolaan masalah koneksi pesawat
Untuk mendiagnosis masalah sinkronisasi ke bidang pengelolaan, lakukan hal berikut:
- Lihat daftar pod di cluster:
kubectl get pods -n namespace
- Buka shell dalam pod
apigee-synchronizer
:kubectl exec -it -n namespace synchronizer-pod-name -- bash
Contoh:
kubectl exec -it -n apigee apigee-synchronizer-apigee-gcp-prod1-test-blue-cnj5x -- bash
- Buka direktori berikut:
cd /opt/apigee/var/log/apigee-synchronizer
ls
dr-xr-sr-x 4 apigee apigee 4096 Sep 12 16:52 750 drwxr-sr-x 2 apigee apigee 4096 Sep 12 16:52 cachedFiles -rw-r--r-- 1 apigee apigee 22295 Sep 12 16:52 config.log -rw-r--r-- 1 apigee apigee 76 Sep 12 16:52 versions.properties - Periksa versi aktif di
version.properties
. Contoh:cat versions.properties #active repository version #Sat Dec 14 19:45:00 GMT 2019 active.version=749
- Pastikan nilai
active.version
cocok dengan nama folder kontrak angka Dalam contoh di atas (juga ditampilkan di bawah), nama folder adalah750
; Oleh karena itu, kecocokan:dr-xr-sr-x 4 apigee apigee 4096 Sep 12 16:52 750
- Keluar dari shell pod.
Resolusi
Jika version.properties
tidak ada, atau jika ada ketidakcocokan versi seperti yang dijelaskan
di atas, periksa log sinkronisasi untuk mencoba menentukan penyebab
sebagian besar kontrak saat ini
tidak didownload. Contoh:
kubectl logs -f -n namespace synchronizer-pod-name
Untuk mengetahui informasi tentang cara menafsirkan log sinkronisasi, lihat syncr logs.
Jika sinkronisasi tidak aktif, coba mulai ulang menggunakan apigeectl
. Contoh:
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml --org --env env-name
Diagnosis: Masalah koneksi pemroses pesan ke sinkronisasi
Untuk mendiagnosis masalah koneksi pemroses pesan ke sinkronisasi, lakukan langkah berikut:
- Lihat daftar pod di cluster:
kubectl get pods -n namespace
- Periksa log runtime untuk mencoba mencari tahu penyebab kontrak
tidak sedang diunduh:
kubectl logs -f -n namespace pod-name
Contoh:
kubectl logs -f -n apigee apigee-runtime-apigee-gcp-prod1-test-blue-67db4f457b-9c7c7
Dimungkinkan jika MP baru muncul sebagai bagian dari autoscale atau pod restart, MP mungkin tidak memuat kontrak. Umumnya, masalah terjadi ketika sedang nonaktif, sehingga MP tidak dapat memuat kontrak. Contoh:
2019-09-13 16:59:24,331 podName:N/A ipAddress:N/A dpColor:N/A HttpClient@331886186-301 DEBUG o.e.j.c.AbstractConnectionPool - AbstractConnectionPool$1.failed() : Connection 1/64 creation failed java.net.UnknownHostException: apigee-synchronizer-apigee-gcp-prod1-test.hybrid.svc.cluster.local at java.net.InetAddress.getAllByName0(InetAddress.java:1281) at java.net.InetAddress.getAllByName(InetAddress.java:1193) at java.net.InetAddress.getAllByName(InetAddress.java:1127) at org.eclipse.jetty.util.SocketAddressResolver$Async.lambda$resolve$1(SocketAddressResolver.java:167) at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:672) at org.eclipse.jetty.util.thread.QueuedThreadPool$2.run(QueuedThreadPool.java:590) at java.lang.Thread.run(Thread.java:748) at org.eclipse.jetty.util.thread.QueuedThreadPool$2.run(QueuedThreadPool.java:590) at java.lang.Thread.run(Thread.java:748)
Resolusi
Coba mulai ulang sinkronisasi. Contoh:
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml --org --env env-name
Pemeriksaan kesiapan gagal untuk kunci enkripsi yang tidak valid
Gejala
Pod apigee-runtime
tidak dalam status Siap.
Diagnosis
Ketika menggunakan kubectl
untuk mendeskripsikan pod apigee-runtime
yang gagal, Anda akan melihat
error ini: Readiness probe failed: Probe hybrid-encryption-key-validation-probe failed
.
Contoh:
$ kubectl describe pod -n namespace apigee-runtime-pod-name ... Readiness probe failed: Probe hybrid-encryption-key-validation-probe failed due to com.apigee.probe.model.ProbeFailedException{ code = hybrid.encryption.key.InvalidEncryptionKey, message = Invalid encryption key. Please check the length of the encryption key, associated contexts = []} ...
Resolusi
Panjang kunci enkripsi yang didukung adalah 16 atau 24 atau 32 byte dan nilai kunci harus yang dienkode dengan base64. Untuk informasi selengkapnya tentang cara membuat kunci dengan format yang benar, lihat Enkripsi data.
Melihat log pemroses pesan
Untuk mengetahui detail tentang cara melihat dan menafsirkan log pemroses pesan, lihat Log runtime.
Memanggil proxy API dari pod runtime
Dalam beberapa situasi untuk membantu mengisolasi masalah, Anda mungkin ingin memeriksa apakah Anda dapat membuat panggilan proxy API secara langsung dari
di dalam pod apigee-runtime
, sehingga mengabaikan gateway masuk.
- Jalankan perintah berikut untuk meneruskan ke port 8443. Hal ini memungkinkan Anda memanggil API dalam pod:
kubectl port-forward -n namespace apigee-runtime-pod-name 8443:8443
- Memanggil proxy API yang di-deploy. Misalnya, dengan basepath proxy adalah
ilove-apis
:curl -k -v https://0:8443//ilove-apis < HTTP/1.1 200 OK < X-Powered-By: Apigee < Access-Control-Allow-Origin: * < X-Frame-Options: ALLOW-FROM RESOURCE-URL < X-XSS-Protection: 1 < X-Content-Type-Options: nosniff < Content-Type: text/html; charset=utf-8 < Content-Length: 18 < ETag: W/"12-Jb9QP1bUxNSmZkxQGt5KLQ" < Date: Fri, 13 Sep 2019 18:33:46 GMT < Via: 1.1 google < X-Apigee.Message-ID: 016f5f7f-c59e-404c-86e8-7b0737833f982 < X-Apigee.dp.color: blue < X-Apigee.proxy: /organizations/my-org/environments/test/apiproxies/i-loveapis/revisions/1 < X-Apigee.proxy.basepath: /ilove-apis < X-Apigee.target-latency: 9 < * Connection #0 to host 0 left intact <H2>I <3 APIs
Memeriksa API pengelolaan
Anda dapat menggunakan API yang dijelaskan di bawah untuk memeriksa apakah API pengelolaan berfungsi dengan benar.
- Dapatkan nama pod di cluster Anda:
kubectl get pods -n namespace
- Menggunakan penerusan port
untuk mendapatkan akses pod
apigee-runtime
. Sintaksis untuk penerusan port adalah sebagai berikut:kubectl port-forward -n namespace podname 8843:8843
Contoh:
kubectl port-forward -n apigee \ apigee-runtime-my-organization-test-blue-57965b7789-6j4bp 8843:8843
- Kemudian, di jendela terminal lain, gunakan utilitas seperti
curl
untuk mengirim permintaan keclassification/tree
API, seperti yang ditampilkan dalam contoh berikut:curl -k https://0:8843/v1/classification/tree
Berikut adalah contoh respons, yang mencantumkan informasi tentang proxy yang di-deploy dalam "uji coba" lingkungan:
[ { "condition" : "(always matches)", "virtualHost" : { "env" : "test", "name" : "default", "org" : "my-organization", "tree" : { "elements" : [ { "application" : "myproxy", "basePath" : "/myproxy", "name" : "default", "revision" : "1" } ], "name" : "IdentificationTree" } } } ]
Menggunakan mode DEBUG
Untuk membantu pemecahan masalah, Anda dapat mengaktifkan mode DEBUG untuk menyertakan informasi yang lebih mendetail
dalam apigee-runtime
log pod.
- Cantumkan pod di namespace Anda:
kubectl get pods -n namespace
- Pilih salah satu pod
apigee-runtime
yang tercantum untuk di-debug. - Jalankan perintah penerusan port untuk pod tersebut. Contoh:
kubectl port-forward -n hybrid apigee-runtime-hybrid-prod-blue-fcpdd 8843
- Buka terminal lain dan panggil API berikut untuk mengaktifkan proses debug:
curl "https://0:8843/v1/logsessions?sessions=debug" -X POST -v -k
- Jalankan perintah
kubectl logs
untuk memeriksa log yang berada dalam Mode DEBUG. Sebagai contoh:kubectl logs -f -n hybrid apigee-runtime-hybrid-prod-blue-fcpdd
- Setelah selesai memeriksa log DEBUG, reset tingkat log ke INFO (default). Contoh:
curl "https://0:8843/v1/logsessions?sessions=info" -X POST -v -k
- Jalankan perintah
kubectl logs
untuk memastikan log kembali dalam mode INFO.