Analiz metrikleri, boyutları ve filtreleri referansı

Saniye başına ortalama işlem sayısı (API proxy istekleri). Dönem boyunca nispeten az sayıda işlem yaptıysanız bu sayının iki ondalık basamaktan küçük olması durumunda kullanıcı arayüzündeki özel raporlarda saniyede ortalama işlem sayısı sıfır olarak görünebilir.

API söz dizimi: tps

Hedef hizmetten gelen yanıt yerine yanıt önbelleğini kullanan başarılı API isteklerinin sayısı.

API söz dizimi: sum(cache_hit)

Belirli bir süre boyunca işlem başına L1 (bellek içi) önbellekteki öğe sayısını döndürür. Örneğin, bir günlük dönem için max seçerseniz ve bu gün içinde belirli bir işlem için önbellekteki en yüksek öğe sayısı 12 olursa sayı 12 olur. avg için, sorguladığınız dönemde üç işlem varsa ve bunların önbellek sayıları 5, 6 ve 7 ise ortalama 6'dır. L1 önbelleği, Önbellek iç yapıları bölümünde açıklandığı gibi L2 veritabanı önbelleğinin aksine bellek içi önbellektir.

API söz dizimi: avg(ax_cache_l1_count)

Belirtilen dönemdeki toplam politika hatası sayısı.

Politika hataları genellikle tasarımdan kaynaklanır. Örneğin, API anahtarını doğrulama politikası, istekte geçersiz bir API anahtarı iletildiğinde hata verir. Ani artışları önleme politikası ise API çağrılarının sayısı politikada tanımlanan sınırı aştığında hata verir. Bu nedenle, bu metrik API'lerinizdeki olası sorunlu noktaları bulmak için yararlıdır. Örneğin, geliştirici_uygulaması boyutuna göre gruplandırılmış politika_hatası metrikleri, belirli bir uygulama için API anahtarının veya OAuth jetonunun süresinin dolduğunu keşfetmenize yardımcı olabilir. Ayrıca, belirli bir API proxy'sinin çok sayıda ani trafik kontrolü hatası verdiğini görebilir ve bu durum, proxy'nin ani trafik kontrolü sınırının, tatil trafiğindeki artışı hesaba katmadığını keşfetmenize yol açabilir.

Politika hatası, yalnızca hatanın API proxy'sinin başarısız olmasına neden olması durumunda analizlere kaydedilir. Örneğin, bir politikanın continueOnError özelliği true olarak ayarlanırsa API proxy'si, politika başarısız olsa bile isteği işlemeye devam eder. Bu durumda, Analytics'te politika hatası kaydedilmez.

Hata Üzerindeki Politika Adı (ax_execution_fault_policy_name) boyutu, politika hatalarını politika adına göre gruplandırmak için kullanışlıdır.

Hedef hatası (ör. 404 veya 503) politika hatası olarak sayılmaz. Bunlar, API proxy'si hataları (is_error) olarak sayılır.

API söz dizimi: sum(policy_error)

Belirtilen dönemde API proxy'lerinin toplam başarısızlık sayısı. Proxy hatası, bir politika başarısız olduğunda veya hedef hizmetten 404 ya da 503 gibi bir çalışma zamanı hatası olduğunda oluşabilir.

Proxy (apiproxy) boyutu, API proxy'si hatalarını proxy'ye göre gruplandırmak için kullanışlıdır.

API söz dizimi: sum(is_error)

Edge'in gelen istekleri işlemesi için gereken süre (ortalama, minimum veya maksimum) milisaniye cinsinden. Bu süre, istek Edge'e ulaştığında başlar ve Edge isteği hedef hizmete ilettiğinde sona erer.

Farklı boyutlar kullanarak istek işleme gecikmelerini API proxy'sine, geliştirici uygulamasına, bölgeye vb. göre inceleyebilirsiniz.

API söz dizimi: max(request_processing_latency)

Edge tarafından alınan istek yükünün bayt cinsinden boyutu.

API söz dizimi: avg(request_size)

Belirli bir süre içinde yanıt önbelleği politikasının yürütülme sayısı.

