API Gateway:Frequently asked questions

Cloud-native API Gateway IPv6'yı destekler mi?

Evet.

Cloud-native API Gateway x-forwarded-for istek üst bilgisini destekler mi?

Evet.

İstek zaten x-forwarded-for üst bilgisini içeriyorsa ağ geçidi önceki atlamaya ait IP adresini ekler. Aksi takdirde ağ geçidi bu IP adresiyle üst bilgiyi ekler.

"upstream connect error or disconnect/reset header" hatalarının çözülmesi

Bu hata, arka uç hizmetinin güvenlik grubunun ağ geçidi örneğinden gelen erişimi engellediğini gösterir.

Bu sorunu çözmek için ağ geçidi örneğinizin Overview sayfasına gidin, Security Group Authorizations sekmesini tıklayın ve ardından bir güvenlik grubu yapılandırması eklemek için Add Security Group Rule seçeneğini tıklayın. Ağ geçidi istekleri ACK'deki Pod IP adresine doğrudan iletir; bu nedenle güvenlik grubu kuralında pod tarafından kullanılan bağlantı noktasını açmanız gerekir.

Bir alan adını eşleştirmek için üst bilgi kullanma

Bir rota oluştururken bir istek üst bilgisi eşleştirme kuralı ekleyin.

Üst bilgi alan adını :authority olarak ve üst bilgi değerini belirli alan adı olarak ayarlayın.

Büyük gövde nedeniyle oluşan istek hatalarının çözülmesi

Bu sorun, ağ geçidinin bağlantı arabelleğinin çok küçük olmasından kaynaklanır. Arabellek boyutunu artırabilirsiniz:

• HTTP/1.x kullanıyorsanız konsolda DownstreamConnectionBufferLimits parametresini ayarlayın.

• HTTP/2 kullanıyorsanız konsolda DownstreamConnectionBufferLimits ve InitialStreamWindowSize parametrelerini ayarlayın.

Hizmet kaynağı ekleme sınırları

• Tek bir ağ geçidi örneği en fazla üç ACK kümesiyle ilişkilendirilebilir.

• Tek bir ağ geçidi örneği yalnızca bir Nacos örneğiyle ilişkilendirilebilir.

Mevcut bir Nacos veya ACK hizmet kaynağı seçilemiyor

Cloud-native API Gateway yalnızca aynı VPC içinde bulunan Nacos örneklerini veya ACK kümelerini ekleyebilir.

Cloud-native API Gateway özel HTTPS sertifikalarını destekler mi?

Cloud-native API Gateway sertifikaları doğrudan barındırmaz. Bunun yerine bunları Alibaba Cloud Certificate Management Service üzerinden çeker. Sertifikanızı Certificate Management Service'e yükleyin, ardından ağ geçidinde alan adı için yapılandırın.

Parametre değişikliklerinin mevcut trafik üzerindeki etkileri

• XffTrustedNum ile ilgili değişikliklerin etkili olması için ağ geçidinin yeniden başlatılması gerekir.

• UpstreamIdleTimeout ile ilgili değişiklikler yukarı yönlü bağlantıların kesilip yeniden bağlanmasına neden olur.

• DownstreamIdleTime ile ilgili değişiklikler aşağı yönlü bağlantıların kesilip yeniden bağlanmasına neden olur.

Bir arka uç hizmeti için anormal sağlık denetimi durumu

Anormal bir sağlık denetimi durumunun birkaç nedeni olabilir:

• VPC içindeki özel bir hizmet için arka uç hizmetinin güvenlik grubunun ağ geçidinin gerekli bağlantı noktasına erişmesine izin verip vermediğini kontrol edin. Daha fazla bilgi için bkz. Güvenlik grubu kuralı ekleme.

• Herkese açık bir hizmet için VPC'nin İnternet erişimine sahip olup olmadığını kontrol edin. İnternet'e erişmek için bir İnternet NAT ağ geçidinin SNAT özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz. İnternet'e erişmek için İnternet NAT ağ geçidinin SNAT özelliğini kullanma.

