404 Beberapa host virtual dengan alias host yang sama

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

Gejala

Aplikasi klien mendapatkan kode status HTTP 404 dengan pesan Not Found dan pesan error Unable to identify proxy for host: VIRTUAL_HOST and url: PATH sebagai respons terhadap panggilan API.

Error ini berarti Edge tidak dapat menemukan proxy API untuk jalur dan host virtual yang ditentukan.

Pesan error

Aplikasi klien mendapatkan kode respons berikut:

HTTP/1.1 404 Not Found

Selain itu, Anda mungkin melihat pesan error yang mirip dengan yang ditunjukkan di bawah ini:

{
   "fault":{
      "faultstring":"Unable to identify proxy for host: default and url: \/oauth2\/token",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"
      }
   }
}

Kemungkinan penyebab

Langkah-langkah diagnosis umum

Log NGINX dan Message Processor akan berguna dalam memecahkan masalah error 404. Gunakan langkah-langkah berikut untuk memeriksa log:

1. Lihat log NGINX menggunakan perintah berikut:

   /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

2. Periksa kolom berikut dalam entri log:

   Kolom	Nilai
   Upstream_status, status	404
   X-Apigee-fault-code	messaging.adaptors.http.flow.ApplicationNotFound

   Catat ID pesan dari log.

3. Periksa log Message Processor (/opt/apigee/var/log/edge-message-processor/logs/system.log) untuk melihat apakah Anda memiliki messaging.adaptors.http.flow.ApplicationNotFound untuk API tertentu atau apakah Anda memiliki ID pesan unik dari langkah 2 untuk permintaan API.

   Contoh pesan error dari log Message Processor

NIOThread@1 ERROR ADAPTORS.HTTP.FLOW - AbstractRequestListener.onException() : Request:POST,
uri:/weather, message Id:null, exception:com.apigee.rest.framework.ResourceNotFoundException{
code = messaging.adaptors.http.flow.ApplicationNotFound, message = Unable to identify proxy for
host: vh1 and url: /weather, associated contexts = []}, context:Context@342ea86b
input=ClientInputChannel(SSLClientChannel[Accepted: Remote:10.123.123.123:8443
Local:10.135.33.68:62092]@1206954 useCount=1 bytesRead=0 bytesWritten=0 age=1ms
lastIO=0ms  isOpen=true)

Log di atas menunjukkan kode error dan pesan error sebagai berikut:

code = messaging.adaptors.http.flow.ApplicationNotFound,
message = Unable to identify proxy for host: vh1 and url: /weather

Penyebab: Beberapa host virtual dengan alias host dan nomor port yang sama

Router dan Pemroses Pesan Apigee Edge menggunakan header host, nomor port, dan jalur URI untuk merutekan traffic ke proxy API yang benar. Memiliki definisi yang ambigu seperti beberapa host virtual dengan alias host dan nomor port yang sama adalah anti-pola yang didokumentasikan dan dapat menyebabkan perilaku yang tidak terduga. Salah satu error umum yang akan Anda lihat adalah error 404 dengan pesan Unable to identify proxy for host: VIRTUAL_HOST and url: PATH.

Biasanya, jika ada beberapa host virtual dengan alias host yang sama, Anda akan melihat error 404 yang terjadi sesekali. Hal ini karena Proxy API tertentu dapat dikonfigurasi untuk menerima permintaan hanya di salah satu host virtual. Saat permintaan API dirutekan ke host virtual tertentu yang dikonfigurasi di Proxy API, Anda akan mendapatkan respons yang berhasil. Namun, jika permintaan API dirutekan ke host virtual lain yang tidak dikonfigurasi untuk menerima permintaan oleh Proxy API, maka API akan gagal dengan error 404 ini.

Ikuti petunjuk yang diberikan di 404 Unable to identify proxy for host: <virtual host name> and url: <path> dan pecahkan masalah error ini. Jika tidak ada penyebab yang menyebabkan error ini, gunakan langkah-langkah di bawah untuk menentukan apakah host virtual dengan alias host duplikat menyebabkan error 404.

Diagnosis

Gunakan salah satu metode berikut untuk menentukan apakah ada beberapa host virtual yang memiliki alias host/nomor port yang sama sehingga menyebabkan error 404:

• UI Edge
• API pengelolaan

Resolusi