Yanıt önbelleği politikası bir API proxy'sinde iki yere (bir kez istekte, bir kez de yanıtta) eklendiğinden genellikle bir API çağrısında iki kez yürütülür. Bir önbellek "get" ve bir önbellek "put" işlemi, her biri bir yürütme olarak sayılır.

Ancak, politikadaki <SkipCacheLookup> öğesi (istekte) doğru olarak değerlendirilirse yanıt önbelleği yürütme sayısı 0, politikadaki <SkipCachePopulation> öğesi (yanıtta) doğru olarak değerlendirilirse 0 olur.

İzleme aracında, yürütülen bir API çağrısında yanıt önbelleği simgesini tıklayabilir ve önbellek yürütülüp yürütülmediğini (1 değeri) görmek için responsecache.executed akış değişkenini görüntüleyebilirsiniz.

API söz dizimi: sum(ax_cache_executed)

Edge'in API yanıtlarını işlemesi için gereken süre (ortalama, minimum veya maksimum) milisaniye cinsinden. Bu süre, API proxy'si hedef hizmet yanıtını aldığında başlar ve Apigee yanıtı orijinal arayana ilettiğinde sona erer.

Farklı boyutlar kullanarak yanıt işleme gecikmelerini API proxy'sine, bölgeye vb. göre inceleyebilirsiniz.

API söz dizimi: min(response_processing_latency)

İstemciye döndürülen yanıt yükünün bayt cinsinden boyutu.

API söz dizimi: max(response_size)

Hedef hizmetten gelen toplam 5xx yanıt sayısı. Bunlar, Apigee'den kaynaklanmayan hedef hizmet hatalarıdır.

API söz dizimi: sum(target_error)

Hedef sunucunun bir çağrıya yanıt vermesi için gereken süre (toplam, ortalama, minimum veya maksimum) milisaniye cinsinden. Bu metrik, hedef sunucuların performansını gösterir. Bu süre, Edge bir isteği hedef hizmete ilettiğinde başlar ve Edge yanıtı aldığında sona erer.

Bir API çağrısı önbellekten yanıt döndürürse (örneğin, yanıt önbelleği politikası kullanılarak) çağrı hiçbir zaman hedef hizmete ulaşmaz ve hedef yanıt süresi metrikleri kaydedilmez.

API söz dizimi: avg(target_response_time)

Edge'in bir istemciden istek aldığı andan yanıtı istemciye geri gönderdiği ana kadar geçen süre (toplam, ortalama, minimum veya maksimum) milisaniye cinsinden. Bu süreye ağ ek yükü (ör. yük dengeleyicilerin ve yönlendiricilerin işlerini yapması için gereken süre), istek işleme gecikmesi, yanıt işleme gecikmesi ve yanıtın önbellek yerine hedef hizmetten sunulması durumunda hedef yanıt süresi dahildir.

Farklı boyutlar kullanarak API proxy'si, geliştirici uygulaması, bölge vb. göre işleme gecikmelerini inceleyebilirsiniz.

API söz dizimi: avg(total_response_time)

Belirtilen dönemde Edge tarafından işlenen toplam API çağrısı sayısı.

Trafik sayılarını sizin için en anlamlı şekilde gruplandırmak amacıyla boyutları kullanın.

API söz dizimi: sum(message_count)

Çağrılan API proxy'lerini içeren API ürününün adı. Bu boyutu alabilmek için çağrı yapan geliştirici uygulamalarının, API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkilendirilmesi ve çağrılan proxy'lerin, API çağrısıyla gönderilen bir API anahtarını veya OAuth jetonunu kontrol etmesi gerekir. Anahtar veya jeton bir API ürünüyle ilişkilendirilmiştir. Daha fazla bilgi için Öncelikli konular: Eksiksiz analiz verileri nasıl oluşturulur? başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. Ayrıca Bir analiz varlığı değeri olan "(not set)" ne anlama gelir? başlıklı makaleyi de inceleyin.

Erişilen yanıt önbelleği değerini içeren anahtar. Yanıt önbelleği için anahtarın nasıl oluşturulduğu hakkında daha fazla bilgi edinmek için Yanıt önbelleği politikası başlıklı makaleyi inceleyin.