• HTTP tabanlı sağlık denetimleri için istek yolunun ve istek alan adının doğru şekilde yapılandırıldığından emin olun.

• HTTP tabanlı sağlık denetimleri için arka uç hizmetinin sağlık denetimi uç noktasına HTTPS üzerinden erişilmesi gerekiyorsa hizmetin ilkesini Policy Configuration bölümünde TLS moduna ayarlayın.

• HTTP tabanlı sağlık denetimleri için yukarıdaki tüm yapılandırmalar doğruysa sorun, sağlık denetimi aralığının arka uç hizmetinin bağlantı canlı tutma süresiyle aynı olması olabilir. Sağlık denetimi aralığını artırmayı deneyin.

Bir istek hatasının nedeninin belirlenmesi

• Yanıt üst bilgisinde x-envoy-upstream-service-time olup olmadığını kontrol edin. Varsa ağ geçidi isteği zaten arka uç hizmetine iletmiştir. Hata büyük olasılıkla arka uç hizmetinden kaynaklanır.

• Ağ geçidinin erişim günlüğündeki upstream_service_time alanının boş olup olmadığını kontrol edin. Alan boş değilse ağ geçidi isteği zaten arka uç hizmetine iletmiştir. Hata büyük olasılıkla arka uç hizmetinden kaynaklanır.

Güncellenen HTTPS sertifikası etkili olmuyor

Bu sorun genellikle ağ geçidinin yukarısında CLB, DCDN, WAF veya Anti-DDoS Proxy gibi bir hizmette de HTTPS sertifikası yapılandırıldığında ortaya çıkar. Yukarı yönlü hizmetteki sertifikanın da güncellenip güncellenmediğini kontrol edin. En iyi uygulama olarak HTTPS sertifikalarını yalnızca tek bir yerde yapılandırın. DCDN veya WAF yukarı yönde dağıtıldıysa HTTPS'i yalnızca DCDN veya WAF üzerinde yapılandırabilir ve ağ geçidine yönelik kökene dönüş istekleri için HTTP kullanabilirsiniz.

Rota önceliği

Bir ağ geçidi örneğinin Route Settings sayfasında listedeki rotaların sırası en yüksekten en düşüğe doğru eşleştirme önceliklerini temsil eder. Öncelik alan adı ve rota kuralları tarafından belirlenir. Alan adı eşleştirme önceliği exact domain name > wildcard domain name şeklindedir. Örneğin test.example.com *.example.com adresinden daha yüksek önceliğe sahiptir. Aynı alan adı için yol eşleştirme önceliği Exact Match>Prefix Match>Match Regular Expression şeklindedir. Aynı alan adı ve yol için more matching conditions içeren kurallar fewer matching conditions içerenlerden daha yüksek önceliğe sahiptir (eşleştirme koşulları Header ve Query parametrelerini içerir).

DCDN ile HTTPS istek hataları

Bu sorun genellikle DCDN'in ağ geçidine yönelik kökene dönüş isteklerinde Sunucu Adı Gösterimini (SNI) dahil etmemesinden kaynaklanır. Bu sorunu çözmek için DCDN ayarlarınızda kökene dönüş SNI'sini yapılandırın.

WAF ile HTTPS istek hataları

Bu sorun genellikle WAF'in ağ geçidine yönelik kökene dönüş isteklerinde Sunucu Adı Gösterimini (SNI) dahil etmemesinden kaynaklanır. WAF'te CNAME erişim modunu kullanıyorsanız ilgili alan adı için ayarları değiştirin. Enter Your Website Information adımında Enable Origin SNI seçeneğini belirleyin.

Cloud-native API Gateway WebSocket'i destekler mi?

Evet, WebSocket desteklenir ve varsayılan olarak etkindir.