1. Pastikan setiap host virtual hanya berisi kombinasi alias host dan port yang unik.
2. Jika Anda telah mengidentifikasi beberapa host virtual dengan kombinasi port dan alias host yang sama, maka Anda harus memperbaruinya dengan alias host yang unik.
3. Anda dapat memperbarui setelan ini menggunakan Edge UI atau Management API. Petunjuknya dapat ditemukan di bagian Mengubah host virtual.
4. Pastikan setiap alias host memiliki entri DNS yang tepat.
5. Dalam contoh yang dibahas di atas, jika konfigurasi kita terlihat seperti ini:

   curl -X GET http://localhost:8080/v1/organizations/myorg/environments -u user
   

   [ "prod", "test", "dev" ]

   curl -X GET http://localhost:8080/v1/organizations/myorg/environments/test/virtualhosts/default -u user
   

   {
     "hostAliases" : [ "example.com" ],
     "interfaces" : [  ],
     "listenOptions" : [  ],
     "name" : "default",
     "port" : "9001",
     "retryOptions" : [  ]
   }

   curl -X GET http://localhost:8080/v1/organizations/myorg/environments/dev/virtualhosts/default -u user
   

   {
     "hostAliases" : [ "example.com" ],
     "interfaces" : [  ],
     "listenOptions" : [  ],
     "name" : "default",
     "port" : "9001",
     "retryOptions" : [  ]
   }

   1. Anda dapat memperbarui host virtual yang salah sehingga tidak tumpang-tindih.
   2. Perbarui alias host sebagai example2.com.
   3. Pastikan alias host baru memiliki entri DNS yang serupa dengan alias host sebelumnya.

      curl -X GET http://localhost:8080/v1/organizations/myorg/environments/dev/virtualhosts/default -u user -H 'Content-Type: application/json' -d '{
        "hostAliases" : [ "example2.com" ],
        "interfaces" : [  ],
        "listenOptions" : [  ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [  ]
      }' -i
      

      HTTP/1.1 200 OK
      Date: Tue, 02 Feb 2021 20:54:29 GMT
      Content-Type: application/json
      X-Apigee.user: user
      X-Apigee.organization: myorg
      X-Apigee.environment: dev
      X-Apigee.backends: management-server
      Date: Tue, 02 Feb 2021 20:54:29 GMT
      Content-Length: 152
      
      {
        "hostAliases" : [ "example2.com" ],
        "interfaces" : [  ],
        "listenOptions" : [  ],
        "name" : "default",
        "port" : "9001",
        "retryOptions" : [  ]
      }

6. Lakukan panggilan API lagi ke proxy dan verifikasi bahwa Anda mendapatkan respons yang berhasil secara konsisten:

   curl http://example.com:9001/proxy1
   

   {
       "slideshow": {
   	    "author": "Yours Truly",
   		"date": "date of publication",
   		"slides": [
   		    {
   			    "title": "Wake up to WonderWidgets!",
   				"type:": "all"
   			},
   			{
   			    "items": [
   				    "Why WonderWidgets are great",
   					"Who buys WonderWidgets"
   				],
   				"title": "Overview",
   				"type": "all"
   			}
   		],
   		"title": "Sample Slide Show"
       }
   
   }

7. Jika masalah masih berlanjut, buka Informasi diagnostik yang harus dikumpulkan.

Harus mengumpulkan informasi diagnostik

Jika masalah berlanjut bahkan setelah mengikuti petunjuk di atas, kumpulkan informasi diagnostik berikut, lalu hubungi Dukungan Apigee Edge:

Jika Anda adalah pengguna Cloud Publik, berikan informasi berikut:

• Nama organisasi
• Nama lingkungan
• Nama Proxy API
• Selesaikan perintah curl untuk mereproduksi error 404
• Jika error 404 tidak terjadi saat ini, berikan jangka waktu dengan informasi zona waktu saat error 404 terjadi di masa lalu.

Jika Anda adalah pengguna Private Cloud, berikan informasi berikut:

• Pesan error lengkap yang diamati untuk permintaan yang gagal
• Nama Organisasi, Lingkungan, dan Proxy API yang Anda amati 404 errornya
• Paket Proxy API
• Log akses NGINX
  /opt/apigee/var/log/edge-router/nginx/ORGANIZATION_NAME~ENVIRONMENT_NAME.PORT#_access_log
• Log Message Processor
  /opt/apigee/var/log/edge-message-processor/logs/system.log
• Jangka waktu dengan informasi zona waktu saat terjadi error 404