Layanan 503 Tidak Tersedia - NoActiveTargets

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

Video

Tonton video berikut untuk mengetahui informasi selengkapnya tentang error 503:

Gejala

Aplikasi klien menerima kode status respons HTTP 503 dengan pesan Service Unavailable 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 Service Unavailable dengan kode error NoActiveTargets biasanya diamati saat Anda menggunakan satu atau beberapa server target dalam konfigurasi endpoint target di Proxy API.

Tabel berikut mencantumkan kemungkinan penyebab respons 503 Service Unavailable dengan kode error NoActiveTargets:

Penyebab: Server target dinonaktifkan

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

Diagnosis

1. Tentukan nama server target yang digunakan dalam Konfigurasi Endpoint Target tertentu dari 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 Anda tidak yakin endpoint mana yang telah menonaktifkan server target, ikuti langkah-langkah di bawah ini:
1. Aktifkan sesi rekaman aktivitas, lakukan panggilan API, dan reproduksi masalah - 503 Service Unavailable.
2. Dari rekaman aktivitas, buka Target Request Flow Started 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 dalam 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 bernama demo-target.

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

   UI Edge

   Untuk mendapatkan definisi menggunakan UI Edge:

   1. Buka Admin > Environments > Target Servers.
   2. Pilih lingkungan tertentu 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:

      

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

   Edge API

   Untuk mendapatkan definisi menggunakan Edge API:

   Gunakan Get 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 server target demo-target dinonaktifkan karena elemen IsEnabled disetel ke salah (false).

   Karena server target dinonaktifkan, Message Processor akan segera mengirim 503 Service Unavailable dengan kode error NoActiveTargets sebagai respons kepada klien.

Resolusi

Pastikan server target tertentu yang digunakan dalam konfigurasi endpoint target API Proxy Anda 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 Must Gather Diagnostic Information.

Mendiagnosis masalah menggunakan pemantauan API

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

Ikuti langkah-langkah dalam contoh skenario yang menunjukkan cara memecahkan masalah 5xx dengan API Anda menggunakan Pemantauan API. Misalnya, Anda dapat menyiapkan pemberitahuan untuk menerima notifikasi saat jumlah kesalahan messaging.adaptors.http.flow.NoActiveTargets melebihi batas tertentu.

Harus mengumpulkan informasi diagnostik

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

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

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

   6. Log Message Processor

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