Cloud-native API Gateway gRPC'yi destekler mi?

Evet. gRPC ulaşım için HTTP/2 protokolünü kullanır. Ağ geçidinin Parameter Settings sayfasında EnableHttp2 = true olarak ayarlandığından emin olun.

Cloud-native API Gateway GZIP sıkıştırma açmayı destekler mi?

Evet. Ağ geçidinin Parameter Settings sayfasında EnableGzip = true olarak ayarlandığından emin olun. Desteklenen algoritmalar Gzip ve Brotli'dir ve ZipAlgorithm parametresi aracılığıyla yapılandırılır. Varsayılan Gzip'tir.

Üst bilgi büyük/küçük harf durumunun korunması

Evet. Ağ geçidinin Parameter Settings sayfasında PreserveHeaderFormat = true olarak ayarlandığından emin olun. Bu parametre yalnızca HTTP/1.0 ve HTTP/1.1 için geçerlidir. HTTP/2 protokolü belirtimi tüm istek ve yanıt üst bilgilerinin küçük harfle yazılmasını gerektirir.

Cloud-native API Gateway HTTP/3'ü destekler mi?

Evet. Ağ geçidinin Parameter Settings sayfasında EnableHttp3 = true olarak ayarlandığından emin olun.

Üst bilgiler küçük harfe dönüştürülüyor

Varsayılan olarak ağ geçidi tüm istek ve yanıt üst bilgilerini küçük harfe dönüştürür. Orijinal büyük/küçük harf durumunu korumak için ağ geçidinin Parameter Settings sayfasında PreserveHeaderFormat = true ayarını yapın.

Bir DNS alan adı hizmetine yapılan istekler başarısız oluyor

Yapılandırılan DNS alan adı genel bir alan adıysa İnternet erişimini etkinleştirmek için bir İnternet NAT ağ geçidinde SNAT yapılandırmanız gerekir. Varsayılan olarak bir ağ geçidi örneği İnternet'e erişemez.

Arka uç hizmeti olarak bir DNS alan adı kullanıldığında 404 hatası alma

Arka uç hizmetine bir DNS alan adı kullanılarak erişildiğinde ağ geçidi varsayılan olarak isteğin Host üst bilgisini yeniden yazmaz. Arka uç hizmet rotaları Host üst bilgisine göre eşleştiriyorsa istek 404 hatası döndürür.

Host üst bilgisini arka uç hizmetinin gerçek alan adına yeniden yazmak için rota yapılandırmasına bir HTTP yeniden yazma ilkesi ekleyin. Daha fazla bilgi için bkz. HTTP yeniden yazma ilkesi yapılandırma.

404 hatasının nedenini daha fazla araştırmak için ağ geçidi erişim günlüğündeki response_flags alanını kullanabilirsiniz. Daha fazla bilgi için bu konudaki "404 hatası alma" bölümüne bakın.

ARMS konsolunda eksik izleme bilgileri

Ağ geçidi yapılandırmasında EnableGenerateRequestId parametresinin true olarak ayarlanıp ayarlanmadığını kontrol edin. false olarak ayarlanmışsa isteklerinize uyumlu bir x-request-id üst bilgisi eklemeniz gerekir. Aksi takdirde ağ geçidi izleme bilgilerini raporlayamaz.

400 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• İstemci protokol hatası içeren bir istek gönderdi. Ağ geçidinin erişim günlüğünde response_flags = DPE olup olmadığını kontrol edin.

• Arka uç hizmet 400 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 400 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

401 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• Ağ geçidi hatayı döndürdü ve bu, eksik erişim kimlik bilgilerini gösterir. Kimlik doğrulamayı, yetkilendirmeyi veya bir WebAssembly eklentisini etkinleştirip etkinleştirmediğinizi kontrol edin.

• Arka uç hizmet 401 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 401 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

