İzleme aracını kullanma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

İzleme aracı nedir?

Trace, Apigee Edge'de çalışan API proxy'lerinde sorun giderme ve izleme için kullanılan bir araçtır. Trace (İzleme), API proxy akışı aracılığıyla her adımın ayrıntılarını incelemenizi sağlar.

İzleme özelliğini kullanma

İzleme özelliğinin kullanımı kolaydır. Bir izleme oturumu başlatır, ardından Edge platformuna bir API çağrısı yapar ve sonuçları okursunuz.

1. Aşağıda açıklandığı şekilde API proxy'leri sayfasına erişin.
   

   Edge

   Edge kullanıcı arayüzünü kullanarak API proxy'leri sayfasına erişmek için:

   1. apigee.com/edge adresinde oturum açın.
   2. Soldaki gezinme çubuğunda Geliştir > API Proxies'i (API Proxy'leri) seçin.

   Yeni Edge kullanıcı arayüzü (özel bulut)

   Yeni Edge kullanıcı arayüzünü kullanarak API proxy'leri sayfasına erişmek için:

   1. http://host:3001/edge adresinden Yeni Edge kullanıcı arayüzünde oturum açın. Burada host, Yeni Edge kullanıcı arayüzünü çalıştıran ana makinenin IP adresi veya DNS adıdır.
   2. Soldaki gezinme çubuğunda Geliştir > API Proxies'i (API Proxy'leri) seçin.
