Tüm Ürünler
Search
Belge Merkezi

API Gateway:İzleme analizini yapılandırma

Son Güncelleme:Oct 04, 2026

Bu konu, API Gateway konsolunda Tracing Analysis'ın nasıl yapılandırılacağını ve günlüklerin Alibaba Cloud Tracing Analysis platformuna nasıl yükleneceğini açıklar. Tracing Analysis; çağrı izi geri yüklemesi, istek hacmi istatistikleri, topoloji haritaları ve uygulama bağımlılığı analizi gibi araçlar sunarak geliştirme ve tanılama verimliliğini artırmaya yardımcı olur. Bu özellik yalnızca özel örnekler için kullanılabilir.

Ön koşullar

  • API Gateway'in özel bir örneğini kullanıyor olmanız gerekir.

  • Tracing Analysis etkinleştirilmiş olmalıdır.

  • Simple Log Service etkinleştirilmiş olmalıdır.

Tracing Analysis'a izin verme

  1. Tracing Analysis konsolu adresinde oturum açın.

  2. Overview sayfasında, Tracing Analysis'a Simple Log Service verilerinizi okuma ve yazma izni vermek için Authorize Now seçeneğine tıklayın.

  3. Cloud Resource Access Authorization sayfasında gerekli izinleri seçin ve Confirm Authorization Policy seçeneğine tıklayın.

  4. Yetkilendirmeden sonra sol gezinme bölmesinden Overview sayfasına gidin. Access Process bölümünde View Access Point Information seçeneğine tıklayın. Access Point Information sayfasında Show Token seçeneğini açın ve Client-side Collection Tool olarak Jaeger değerini seçin. Ardından Report Data over HTTP bölümündeki uç nokta adresini bulup kaydedin.

API Gateway'de izleme analizini yapılandırma

  1. API Gateway konsolu adresinde oturum açın.

  2. Sol gezinme bölmesinden API Management > API Groups seçeneğini belirleyin. API Groups listesinde bir API grubuna tıklayarak Group Details sayfasını açın. Group Details sayfasında aşağıdaki parametreleri yapılandırın.

    • Trace Field Position: İz alanının konumunu belirtin. Geçerli değerler Header ve Query'dir.

    • Tracing Field Name: İzlenen alanın adını belirtin.

      • İzlenen alan bir istemci tarafından oluşturulur. API Gateway, izlenen alanı arka uç hizmetine iletir ve CustomTraceId alanında kaydeder. API Gateway, izlenen alanın değerini bir iz kimliği olarak kullanarak günlükleri Tracing Analysis'a raporlar. İzlenen alanın değeri, 16 bitlik veya 32 bitlik onaltılık bir sayı olan standart TraceId biçiminde olmalıdır.

      • İstemci izlenen alanı oluşturmazsa veya alan değeri geçerli bir biçimde değilse API Gateway, günlükleri Tracing Analysis'a raporlamak üzere rastgele bir iz kimliği oluşturur.

    • EagleEye ile ilgili üst bilgileri (Eagleeye-Rpcid, Eagleeye-Traceid, Eagleeye-Sampled) geçirin veya oluşturun: Bu seçeneği belirlerseniz API Gateway, EagleEye ile ilgili üst bilgileri istemciden arka uç hizmetine iletir. İstemci bu üst bilgileri göndermezse API Gateway bunları oluşturup arka uç hizmetine iletir. (Bu özellik Serverless ve özel örnekler için kullanılabilir).

    • B3 ile ilgili üst bilgileri (X-B3-traceid, X-B3-Parentspanid, X-B3-Spanid, X-B3-Sampled) geçirin veya oluşturun: Bu seçeneği belirlerseniz API Gateway, B3 ile ilgili üst bilgileri istemciden arka uç hizmetine iletir. İstemci bu üst bilgileri göndermezse API Gateway bunları oluşturup arka uç hizmetine iletir. (Bu özellik Serverless ve özel örnekler için kullanılabilir).

    • İz Günlüklerini Alibaba Cloud Tracing Analysis'a Yükleyin (Yalnızca özel örnekler için):

      • App Name: İzleme analizini yapılandırmak istediğiniz uygulamanın adını belirtin.

      • Endpoint: Tracing Analysis'a izin verin bölümündeki 4. adımdaki uç nokta adresini girin. Hizmetleriniz aynı bölgedeyse daha iyi performans için bir iç ağ uç noktası kullanın.

      • Log Sampling Strategy: Gereksinimlerinize göre bir seçenek belirleyin. Geçerli değerler: Upload all, Percentage upload ve Fixed number of uploads per second.

API Gateway konsolunda Tracing Analysis'ı yapılandırdıktan sonra istek izlerini Tracing Analysis konsolunda görüntüleyebilirsiniz. Tracing Analysis'ın kullanımı hakkında daha fazla bilgi için bkz. API çağrısı ayrıntılarını görüntüleyin.