Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Gateway Buruk 502

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Gejala

Aplikasi klien mendapatkan kode status HTTP 502 dengan pesan "Bad Gateway" sebagai respons untuk panggilan API.

Kode status HTTP 502 berarti klien tidak menerima respons yang valid dari server backend yang seharusnya memenuhi permintaan.

Pesan Error

Aplikasi klien mendapatkan kode respons berikut:

HTTP/1.1 502 Bad Gateway

Selain itu, Anda mungkin melihat pesan error berikut:

<html>
<head>
<title>Error</title>
<style>
body {
width: 35em;
margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif;
}
</style>
</head>
<body>
<h1>An error occurred.</h1>
<p>Sorry, the page you are looking for is currently unavailable.<br/>
Please try again later.</p>
</body>
</html>

Jika error berasal dari server backend, Anda mungkin melihat sesuatu seperti ini. Pesan error dari backend sepenuhnya bergantung pada implementasinya.

<html>
<head><title>502 Bad Gateway</title></head>
<body bgcolor="white">
<center><h1>502 Bad Gateway</h1></center>
</body>
</html>

Kemungkinan Penyebab

Berikut beberapa kemungkinan penyebab yang dapat menyebabkan error 502 Bad Gateway untuk API yang melalui Apigee Edge:

Cause	Deskripsi	Petunjuk Pemecahan Masalah yang Berlaku Untuk
Tidak ada MP yang tersedia di kumpulan	Error ini terjadi jika semua MP dalam kumpulan tidak tersedia, yaitu, tidak aktif atau sibuk sehingga tidak merespons.	Pengguna Edge Private Cloud
Konfigurasi SSL yang salah antara Router dan MP	Error ini terjadi jika sertifikat root yang ditandatangani CA klien tidak ada di truststore Router Edge.	Pengguna Edge Private Cloud
Error dari server backend	Error ini akan diamati jika server backend gagal dan mengirim respons ini.	Pengguna Edge Public dan Private Cloud

Penyebab: Tidak ada MP yang tersedia di kumpulan

Error ini akan terjadi jika Router menemukan bahwa semua Pemroses Pesan di wilayah/pusat data tertentu tidak tersedia (misalnya, jika semuanya tidak berfungsi).

Apigee Edge dikonfigurasi sedemikian rupa sehingga traffic API (permintaan) masuk di region/pusat data tertentu selalu dirutekan dari Router ke Pemroses Pesan (MP) di region/pusat data yang sama. Dalam beberapa kasus, komponen Apigee Edge dapat disiapkan hanya di satu region/pusat data dan dalam beberapa kasus, komponen tersebut dapat disiapkan di lebih dari satu region/pusat data. Di setiap region/pusat data, akan ada dua Router dan Pemroses Pesan atau lebih yang dikonfigurasi.

Diagnosis

Tentukan region/pusat data tempat permintaan API gagal dengan error 502 Bad Gateway, jika ada lebih dari satu region/pusat data. Anda dapat menemukannya dengan mengidentifikasi region tempat pengguna mengalami error 502 atau dengan memeriksa log Akses NGINX di direktori /opt/apigee/var/log/edge-router/nginx/ pada setiap Router yang termasuk dalam region yang berbeda.

Anda akan melihat error berikut di log Error NGINX (/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log)

2019/06/24 15:26:00 [error] 4796#4796: *56357443 no live upstreams while connecting to upstream, client: <Router_IP_address>, server: <HostAlias>, request: "PUT <BasePath> HTTP/1.1", upstream: "http://<ListOfMP-IP_R-MP-Port>/<BasePath>", host: "<HostAlias>"

Skenario 1: Semua Pemroses Pesan tidak berfungsi

Periksa apakah Pemroses Pesan di region/pusat data tertentu sudah aktif dan berjalan.
Jika semua Pemroses Pesan tidak berfungsi, mulai ulang.

Resolusi

Mulai ulang semua Pemroses Pesan menggunakan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Skenario 2: Semua Pemroses Pesan sedang sibuk memproses permintaan yang sedang berlangsung

Error ini akan terjadi jika Router menemukan bahwa semua Pemroses Pesan di wilayah/pusat data tertentu tidak tersedia karena semuanya sedang memproses permintaan yang sedang berlangsung.

Periksa apakah Pemroses Pesan di region/pusat data tertentu sudah aktif dan berjalan.
Jika semua Pemroses Pesan aktif dan berfungsi, periksa apakah Pemroses Pesan mengalami penggunaan CPU yang tinggi, lalu buat tiga dump thread setiap 30 detik menggunakan perintah berikut:
```
<JAVA_HOME>/bin/jstack -l <pid> > <filename>
```
Jika Message Processor mengalami penggunaan memori yang tinggi, buat heap dump menggunakan perintah berikut:
```
sudo -u apigee /bin/jmap -dump:live,format=b,file= 
```
Mulai ulang Message Processor menggunakan perintah di bawah. Tindakan ini akan menurunkan CPU dan Memori:
```
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
```
Pantau panggilan API untuk mengonfirmasi apakah masalah masih ada.
Hubungi Dukungan Apigee dan berikan thread dump, heap dump, dan log Message Processor (/opt/apigee/var/log/edge-message-processor/logs/system.log) untuk membantu menyelidiki penyebab penggunaan CPU/memori yang tinggi.