403 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• Ağ geçidi hatayı döndürdü ve bu, yetersiz erişim izinlerini gösterir. Bir IP adresi engelleme listesini veya izin listesini, kimlik doğrulamayı, yetkilendirmeyi veya bir WebAssembly eklentisini etkinleştirip etkinleştirmediğinizi kontrol edin.

• Arka uç hizmet 403 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 403 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

404 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• Ağ geçidinde eşleşen bir rota kuralı yapılandırılmamış. Ağ geçidinin erişim günlüğünü kontrol edin. Günlükte response_flags = NR varsa rota bulunamadığı anlamına gelir.

• Arka uç hizmet 404 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 404 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

405 hatası alma

WAF koruması etkinleştirildiyse istek bir WAF koruma kuralını tetiklemiş olabilir. Bu durumda WAF 405 durum kodunu döndürür.

413 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• İstek boyutu ağ geçidinin bağlantı arabelleği sınırını aşıyor. Parameter Settings sayfasında DownstreamConnectionBufferLimits parametresinin değerini artırın.

• Arka uç hizmet 413 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 413 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

429 hatası alma

Bir ağ geçidi kısıtlama kuralı tetiklendi. Ağ geçidinin erişim günlüğünü kontrol edin. Günlükte response_flags = RL varsa ağ geçidi kısıtlama kuralınızı gözden geçirin.

502 hatası alma

Bu hata genellikle aşağıdaki nedenlerden biriyle oluşur:

• Arka uç hizmet protokol hatası içeren bir yanıt döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. Günlükte response_flags = UPE varsa en yaygın neden, arka uç hizmetinden gelen yanıt üst bilgisinde yinelenen bir Transfer-Encoding alanıdır. Arka uç hizmetinizi kontrol edin.

• Arka uç hizmet 502 hatası döndürdü. Ağ geçidinin erişim günlüğünü kontrol edin. response_flags alanı boşsa ve upstream_host alanında bir değer varsa bu, arka uç hizmetin 502 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

503 hatası alma

Bu hata aşağıdaki nedenlerle oluşabilir:

• Rota kuralında belirtilen hedef hizmette sağlıklı IP adresi yok. Ağ geçidinin erişim günlüğünü kontrol edin. Bu durum response_flags = UH ile gösterilir.

• Ağ geçidi isteği iletirken arka uç hizmet bağlantıyı kapattı. Ağ geçidinin erişim günlüğünü kontrol edin. Bu durum response_flags = UC ile gösterilir. Bu genellikle arka uç hizmetin bağlantı idle timeout değerinin ağ geçidinin UpstreamIdleTimeout değerinden düşük olmasından kaynaklanır. Ağ geçidinin Parameter Settings sayfasında UpstreamIdleTimeout değerini azaltın.

• Ağ geçidi arka uç hizmetinin IP adresine bağlanamıyor. Ağ geçidinin erişim günlüğünü kontrol edin. Bu durum response_flags = UF veya response_flags = URX ile gösterilir. Bu genellikle arka uç hizmetinin güvenlik grubunun ağ geçidinden gelen erişimi engellemesinden kaynaklanır. Arka uç hizmetinin güvenlik grubunun ağ geçidinin bağlantı noktasına erişmesine izin verecek şekilde yapılandırılıp yapılandırılmadığını kontrol edin. Daha fazla bilgi için bkz. Güvenlik grubu kuralı ekleme.

• Arka uç hizmet ağ geçidinin yapılandırmasında yok. Ağ geçidinin erişim günlüğünü kontrol edin. Bu durum response_flags = NC ile gösterilir. Bu birkaç nedenden dolayı olabilir:

  • İlgili hizmet artık mevcut değil.

  • Arka uç hizmetin birden çok bağlantı noktası varsa rotada hedef hizmeti yapılandırırken dinamik bir bağlantı noktası değil sabit bir bağlantı noktası seçmeniz gerekir.

  • Arka uç hizmet için sabit bir bağlantı noktası seçildi ancak hizmetin bağlantı noktası değişti.

