Layanan 503 Tidak Tersedia - NoActiveTargets

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

Video

Lihat video berikut untuk informasi lebih lanjut tentang kesalahan 503:

Gejala

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

Tabel berikut mencantumkan kemungkinan penyebab respons 503 Service memperkirakan 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 Supported dengan kode error NoActiveTargets.

Diagnosis

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



2. Setelah Anda 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 yang bernama demo-target.

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

   UI Edge

   Untuk mendapatkan definisi menggunakan Edge UI:

   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 server target demo-target memiliki alias host, port #, dan SSL diaktifkan. Namun, server target itu sendiri dinonaktifkan , yang ditunjukkan dengan elemen ENABLED berwarna abu-abu.

   API Edge

   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 saat elemen IsEnabled disetel ke false.

   Karena server target dinonaktifkan, Message Processor akan segera mengirimkan 503 Service memperkirakan dengan kode error NoActiveTargets sebagai respons terhadap klien.

Resolusi

Pastikan server target khusus yang digunakan dalam konfigurasi endpoint target Proxy API 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 area masalah dengan cepat untuk mendiagnosis masalah error, performa, dan latensi beserta sumbernya, seperti aplikasi developer, proxy API, target backend, atau platform API.

Ikuti contoh skenario yang menunjukkan cara memecahkan masalah 5xx pada API Anda menggunakan API Monitoring. Misalnya, Anda mungkin ingin menyiapkan pemberitahuan yang akan dikirimkan saat jumlah kesalahan messaging.adaptors.http.flow.NoActiveTargets melebihi batas tertentu.

Harus mengumpulkan informasi diagnostik

Jika masalah terus berlanjut bahkan setelah mengikuti petunjuk di atas, kumpulkan informasi diagnostik berikut. 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 detail migrasi yang berisi permintaan dengan 503 Service Available with 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 detail migrasi yang berisi permintaan dengan 503 Service Available with 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)