İzleme aracında, önbellekten okuyan veya önbelleğe yazan bir yanıt önbelleği politikası seçtiğinizde bu değeri responsecache.cachekey akış değişkeninde görebilirsiniz.

Yanıt önbelleği politikası tarafından kullanılan anahtarları/değerleri içeren önbelleğin adı. orgName__envName__ önekiyle başlar. Örneğin, kuruluş "foo", ortam "test" ve önbellek adı "myCache" ise ax_cache_name foo__test__myCache olur.

İzleme aracında, bir yanıt önbelleği politikası seçtiğinizde bu değeri responsecache.cachename akış değişkeninde görebilirsiniz.

Yanıt önbelleğinin alındığı önbellek düzeyi ("L1" bellek içi veya "L2" veritabanı). Bu boyut, yanıt önbellekten değil hedeften sunulduğunda (ve yanıt önbelleği hedef yanıtla yenilendiğinde) veya istekteki bir önbellek anahtarı geçersiz olduğunda "CACHE_MISS" değerini de gösterir. Önbellek anahtarlarının boyutu 2 KB ile sınırlıdır.

İzleme aracında, Yanıt önbelleği politikasını seçtiğinizde bu değeri responsecache.cachesource akış değişkeninde görebilirsiniz.

Önbellek düzeyleri hakkında daha fazla bilgi için Önbellek iç yapıları başlıklı makaleyi inceleyin.

API çağrılarını yapan geliştirici uygulamasının tüketici anahtarı (API anahtarı), isteğe API anahtarı olarak iletilmiş veya OAuth jetonlarına dahil edilmiş olsun.

Bu boyutu elde etmek için, çağrı alan proxy'lerin geçerli bir API anahtarı veya OAuth jetonu kontrol edecek şekilde yapılandırılması gerekir. Geliştirici uygulamaları, Edge'e kaydedildiklerinde OAuth jetonları oluşturmak için kullanılabilecek API anahtarları alır. Daha fazla bilgi için Öncelikli konular: Eksiksiz analiz verileri nasıl oluşturulur? başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. "(not set)" analiz varlığı değeri ne anlama gelir? başlıklı makaleyi de inceleyin.

API çağrıları yapan Edge'e kayıtlı geliştirici uygulaması.

Bu boyutu elde etmek için uygulamaların, çağrılan API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkilendirilmesi ve proxy'lerin, API çağrısıyla gönderilen bir API anahtarını veya OAuth jetonunu kontrol etmesi gerekir. Anahtar veya jeton, geliştirici uygulamasını tanımlar. Daha fazla bilgi için Öncelikle: Nasıl eksiksiz analiz verileri oluşturulur? başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. "(not set)" analiz varlığı değeri ne anlama gelir? başlıklı makaleyi de inceleyin.

Uygulaması API çağrıları yapan Edge'e kayıtlı geliştiricilerin e-posta adresi.

Bu boyutu elde etmek için geliştiricilerin, çağrılan API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkili uygulamaları olmalıdır ve proxy'ler, API çağrısıyla gönderilen bir API anahtarını veya OAuth jetonunu kontrol etmelidir. Anahtar veya jeton, geliştirici uygulamasını tanımlar. Daha fazla bilgi için Öncelikle: Nasıl eksiksiz analiz verileri oluşturulur? başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. "(not set)" analiz varlığı değeri ne anlama gelir? başlıklı makaleyi de inceleyin.

org_name@@@unique_id biçiminde, Edge tarafından oluşturulan benzersiz geliştirici kimliği.

Bu boyutu elde etmek için geliştiricilerin, çağrılan API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkili uygulamaları olmalıdır ve proxy'ler, API çağrılarıyla gönderilen bir API anahtarını veya OAuth jetonunu kontrol etmelidir. Anahtar veya jeton, geliştiriciyi tanımlar. Daha fazla bilgi için Öncelikli konular: Eksiksiz analiz verileri oluşturma başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. "(not set)" analiz varlığı değeri ne anlama gelir? başlıklı makaleyi de inceleyin.

