Tüm Ürünler
Search

Bu Ürün

    Microservices Engine:Enable log shipping for a cloud-native gateway

    Belge Merkezi

    Microservices Engine:Enable log shipping for a cloud-native gateway

    Son Güncelleme:Oct 06, 2026

    Günlük sevkiyatı, MSE cloud-native ağ geçitlerini Alibaba Cloud Simple Log Service (SLS) ile entegre eder. Bu sayede ağ geçidi erişim günlüklerini analiz ederek istemci davranışlarını anlayabilir, kullanıcıların coğrafi dağılımını haritalayabilir ve sorunları giderebilirsiniz. Bu konuda, bir MSE cloud-native ağ geçidi için günlük sevkiyatının nasıl etkinleştirileceği açıklanmaktadır.

    Önkoşullar

    Not

    Günlük sevkiyatı özelliğinin kendisi ücretsizdir; ancak Simple Log Service (SLS) kullanımına göre standart ücretler uygulanır. SLS faturalandırması hakkında daha fazla bilgi için bkz. kullandıkça öde.

    Günlük sevkiyatını etkinleştirme

    1. MSE konsolunda oturum açın. Üst gezinme çubuğundan bir bölge seçin.

    2. Sol gezinme bölmesinde Cloud-native Gateway > Gateways seçeneklerini seçin. Gateways sayfasında, ağ geçidinin ID değerine tıklayın.

    3. Sol gezinme bölmesinde Parameter Settings seçeneğine tıklayın. Observability Parameters bölümünde, Log Shipping öğesinin yanındaki düzenleme simgesine 2 tıklayın. Açılan Log Shipping Settings iletişim kutusunda, Enable Log Shipping (Ship Gateway Access Logs to Log Service) anahtarını etkinleştirin.

      Not

      • Günlük sevkiyatını etkinleştirdikten sonra Simple Log Service varsayılan bir SLS projesi oluşturur. İsterseniz mevcut bir SLS projesini de seçebilirsiniz.

      • Tracing Analysis'i etkinleştirdikten sonra ağ geçidi izleme verilerini Tracing Analysis konsolunda görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Ağ geçidi için Tracing Analysis'i etkinleştirme.

      Günlük sevkiyatını etkinleştirdikten sonra, Observability Parameters bölümündeki Project öğesinin yanındaki bağlantıya tıklayabilirsiniz. Bu işlem, sizi ağ geçidinin Logstore'una yönlendirir. Daha fazla bilgi için bkz. Günlük sorgulama ve analizi için hızlı başlangıç.

    Sorun giderme: eklenti günlüklerinde içerik yok

    Günlük sevkiyatı etkin olsa bile eklenti günlüklerini sorguladığınızda içerik görünmüyorsa aşağıdaki sırayla sorun giderme adımlarını uygulayın:

    1. Sorgu zaman aralığını genişletin: Sorgu zaman penceresinin isteklerin gerçekleştiği zamanı kapsadığından emin olun. Simple Log Service (SLS) günlük sevkiyatında saniyeler ila dakikalar seviyesinde bir gecikme süresi olabilir; bu nedenle zaman penceresini gerektiği şekilde genişletin.

    2. İsteklerin eklentiyi çağırdığını doğrulayın: Ağ geçidi erişim günlüklerinde ilgili istek kayıtlarını arayın. Böyle bir kayıt yoksa istekler eklentiye ulaşmamıştır. Rota yapılandırmasını kontrol edin.

    3. Eklenti kodundaki günlük çıktısı mantığını kontrol edin: İş isteğinin günlük çıktı ifadelerine gerçekten ulaştığından emin olun. Günlük sevkiyatı doğru çalışsa bile, eklenti kodundaki koşullu dallar isteklerin günlük çıktı ifadelerine ulaşmasını engellerse eklenti günlüklerinde içerik bulunmaz.

    Günlük sevkiyatı alanları


    Alan adı


    Tür


    Açıklama


    __time__


    long


    Günlük girdisinin oluşturulma zamanı.


    cluster_id


    string


    Ağ geçidi örneğinin ID değeri.


    consumer


    string


    İsteğin tüketicisi. Bu alan yalnızca tüketici kimlik doğrulaması etkinleştirildiğinde doldurulur.


    custom_log


    json


    Kullanıcı tanımlı günlük alanlarını depolar. Özel eklentilerle birlikte kullanılabilir.


    authority


    string


    İstekteki Host üstbilgi değeri.


    bytes_received


    long


    Üstbilgiler hariç, istek gövdesinin bayt cinsinden boyutu.


    bytes_sent


    long


    Üstbilgiler hariç, yanıt gövdesinin bayt cinsinden boyutu.


    downstream_local_address


    string


    Ağ geçidi pod'unun adresi.


    downstream_remote_address


    string


    Ağ geçidine bağlı istemcinin adresi.


    downstream_transport_failure_reason


    string


    Aşağı yönlü aktarım hatasının nedeni.


    duration


    long


    Toplam istek işleme süresi (milisaniye cinsinden). İstemciden alınan ilk bayttan yanıta gönderilen son bayta kadar ölçülür.


    method


    string


    HTTP yöntemi.


    path


    string


    HTTP isteğindeki yol.


    protocol


    string


    HTTP protokol sürümü.


    request_id


    string


    Ağ geçidi, her istek için bir ID oluşturur ve bunu x-request-id üstbilgisine ekler. Arka uç hizmeti, sorun giderme amacıyla bu ID'yi günlüğe kaydedebilir.


    requested_server_name


    string


    SSL bağlantısı için kullanılan sunucu adı.


    request_duration


    long


    Ağ geçidinin aşağı yönlü isteğin ilk baytını almasından son baytını almasına kadar geçen süre (milisaniye cinsinden).


    response_code


    long


    HTTP yanıt durum kodu.


    response_code_details


    string


    Yanıt koduyla ilgili ek ayrıntılar. Örneğin, via_upstream yanıt kodunun arka uç hizmeti tarafından döndürüldüğünü, route_not_found ise istek için eşleşen bir rota bulunamadığını gösterir.


    response_flags


    string


    Yanıt hatasının nedeni.


    response_tx_duration


    long


    Ağ geçidinin yukarı yönlü hizmetten ilk baytı almasından aşağı yönlü istemciye son baytı göndermesine kadar geçen süre (milisaniye cinsinden).


    route_name


    string


    Rota adı.


    start_time


    string


    İsteğin UTC formatındaki başlangıç zamanı.


    trace_id


    string


    Trace ID.


    upstream_cluster


    string


    Yukarı yönlü küme.


    upstream_host


    string


    Yukarı yönlü hizmetin IP adresi.


    upstream_local_address


    string


    Yukarı yönlü hizmete bağlanmak için kullanılan yerel adres.


    upstream_protocol


    string


    Arka uç hizmetine istek yapmak için kullanılan protokol.


    upstream_service_time


    long


    Yukarı yönlü hizmetin isteği işlemesi için geçen süre (milisaniye cinsinden). Bu süre, ağ gecikmesini ve hizmetin kendi işleme süresini içerir.


    upstream_transport_failure_reason


    string


    Yukarı yönlü bağlantı hatasının nedeni.


    user_agent


    string


    HTTP isteğindeki User-Agent üstbilgisi.


    x_forwarded_for


    string


    x-forwarded-for HTTP üstbilgisinin değeri. Bu üstbilgi genellikle istemcinin gerçek IP adresini gösterir.


    ext_authz_status_code


    long


    Özel yetkilendirme hizmetinden gelen yanıt kodu.


    ext_authz_duration


    long


    Özel yetkilendirme hizmetinin yanıt süresi.

    Erişim günlüklerine özel alanlar ekleme

    Erişim günlüklerine Referer gibi özel bir alanı kaydetmek için günlük biçimi ayarlama özelliğini kullanarak özel bir günlük biçimi yapılandırın.

    1. Ağ geçidi ayrıntıları sayfasında sol gezinme bölmesinden Parameter Settings seçeneğine tıklayın.

    2. Observability Parameters bölümünde, Log Shipping altındaki Log Format Adjustment öğesini bulun.

    3. Default Format (Click to Customize) seçeneğine tıklayın. Açılan iletişim kutusunda Add düğmesine tıklayın.

    4. Field Type değerini Request Header olarak ayarlayın ve Referer gibi alan değerini girin.

    5. Yapılandırmayı kaydetmek için OK düğmesine tıklayın. Durum Custom Format (Click to Edit) olarak değişir.

    Yapılandırma etkin hale geldikten sonra, Referer istek üstbilgisini içeren istekler kaydedilir ve erişim günlüğündeki request_headers alanında Referer değeri yer alır.

    Günlük biçimi ayarlama şu alan türlerini destekler: istek üstbilgisi, yanıt üstbilgisi, istek dinamik meta verileri ve yanıt dinamik meta verileri.

    Response flags

    Başarısız bir isteğin nedeni öncelikle günlüklerdeki Response_Flag değeriyle belirlenir. Aşağıda Response_Flag için farklı değerler açıklanmaktadır.

    Not

    Bu bağlamda downstream (aşağı yönlü) istemciyi, upstream (yukarı yönlü) ise arka uç hizmetini ifade eder.

    • UH: Kümede kullanılabilir sağlıklı upstream host yok.

    • UF: Upstream bağlantısı başarısız oldu.

    • NR: İstekle eşleşen yapılandırılmış rota yok. Bir istek hiçbir rotayla eşleşmediğinde (response_flags=NR ve response_code_details=route_not_found), response_code değeri 404 olur; route_name ve upstream_cluster alanları ise - olarak görüntülenir. İstek ağ geçidi katmanında reddedilir ve arka uç hizmetine asla ulaşmaz. Bu nedenle, upstream_cluster ve tüm upstream_* alanlarının boş olması beklenen bir davranıştır ve upstream küme yapılandırmasında bir sorun olduğunu göstermez. Bu sorunu gidermek için istek yoluna bir rota yapılandırılıp yapılandırılmadığını kontrol edin.

    • URX: Upstream yeniden deneme sınırı (HTTP) veya maksimum bağlantı denemesi (TCP) aşıldığı için istek reddedildi.

    • NC: Upstream kümesi bulunamadı.

    • DT: İstek veya bağlantı max_connection_duration veya max_downstream_connection_duration sınırını aştı.

    • DC: Downstream bağlantısı sonlandırıldı.

    • LH: Yerel hizmet bir sağlık kontrolü isteğini başarısızlıkla sonuçlandırdı.

    • UT: Upstream isteği zaman aşımına uğradı.

    • LR: Bağlantı yerel olarak sıfırlandı.

    • UR: Upstream bağlantısı uzaktan sıfırlandı.

    • UC: Upstream bağlantısı sonlandırıldı.

    • DI: İstek işleme, hata enjeksiyonu tarafından belirtilen bir süre boyunca ertelendi.

    • FI: İstek, hata enjeksiyonu tarafından belirtilen bir yanıt koduyla iptal edildi.

    • RL: İstek, 429 yanıtları hariç olmak üzere HTTP hız sınırlama filtresi tarafından yerel olarak sınırlandırıldı.

    • UAEX: İstek, harici bir yetkilendirme hizmeti tarafından reddedildi.

    • RLSE: Hız sınırlama hizmetindeki bir hata nedeniyle istek reddedildi.

    • IH: Katı şekilde kontrol edilen bir üstbilgi geçersiz bir değer içerdiği için istek reddedildi.

    • SI: Akış boşta kalma zaman aşımı sınırına ulaşıldı.

    • DPE: Downstream isteğinde bir HTTP protokol hatası oluştu.

    • UPE: Upstream yanıtında bir HTTP protokol hatası oluştu.

    • UMSDR: Upstream isteği maksimum süresine ulaştı.

    • OM: Aşırı yük yöneticisi isteği sonlandırdı.

    • DF: DNS çözümleme hatası nedeniyle istek sonlandırıldı.