Penyebab: Konfigurasi SSL yang salah antara Router dan MP

Diagnosis

Periksa log Akses NGINX (/opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log). Anda akan melihat respons 502 seperti yang ditunjukkan di bawah ini:

    2019-07-23T12:13:42+03:00	sc-10-254-226-23	10.X.X.X:53634	10.X.X.X:8998	0.000	-	-	502	502	189	344	GET <path> curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.27.1 zlib/1.2.3 libidn/1.18 libssh2/1.4.2	<host alias>	mp-10-254-226-23-23706-8552529-1	10.129.107.101	-	-	-1	-	-	dc-2	gateway-2	green	-	gateway-2	dc-2	op	pilot	http	-

Periksa log Error NGINX (/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log). Anda akan melihat error seperti ini:

	2019/07/30 17:02:24 [error] 7691#7691: *11753633 peer closed connection in SSL handshake while SSL handshaking to upstream, client: X.X.X.X, server: <HostAlias>, request: "GET /no-target HTTP/1.1", upstream: "https://X.X.X.X:8998/no-target", host: "<HostAlias>"

Hal ini menunjukkan bahwa handshake SSL gagal antara Router dan Message Processor.
Jika Anda memperhatikan dengan cermat pesan error di langkah #1 dan #2, nomor port yang digunakan untuk berkomunikasi dengan Message Processor adalah 8998 yang merupakan port tidak aman, tetapi protokolnya adalah SSL (https). Biasanya, port # aman yang digunakan adalah 8443. Karena port yang tidak aman digunakan untuk komunikasi yang aman, hal ini menyebabkan kegagalan handshake SSL.
Biasanya, hal ini dapat terjadi jika Anda melewatkan langkah-langkah atau menetapkan nilai yang salah saat mengonfigurasi SSL antara Router dan Message Processor. Lihat langkah-langkah yang diuraikan di sini.
Misalnya, error ini dapat terjadi jika
1. Nomor port ditentukan sebagai 8998, bukan 8443 di /opt/apigee/customer/application/message-processor.properties as shown below
```
        conf/message-processor-communication.properties+local.http.port=8998
```
2. File konfigurasi Router di direktori /opt/nginx/conf.d/* tidak dihapus dan Router belum dimulai ulang saat melakukan konfigurasi SSL. Dalam skenario ini, Anda dapat melihat bahwa port# Message Processor akan tetap 8998 dalam file konfigurasi.

Resolusi

Pastikan semua langkah yang diberikan dalam Mengonfigurasi TLS antara Router dan Message Processor diikuti dengan benar.
Jika masalah berlanjut, buka Mengumpulkan Informasi Diagnostik.

Penyebab: Error dari server backend

Diagnosis

Jika error terjadi setiap saat, Anda dapat merekam rekaman aktivitas UI untuk permintaan yang gagal. Pilih permintaan yang gagal dan jelajahi berbagai fase dalam rekaman aktivitas. Jika Anda melihat bahwa Anda mendapatkan “502 Bad Gateway” dari server backend itu sendiri, maka masalahnya mungkin karena beberapa kegagalan telah terjadi di server backend.
Trace yang menampilkan 502 Bad Gateway yang berasal dari server backend
Jika masalah terjadi sesekali dan Anda tidak dapat merekam aktivitas,
1. Jika Anda adalah pengguna Public Cloud, Anda dapat menggunakan API Monitoring dan memeriksa detail tentang error 502.
  1. Jika Anda melihat Kode Kesalahan adalah messaging.adaptors.http.flow.ErrorResponseCode dan Sumber Kesalahan adalah target, maka error disebabkan oleh server backend.
2. Jika Anda adalah pengguna Private Cloud, Anda dapat menganalisis log Akses NGINX
  /opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log.
  Anda akan melihat entri untuk permintaan yang gagal sebagai berikut:
```
2017-02-24T14:42:12+00:00	rt-01	192.8.155.2:18118	192.168.84.166:8998	10.225	-	-	502	502	440	0	GET /adv-eadlg-test/documents?type=doctype HTTP/1.1	rt-02efawae234-1234	Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36	myorg-dev.apigee.net	 rt-02efawae234-1234	6	-	false	target	messaging.adaptors.http.flow.ErrorResponseCode	null/null	-	/organizations/myorg/environments/dev/apiproxies/api123
```
  1. Jika Anda melihat Kode Kesalahan adalah messaging.adaptors.http.flow.ErrorResponseCode dan Sumber Kesalahan adalah target, maka error disebabkan oleh server backend.

Resolusi

Hubungi tim server backend Anda untuk memperbaiki masalah ini di backend.

Mengumpulkan Informasi Diagnostik

Log Akses NGINX
(/opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log)
dan Log error
(/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log).
Log Message Processor
(/opt/apigee/var/log/edge-message-processor/logs/system.log).