Layanan 503 Tidak Tersedia - NoActiveTargets

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

Video

Lihat video berikut untuk informasi selengkapnya tentang error 503:

Gejala

Aplikasi klien menerima kode status respons HTTP 503 dengan pesan Service Available (Layanan Tidak Tersedia) dan kode error NoActiveTargets untuk permintaan proxy API.

Pesan error

Anda akan melihat respons error berikut:

HTTP/1.1 503 Service Unavailable
  

Anda akan melihat pesan error berikut dalam respons HTTP:

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

Kemungkinan penyebab

Respons HTTP 503 Layanan Tidak Tersedia dengan kode error NoActiveTargets biasanya diamati saat Anda menggunakan satu atau beberapa server target di konfigurasi endpoint target di Proxy API Anda.

Tabel berikut mencantumkan kemungkinan penyebab respons Layanan 503 Tidak Tersedia dengan kode error NoActiveTargets:

Penyebab: Server target dinonaktifkan

Jika semua server target yang ditentukan dalam konfigurasi endpoint target dinonaktifkan, Anda mendapatkan respons 503 Service Tidak Tersedia dengan kode error NoActiveTargets.

Diagnosis

1. Menentukan nama server target yang digunakan di Endpoint Target tertentu Konfigurasi Proxy API yang gagal menggunakan salah satu cara berikut:
1. Jika ada satu endpoint target, periksa endpoint target tersebut.
2. Jika ada beberapa endpoint target dan tidak yakin endpoint target mana yang telah menonaktifkan server target, ikuti langkah-langkah berikut:
1. Aktifkan sesi rekaman aktivitas, lakukan panggilan API, dan rekonstruksi masalah - 503 Service Tidak Tersedia.
2. Dari rekaman aktivitas, buka Alur Permintaan Target Dimulai dan tentukan nama endpoint target seperti yang ditunjukkan di bawah ini:



2. Setelah mengidentifikasi endpoint target, dapatkan nama server target yang digunakan dari konfigurasi endpoint target seperti yang ditunjukkan pada contoh di bawah:

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   Pada contoh di atas, ada satu server target yang bernama demo-target.

3. Dapatkan definisi untuk setiap server target yang digunakan di endpoint target menggunakan Edge UI atau panggilan Edge API.

   UI Edge

   Untuk mendapatkan definisi menggunakan UI Edge:

   1. Buka Admin > Lingkungan > Server Target.
   2. Pilih lingkungan spesifik tempat Anda melihat kegagalan.
   3. Telusuri nama server target tertentu untuk mendapatkan definisi server target.

      Misalnya, ketik nama server target demo-target dan Anda akan melihat definisinya seperti yang ditunjukkan di bawah ini:

      

      Perhatikan di sini bahwa demo-target server target memiliki alias host, port #, dan SSL diaktifkan. Namun, server target itu sendiri dinonaktifkan, yang ditunjukkan oleh elemen ENABLED yang berwarna abu-abu.

   API Edge

   Untuk mendapatkan definisi menggunakan Edge API:

   Gunakan Dapatkan TargetServer API untuk mendapatkan definisi server target.

   Output Definisi Server Target

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   Output Apigee API menunjukkan bahwa target demo server target telah dinonaktifkan karena elemen IsEnabled ditetapkan ke false.

   Karena server target dinonaktifkan, Pemroses Pesan akan mengirim 503 Service Tidak tersedia dengan kode error NoActiveTargets langsung sebagai respons terhadap klien.

Resolusi

Pastikan server target spesifik yang digunakan dalam konfigurasi endpoint target API Anda Proxy selalu diaktifkan.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

Jika masalah masih berlanjut, buka Harus Mengumpulkan Informasi Diagnostik.

Mendiagnosis masalah menggunakan pemantauan API

Pemantauan API memungkinkan Anda mengisolasi masalah area dengan cepat untuk mendiagnosis masalah error, performa, dan latensi beserta sumbernya, seperti masalah aplikasi, proxy API, target backend, atau platform API.

Mengikuti contoh skenario yang menunjukkan cara memecahkan masalah 5xx dengan API menggunakan Pemantauan API. Misalnya, Anda perlu menyiapkan peringatan yang akan diberi tahu ketika jumlah messaging.adaptors.http.flow.NoActiveTargets kesalahan melebihi batas tertentu.

Harus mengumpulkan informasi diagnostik

Jika masalah berlanjut bahkan setelah mengikuti petunjuk di atas, kumpulkan informasi berikut informasi diagnostik. Hubungi dan bagikan ke Dukungan Apigee:

1. Jika Anda adalah pengguna Cloud Publik, berikan informasi berikut:
1. Nama Organisasi
2. Nama Lingkungan
3. Nama Proxy API
4. Menyelesaikan perintah curl untuk mereproduksi error
5. File rekaman aktivitas yang berisi permintaan dengan Layanan 503 Tidak Tersedia dengan kode error NoActiveTargets
2. Jika Anda adalah pengguna Private Cloud, berikan informasi berikut:
   1. Pesan Error Lengkap diamati
   2. Nama Lingkungan
   3. Paket Proxy API
   4. File rekaman aktivitas yang berisi permintaan dengan Layanan 503 Tidak Tersedia dengan kode error NoActiveTargets
   5. Log Akses NGINX

      (/opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log)

   6. Log Pemroses Pesan

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)