• Arka uç hizmet 503 hatası döndürdü. Günlükteki response_flags alanı boşsa ve upstream_host alanı boş değilse bu, arka uç hizmetin 503 hatası döndürdüğünü gösterir. upstream_host değeri, isteği alan arka uç hizmetinin IP adresidir.

Erişim günlüğünde response_code değeri 0

response_code değeri 0, istemcinin yanıt almadığını gösterir.

Bu durum genellikle iki nedenden biriyle gerçekleşir:

• İstemci bağlantıyı erken kapattı (örneğin zayıf bir mobil ağ veya yavaş bir arka uç yanıtı nedeniyle). Bu durum erişim günlüğünde response_flags = "DC" ile gösterilir.

• Sunucu Adı Gösterimi (SNI) olmadan bir HTTPS isteği gönderildi ve joker karakterli alan adı için herhangi bir HTTPS sertifikası yapılandırılmadı. SNI, alan adı bilgisi taşıyan bir TLS uzantısıdır. Bu durum erişim günlüğünde requested_server_name alanının boş olmasıyla gösterilir.

Eşleşmeyen rota istekleri tarafından tüketilen genel trafik

Evet. Hiçbir rotayla eşleşmeyenler dahil ağ geçidinden geçen tüm istekler genel trafiği tüketir. Ağ geçidi isteği almak ve yanıt göndermek için yine de trafik kullanır.

Trafik tüketimini aşağıdaki alanları kullanarak ağ geçidinin erişim günlüğünde kontrol edebilirsiniz:

• bytes_received: Gelen trafiği temsil eden istek gövdesinin boyutu.

• bytes_sent: Giden trafiği temsil eden yanıt gövdesinin boyutu.

Bir rotayla eşleşmeyen istekler erişim günlüğünde response_code_details değeri route_not_found ve response_flags değeri NR ile tanımlanır.

Eşleşmeyen rota isteklerinin kaynağının izlenmesi

Ağ geçidi için günlük teslimini etkinleştirdikten sonra Log Service'te eşleşmeyen istekleri sorgulayabilir ve kaynak IP adresini belirlemek için günlük alanlarını kullanabilirsiniz. Erişim günlüğü, başarısız olanlar dahil tüm istekleri kaydeder. Kaynak IP adresi downstream_remote_address alanında bulunur.

Log Service'te eşleşmeyen istekleri filtrelemek için aşağıdaki sorguyu çalıştırın:

response_code_details: "route_not_found"

Sorgu sonuçlarında istek kaynağını belirlemek için aşağıdaki alanları kontrol edin:

• downstream_remote_address: Ağ geçidine bağlanan istemcinin adresi.

• x-forwarded-for: HTTP istek üst bilgisindeki x-forwarded-for alanı, isteğin orijinal kaynak IP adresini gösterir. İstek proxy'lerden geçerse bu alan birden çok IP adresi içerebilir. Son IP adresi, ağ geçidinden önceki atlamanın adresidir.

Bu anormal isteklerin trafik tüketimini hesaplamak için Log Service'te aşağıdaki sorguyu çalıştırın:

response_code_details: "route_not_found" | SELECT sum(bytes_sent + bytes_received) AS total_bytes

Cloud-native API Gateway istek günlüklerine istemci Referer üst bilgisi nasıl eklenir?

Referer üst bilgisi varsayılan olarak ağ geçidi erişim günlüklerinde kaydedilmez. Bunu yakalamak için günlük teslimi özelliğini etkinleştirin ve ağ geçidi konsolunda Referer'ı günlük çıktısına özel bir üst bilgi alanı olarak dahil etmek için özel bir üst bilgi eşleştirme kuralı yapılandırın.

Günlük teslimi özelliği hakkında daha fazla bilgi için bkz. Ağ geçidi için günlük teslimini etkinleştirme.