2. API Proxies (API Proxy'leri) sayfasından bir API proxy'si seçin.
3. İzlemek istediğiniz API'nin dağıtıldığından emin olun.
4. İzleme aracı görünümüne gitmek için İzle'yi tıklayın.
5. Hangi dağıtım ortamını ve proxy düzeltmesini izlemek istediğinizi seçmek için İzlenecek Dağıtım açılır menüsünü kullanın.
6. Start Trace Session'ı (İzleme Oturumunu Başlat) tıklayın. İzleme oturumu etkin olduğunda API proxy'si, işleme hattındaki her adımın ayrıntılarını kaydeder. İzleme oturumu çalışırken canlı trafikten mesajlar ve bağlamsal veriler yakalanır.
   

   

7. Proxy'nizden geçen canlı trafiğiniz yoksa API'ye istek göndermeniz yeterlidir. İsteği göndermek için istediğiniz aracı (ör. curl, Postman veya bildiğiniz herhangi bir araç) kullanabilirsiniz. Dilerseniz isteği doğrudan İzleme aracından da gönderebilirsiniz. URL'yi girip Gönder'i tıklamanız yeterlidir. Not: Yalnızca İzleme aracından GET isteği gönderebilirsiniz, POST isteği gönderemezsiniz.
   
   Not: Bir İzleme oturumu, seçilen API proxy'si aracılığıyla mesaj işlemcisi başına 10 istek/yanıt işlemini destekleyebilir. Trafiği işleyen 2 mesaj işlemcisiyle Edge Cloud'da 20 istek/yanıt işlemi desteklenir. İzleme oturumu, manuel olarak durdurulmadığı takdirde 10 dakika sonra otomatik olarak durdurulur.
   
8. Yeterli sayıda istek yakaladığınızda İzleme Oturumunu Durdur'u tıklayın.
9. Yakalanan istek/yanıt işlemlerinin listesi sol menüde gösterilir. Ayrıntılı sonuçları görüntülemek için işlemlerden birini tıklayın.

İzlemeyi okuma

İzleme aracının iki ana bölümü vardır: işlem haritası ve aşama ayrıntıları.

• İşlem haritası, politika yürütme, koşullu adımlar ve geçişler dahil olmak üzere bir API proxy işlemi sırasında gerçekleşen her önemli adımı işaretlemek için simgeler kullanır. Özet bilgileri görmek için herhangi bir simgenin üzerine gelin. İstek akışı adımları işlem haritasının üst kısmında, yanıt akışı adımları ise alt kısmında gösterilir.
• Aracın aşama ayrıntıları bölümünde, proxy'nin dahili işleme süreciyle ilgili bilgiler (ayarlanan veya okunan değişkenler, istek ve yanıt başlıkları vb.) listelenir. İlgili adımın aşama ayrıntılarını görmek için herhangi bir simgeyi tıklayın.

Ana proxy işleme segmentlerinin etiketlendiği örnek bir izleme aracı haritasını aşağıda bulabilirsiniz:

İzleme aracının işlem haritası

İşlem haritası açıklaması

Aşağıdaki tabloda, işlem haritasında göreceğiniz simgelerin amacı açıklanmaktadır. Bu simgeler, proxy akışı boyunca önemli olan her işleme adımını işaretler.

İşlem haritası simgeleri

	API proxy'sinin ProxyEndpoint'ine istek gönderen istemci uygulaması.
	Daireler, proxy akışındaki geçiş uç noktalarını işaretler. İstemciden istek geldiğinde, istek hedefe gittiğinde, yanıttın hedeften geri geldiğinde ve yanıt istemciye geri gittiğinde bu bilgiler bulunur.
	Uzun çubuklar, API proxy akışındaki bir akış segmentinin başlangıcını gösterir. Akış segmentleri: ProxyEndpoint isteği, TargetEndpoint isteği, TargetEndpoint yanıtı ve ProxyEndpoint yanıtı. Bir segment; PreFlow, Conditional Flows ve PostFlow'u içerir. Daha fazla bilgi için Akışları yapılandırma başlıklı makaleyi inceleyin.
	Analytics işlemlerinin arka planda gerçekleştiğini gösterir.
	Doğru olarak değerlendirilen koşullu bir akış. Koşullu akışlara giriş için Akışları yapılandırma başlıklı makaleyi inceleyin. Bazı koşulların Edge tarafından oluşturulduğunu unutmayın. Örneğin, Edge'in ProxyEndpoint'te hata oluşup oluşmadığını kontrol etmek için kullandığı ifade aşağıda verilmiştir: ((error.state equals PROXY_REQ_FLOW) or (error.state equals PROXY_RESP_FLOW))
	Yanlış olarak değerlendirilen koşullu bir akış. Koşullu akışlara giriş için Akışları yapılandırma başlıklı makaleyi inceleyin. Bazı koşulların Edge tarafından oluşturulduğunu unutmayın. Örneğin, Edge'in TargetEndpoint'te hata oluşup oluşmadığını kontrol etmek için kullandığı ifade aşağıda verilmiştir: (((error.state equals TARGET_REQ_FLOW) or (error.state equals TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals RESP_START)))
	Politikalar Her politika türünün benzersiz bir simgesi vardır. Bu, AssignMessage politikası içindir. Bu simgeler, politikaların doğru sırada yürütülüp yürütülmediğini ve başarılı olup olmadığını görmenizi sağlar. Politikanın yürütülme sonuçlarını ve bu sonuçların beklenen sonuçlar olup olmadığını görmek için politika simgesini tıklayabilirsiniz. Örneğin, mesajın düzgün şekilde dönüştürülüp dönüştürülmediğini veya önbelleğe alınıp alınmadığını görebilirsiniz. Politikaların düzgün şekilde uygulandığı, onay işaretleriyle açıkça belirtilir. Hata durumunda simgede kırmızı bir ünlem işareti gösterilir. İpucu: Herhangi bir politikanın beklenenden daha uzun sürüp sürmediğini görmek için ipucuna veya zaman çizelgesine dikkat edin.
	Arka uç hedefi bir Node.js uygulaması olduğunda görünür. Apigee Edge'de Node.js'ye genel bakış başlıklı makaleyi inceleyin.
	API proxy'si tarafından çağrılan arka uç hedefi.
	Zaman çizelgesi, işleme süresinin tamamlanmasının ne kadar sürdüğünü (milisaniye cinsinden) gösterir. Geçen süre segmentlerini karşılaştırmak, yürütülmesi en uzun süren ve API çağrılarınızı yavaşlatan politikaları belirlemenize yardımcı olur.
	Epsilon, milisaniyeden daha kısa bir zaman aralığını gösterir.
	Devre dışı. Bir politika devre dışı bırakıldığında politika simgesinde görünür. Politikalar, genel API ile devre dışı bırakılabilir. API proxy yapılandırma referansı bölümüne bakın.
	Hata. Politika Adımı koşulu yanlış olarak değerlendirildiğinde (bkz. Akış değişkenleri ve koşullar) veya bir RaiseFault politikası her yürütüldüğünde politika simgesinde görünür.
	Atlandı. Adım koşulu yanlış olarak değerlendirildiği için politika yürütülmediğinde politika simgesinde görünür. Daha fazla bilgi için Akış değişkenleri ve koşulları başlıklı makaleyi inceleyin.

Aşama ayrıntılarını anlama

Aracın Aşama Ayrıntıları bölümü, her işleme adımında proxy'nizin durumu hakkında birçok bilgi verir. Aşama Ayrıntıları'nda verilen bazı bilgiler aşağıda yer almaktadır. Seçili adımın ayrıntılarını görmek için izleme aracındaki herhangi bir simgeyi tıklayın veya bir adımdan diğerine geçmek için Sonraki/Geri düğmelerini kullanın.

Filtreleri kullanarak ileti yakalamayı hassaslaştırma

Başlık ve/veya sorgu parametresi değerlerini belirterek İzleme aracında hangi isteklerin gösterileceğini filtreleyebilirsiniz. Filtreler, sorunlara neden olabilecek belirli görüşmeleri hedeflemenize olanak tanır. Örneğin, belirli içeriğe sahip istekleri veya belirli iş ortaklarından ya da uygulamalardan gelen istekleri ayrıntılı olarak incelemeniz gerekebilir. Şu ölçütlere göre filtre uygulayabilirsiniz:

• HTTP başlıkları: İzlemeyi yalnızca belirli bir başlığı içeren çağrılarla sınırlayın. Bu, sorunları gidermenize yardımcı olacak iyi bir yöntemdir. Uygulama geliştiricinize bir başlık gönderip sorunlara neden olan çağrıya bu başlığı eklemesini isteyebilirsiniz. Ardından Apigee Edge, sonuçları inceleyebilmeniz için yalnızca söz konusu başlığa sahip çağrıları kaydeder.
• Sorgu parametreleri: Yalnızca bir parametrenin belirli bir değerine sahip olan aramalar kaydedilir.

Filtre özelliği hakkında bilmeniz gerekenler

• Filtre alanlarında filtre parametrelerini belirttikten sonra İzleme oturumunuzu yeniden başlatmanız gerekir.
• Filtre parametreleri "VE" ile birleştirilir. Belirtilen tüm sorgu ve/veya başlık adı/değer çiftleri, başarılı bir eşleşme için istekte bulunmalıdır.
• Filtreler aracında kalıp eşleştirme desteklenmez.
• Filtre parametreleri ve değerleri büyük/küçük harfe duyarlıdır.

İzleme filtresi oluşturma

1. Bir izleme oturumu çalışıyorsa İzleme Oturumunu Durdur'u tıklayarak oturumu durdurun.
2. Filtreler alanını genişletmek için İzleme aracının sol üst köşesindeki Filtreler'i tıklayın.
   
   
   
3. Filtreler alanında, filtrelemek istediğiniz sorgu parametresini ve/veya başlık değerlerini belirtin. Bu örnekte, filtreleme için iki sorgu parametresi belirtiyoruz. Başarılı bir eşleşme için her iki parametre de istekte bulunmalıdır.
   
   
   
4. İzleme oturumunu başlatın.
5. API'lerinizi çağırın. Yalnızca belirtilen başlıkların ve/veya sorgu parametrelerinin tümünü içeren istekler başarılı bir eşleşme oluşturur.

Yukarıdaki örnekte, bu API çağrısı izde şu şekilde görünür:

http://docs-test.apigee.net/cats?name=Penny&breed=Calico

Ancak bu işlem:

http://docs-test.apigee.net/cats?name=Penny

İz ile hata ayıklama

İzleme, bir API proxy'siyle ilgili birçok dahili ayrıntıyı görmenizi sağlar. Örneğin:

• Hangi politikaların doğru şekilde yürütüldüğünü veya başarısız olduğunu bir bakışta görebilirsiniz.
• Analytics kontrol panellerinden birinde API'lerinizden birinin performansında olağan dışı bir düşüş olduğunu fark ettiğinizi varsayalım. Artık performans sorunlarının nerede oluştuğunu belirlemek için Trace'i kullanabilirsiniz. İzleme, her işleme adımının tamamlanması için geçen süreyi milisaniye cinsinden verir. Bir adımın çok uzun sürdüğünü fark ederseniz düzeltici işlem yapabilirsiniz.
• Aşama ayrıntılarına bakarak arka uca gönderilen üstbilgileri kontrol edebilir, politikalar tarafından ayarlanan değişkenleri görüntüleyebilirsiniz.
• Temel yolu doğrulayarak bir politikanın mesajı doğru sunucuya yönlendirdiğinden emin olabilirsiniz.

Görüntüleme Seçeneklerini Belirleme

İzleme oturumu için görünüm seçeneklerini belirleyin.

İzleme sonuçlarını indirme

Ham izleme sonuçlarının XML dosyasını indirerek çevrimdışı olarak bir metin düzenleyicide görüntüleyip arayabilirsiniz. Dosyada, tüm başlıkların, değişkenlerin ve politikaların içeriği de dahil olmak üzere dinleme oturumunun tüm ayrıntıları gösterilir.

İndirmek için İzleme Oturumunu İndir'i tıklayın.

İstekleri curl olarak gösterme

Hedef sunucuya yapılan bir API çağrısını izledikten sonra isteği bir curl komutu olarak görüntüleyebilirsiniz. Bu, birkaç nedenden dolayı hata ayıklama için özellikle yararlıdır:

• API proxy'si isteği değiştirebilir. Bu nedenle, proxy'den hedef sunucuya yapılan isteğin orijinal istekten nasıl farklı olduğunu görmek faydalıdır. Curl komutu, değiştirilmiş isteği temsil eder.
• Daha büyük ileti yükleri için curl, HTTP üstbilgilerini ve ileti içeriğini tek bir yerde görmenize olanak tanır. (Şu anda yaklaşık 1.000 karakter sınırı vardır. Bu sınırı aşmayla ilgili ipucu için bu topluluk gönderisine göz atın.)

Güvenlik nedeniyle, curl özelliği HTTP yetkilendirme üstbilgisini maskeler.

Bir API çağrısı Trace'te tamamlandıktan sonra istekleri curl olarak görmek için İşlem Haritası diyagramında "Hedef sunucuya gönderilen istek" aşamasını seçin, ardından Ayrıntı penceresindeki "Hedef sunucuya gönderilen istek" sütununda Curl'ü göster düğmesini tıklayın.

Apigee, izleme kullanımını destekler

Apigee Edge, varsayılan olarak Apigee Desteği'nin destek sağlamak için API proxy'lerinizdeki İzleme aracını kullanmasına izin verir. Bu seçeneği istediğiniz zaman devre dışı bırakabilirsiniz. Ancak bu seçeneğin devre dışı bırakılması, Apigee Desteği'nin size destek sağlama imkanını sınırlayabilir.

Apigee Desteği'nin Trace aracını kullanmasını devre dışı bırakmak için:

1. https://Apigee.com/edge adresinde oturum açın.
2. Sol gezinme çubuğunda Yönetici > Gizlilik ve Güvenlik'i seçin.
3. Trace Desteği tarafından Trace aracının kullanılmasını devre dışı bırakmak için Apigee Desteği'ni Etkinleştir Trace'i Etkinleştir düğmesini tıklayın.