Hatayla ilgili arıza kodu. Örneğin: messaging.adaptors.http.flow.GatewayTimeout

Bir API proxy'sinde hata oluşturan adlandırılmış akış. Örneğin, "PreFlow", "PostFlow" veya oluşturduğunuz koşullu akışın adı.

Yönetim API'sinde kullanılacak tam adın satır sonu olmadan ax_execution_fault_flow_name olduğunu unutmayın.

Hata oluşmayan yerlerde "(not set)" değerini görürsünüz.

Hata oluşturan API proxy akışı durumlarının adı (ör. "PROXY_REQ_FLOW" veya "TARGET_RESP_FLOW").

Yönetim API'sinde kullanılacak tam adın, satır sonu olmadan ax_execution_fault_flow_state olduğunu unutmayın.

Hata veren ve API çağrısının başarısız olmasına neden olan politikanın adı.

Yönetim API'sinde kullanılacak tam adın satır sonu olmadan ax_execution_fault_policy_name olduğunu unutmayın.

Bir politika hata verirse ancak politika kök özelliği continueOnError true olarak ayarlanmışsa API proxy akışı hatasız devam eder ve politika hatası bu boyutta sayılmaz.

API proxy'si ProxyEndpoint'inde yapılandırılan BasePath. Temel yol, API proxy'si URL'sinin alan adı ve bağlantı noktası bölümünü içermez. Örneğin, bir API proxy'sinin temel URL'si https://apigeedocs-test.apigee.net/releasenotes/ ise temel yol /releasenotes olur.

Değer, proxy.basepath akış değişkeninde de depolanır.

Kaynak yolu, API proxy'sinin temel yoluna eklenir. Örneğin, bir API proxy'sinin temel URL'si https://apigeedocs-test.apigee.net/hello/ ise ve https://apigeedocs-test.apigee.net/hello/json için bir çağrı yapılıyorsa pathsuffix /json olur.

Yol son eki kullanılmıyorsa değer boştur.

Değer, proxy.pathsuffix akış değişkeninde de depolanır.

Kaynak istemcinin IP adresini içerir. ax_resolved_client_ip boyutunun değeri, ax_true_client_ip ve x_forwarded_for_ip boyutlarındaki değerlerden hesaplanır.

Müşterilerin gerçek IP adreslerini yakalamak için Akamai gibi yönlendirme ürünleri kullanıldığında, istemci IP'sinin True-Client-IP HTTP başlığında Edge'e aktarıldığını ve ardından ax_true_client_ip boyutunu ayarlamak için kullanıldığını unutmayın.

ax_resolved_client_ip boyutunun değeri aşağıdaki şekilde hesaplanır:

1. ax_true_client_ip boş değilse ve yerel bir IP adresi içermiyorsa ax_resolved_client_ip değerini ax_true_client_ip olarak ayarlayın.
2. Aksi takdirde, ax_resolved_client_ip değerini x_forwarded_for_ip içindeki ilk yerel olmayan IP adresi olarak ayarlayın.
3. Hem ax_true_client_ip hem de x_forwarded_for_ip yalnızca yerel IP adresleri içeriyorsa ax_resolved_client_ip öğesini x_forwarded_for_ip içindeki ilk yerel IP adresine ayarlayın.
4. Hem ax_true_client_ip hem de x_forwarded_for_ip boşsa ax_resolved_client_ip değerini (not set) olarak ayarlayın.
5. ax_true_client_ip yerel bir IP adresi ve x_forwarded_for_ip null ise ax_resolved_client_ip değerini (not set) olarak ayarlayın.

Aramayı yapan cihazın işletim sistemi sürümü.

İşletim sistemi sürümlerini görmek için bunu işletim sistemi ailesi (ax_ua_os_family) ile birlikte ikinci bir "detaylandırma" boyutu olarak kullanmak faydalıdır.

Arayan istemcinin IP adresi, proxy.client.ip akış değişkeninde saklanır. Bu genellikle gelen çağrının X-Forwarded-For adresidir. Bu, Edge'in son harici TCP el sıkışmasından aldığı IP adresidir. Bu, arayan istemci veya bir yük dengeleyici olabilir. X-Forwarded-For üstbilgisinde birden fazla IP olduğunda bu, listelenen son IP'dir.

Müşterilerin gerçek IP adreslerini yakalamak için Akamai gibi yönlendirme ürünleri kullanılırken, istemci IP'leri HTTP üstbilgisinde True-Client-IP Edge'e iletilir. Bu boyut, söz konusu başlıkta yer alan gerçek istemci IP'lerini yakalar.

ax_resolved_client_ip boyutu üzerinden erişilen orijinal istemci IP adresini belirlemek için Edge, ax_true_client_ip ve x_forwarded_for_ip boyutlarını kullanır.

Sorgu parametreleri hariç olmak üzere hedef hizmetin kaynak yolu (alan adı dahil değildir).

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net, selamlama döndüren /user dahil olmak üzere çeşitli kaynaklar içerir. API proxy'niz http://mocktarget.apigee.net/user çağrısı yaptığında istek yolu /user olur.

Sorgu parametreleri de dahil olmak üzere hedef hizmetin kaynak yolu (alan adı hariç).

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net /user?user={name} kaynağı ve sağlanan ada özel bir selamlama döndürmek için sorgu parametresi dahil olmak üzere çeşitli kaynaklar içerir. API proxy'niz http://mocktarget.apigee.net/user?user=Dude çağrısı yaptığında request_uri /user?user=Dude olur.

API çağrısı yapmak için kullanılan kullanıcı aracısının veya yazılım aracısının adı. Örnekler:

• Chrome üzerinden arama yapan bir Pixel XL: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
• Chrome üzerinden arama yapan bir iPad: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
• Terminalden cURL: curl/7.51.0

Kullanıcı aracısının sürümü.

Aracı ailesinin sürümünü almak için bunu, kullanıcı aracısı ailesi (ax_ua_agent_family) ile ikinci bir "detaylandırma" boyutu olarak kullanmak faydalıdır.

Hedef hizmetin kaynak yolu (alan adı hariç), sorgu parametreleri hariç olmak üzere, proxy'nin <TargetEndpoint> içinde tanımlanır.

Örneğin, bir API proxy'sinin aşağıdaki hedefi çağırdığını varsayalım:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Bu örnekte, target_basepath /user'dir.

Hedef şu olsaydı:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath boş olur.

İzleme aracında akış şemasının sonundaki AX simgesini seçtiğinizde target.basepath akış değişkeni, target_basepath boyutuyla eşlenir.

Hedef hizmetin API proxy'sine döndürdüğü HTTP yanıt durum kodu (ör. 200, 404, 503 vb.).

"null" değeri, isteğin hedef hizmete hiçbir zaman ulaşmadığı anlamına gelir. Bu durum, yanıtın yanıt önbelleği politikası tarafından sunulması veya istek işleme sırasında bir hata oluşması durumunda meydana gelir.

Bu, Yanıt Durumu Kodu (response_status_code) boyutundan farklıdır.

Bir API proxy'sinin TargetEndpoint'inde tanımlanan hedef hizmetin tam URL'si.

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Bu örnekte, hedef URL http://mocktarget.apigee.net/user?user=Dude şeklindedir.

URL'nin, API proxy işleme sırasında target.url akış değişkeniyle de geçersiz kılınabileceğini unutmayın.

Proxy zincirleme işleminde ve komut dosyası hedefleri (Node.js) kullanılırken çağıran proxy'deki target_url değeri null olur.

X-Forwarded-For üstbilgisindeki IP adreslerinin listesi.

ax_resolved_client_ip boyutu üzerinden erişilen orijinal istemci IP adresini belirlemek için Edge, ax_true_client_ip ve x_forwarded_for_ip boyutlarını kullanır.

24 saatlik saate göre, API çağrılarının yapıldığı 2 haneli saat. Örneğin, 22:00 ile 23:00 arasında yapılan API çağrılarında ax_hour_of_day değeri 22 olur.

Zaman değeri UTC'dir.