Analiz metrikleri, boyutları ve filtreleri referansı

Saniye başına ortalama işlem sayısı (yani API proxy istekleri). Bütçenizin nispeten düşük olması dönemdeki işlem sayısını, belirli bir dönemdeki her bir sayı ikiden küçükse kullanıcı arayüzü özel raporlarında saniye değeri sıfır olarak görünebilir ondalık basamak işaretidir.

API söz dizimi: tps

yanıt vermesi gerekir.

API söz dizimi: sum(cache_hit)

Belirli bir değer üzerinden işlem başına L1 (bellek içi) önbellekteki öğe sayısını döndürür unutmayın. Örneğin, bir günlük süre için max seçeneğini belirlerseniz ve O gün içinde önbellekteki en yüksek öğe sayısı belirli bir işlem için 12'dir. sayı 12 olur. avg için, ve önbellek sayıları 5, 6 ve 7 ise ortalama 6'dır. L1 önbellek, Dahili önbellek 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 kaynaklanan hatalardır. Örneğin, API Anahtarını Doğrula politikası, istekte geçersiz API anahtarı iletildiğinde oluşan hata ve Spike Arrest politikası API çağrılarının sayısı politikada tanımlanan sınırı aşarsa hata mesajı verir. ODK Bu metrik, API'lerinizdeki olası sorun noktalarını bulmak için yararlıdır. Örneğin, geliştirici uygulaması boyutuna göre gruplanan policy_error metrikleri, Belirli bir uygulama için bir API veya OAuth jetonunun süresinin dolduğu; ya da belirli bir çok sayıda Spike Arrest hatasına yol açtığını ve bunun da proxy'nin artış durdurma sınırı tatil trafiğindeki artışı hesaba katmaz.

Yalnızca hata, API proxy hatasıyla sonuçlanırsa analizlerde politika hatası kaydedilir. Örneğin, bir politikanın continueOnError özelliği true, politika başarısız olsa bile API proxy'si isteği işlemeye devam eder. Bu durumda, analizlerde politika hatası kaydedilmez.

Hata Üzerine Politika Adı (ax_execution_fault_policy_name) boyutu, Politika hatalarının politika adına göre gruplandırılması.

Bir hedef hatası (404 veya 503 gibi) politika hatası olarak sayılmaz. Bu sayısı API proxy hatası olarak sayılacaktır (is_error).

API söz dizimi: sum(policy_error)

Belirtilen dönemde API proxy'lerinin toplam başarısız olma sayısı. Proxy hatası, bir politika başarısız olduğunda veya bir çalışma zamanı hatası olduğunda (örneğin, 404 503 hatası vermelidir.

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

API söz dizimi: sum(is_error)

milisaniye cinsinden süre (ortalama, minimum veya maksimum) Edge'in gelen istekleri işlemesi için yeterlidir. Zaman, istek ulaştığında başlar. Edge, isteği hedef hizmete yönlendirdiğinde sona erer.

Farklı boyutlar kullanarak istek işleme gecikmelerini API proxy'sine göre inceleyebilirsiniz. bölge gibi adlar kullanabilirsiniz.

API söz dizimi: max(request_processing_latency)

Edge'in aldığı istek yükünün bayt cinsinden boyutu.

API söz dizimi: avg(request_size)

Yanıt Önbelleği politikasının belirli bir süre içinde toplam yürütme sayısı geçerlidir.

Yanıt Önbelleği politikası bir API proxy'sine iki yere eklendiğinden ( isteği ve yanıtta bir kez olduğunda) genellikle bir API çağrısında iki kez yürütülür. Önbellek "al" ve bir önbellek "put" her biri bir yürütme olarak sayılır.

Ancak, <SkipCacheLookup>. öğesi doğru (istekte) olarak değerlendirilir ve <SkipCachePopulation> öğesi doğru olarak değerlendirilir (yanıtta).

İzleme aracında, yürütülen bir API çağrısında Yanıt Önbelleği simgesini tıklayıp responsecache.executed akış değişkenini önbellek yürütme olup olmadığını kontrol edin (1 değeri).

API söz dizimi: sum(ax_cache_executed)

milisaniye cinsinden süre (ortalama, minimum veya maksimum) yanıt vermesi için Edge'in gerektiğini unutmayın. Zaman, API proxy'si Apigee, hedef hizmet yanıtına ilettiğinde sona erer. arayan

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

API söz dizimi: min(response_processing_latency)

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

API söz dizimi: max(response_size)

Hedef hizmetten alınan toplam 5xx yanıt sayısı. Bunlar hedef hizmet hatalara neden olabilir.

API söz dizimi: sum(target_error)

Projenin yaşam döngüsü boyunca (toplam, ortalama, minimum veya maksimum) milisaniye değerindedir. Bu metrik hedef sunucuların nasıl performans gösterdiğini belirtir. Edge bir isteği yönlendirdiğinde zaman başlar alır ve Edge yanıtı aldığında sona erer.

Bir API çağrısı önbellekten yanıt döndürürse (Yanıt Önbelleği politika ile ilişkilendirdiğinizde) çağrı, hiçbir zaman hedef hizmete ulaşmaz, yanıt süresi metrikleri günlüğe kaydedilir.

API söz dizimi: avg(target_response_time)

Projenin yaşam döngüsü boyunca (toplam, ortalama, minimum veya maksimum) milisaniye, Edge'in bir istemciden istek aldığı andan itibaren Edge, yanıtı istemciye geri gönderir. Bu süre, ağ ek yükünü ( gereken süreden bağımsız olarak, yük dengeleyicilerin ve yönlendiricilerin işlerini tamamlamaları için geçen süre), istek işleme gecikme, yanıt işleme gecikmesi ve hedef yanıt süresi (yanıt sunulursa) hedef hizmetten alınır).

Farklı boyutlar kullanarak, işleme gecikmelerini API proxy'sine göre inceleyebilirsiniz. bölge gibi adlar kullanabilirsiniz.

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ı olan şekilde gruplandırmak için 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 nedenle çağrı yapan geliştirici uygulamalarının bir veya daha fazla API ile ilişkilendirilmiş olması gerekir. API proxy'lerini içeren ürünler ve çağrılan proxy'ler bir API anahtarı veya OAuth jetonu ile birlikte gönderilir. Anahtar veya jeton bir API ile ilişkilendirilmiş belirler. Daha fazla bilgi için bkz. Öncelikle: Eksiksiz analiz verileri nasıl oluşturulur?

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. Şu kaynakları da inceleyin: Analytics varlığı değeri "(not set)" nedir? ne anlama geliyor? gibi sorular sorabilirsiniz.

Erişilen Yanıt Önbelleği değerini içeren anahtar. Daha fazla bilgi için anahtarın yanıt önbelleği için nasıl oluşturulduğu hakkında bilgi için Yanıt Önbelleği politikasına bakın.

İzleme aracında, okuma yapan 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__ ön ekini alır. Örneğin, kuruluş "foo" ise "the" “test” ortamıdır, ve önbellek adı "myCache" ise ax_cache_name foo__test__myCache.

İzleme aracında, bir Yanıt Önbelleği politikası seçtiğinizde bu değeri responsecache.cachename akış değişkeni.

Yanıt Önbelleğinin alındığı önbellek düzeyi ("L1" bellek içi veya "L2" veritabanı) alındı. Bu boyutta "CACHE_MISS" de gösterilir yanıtın ne zaman önbellek yerine hedef (ve yanıt önbelleği, hedef yanıtla yenilenmiş); bir önbellek anahtarı geçersizse veya istekteki bir önbellek anahtarı geçersizse. Önbellek anahtarları şununla sınırlıdır: 2 KB boyutunda.

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

Önbellek düzeyleri hakkında daha fazla bilgi için Önbellek dahili verileri başlıklı makaleye bakın.

API çağrıları yapan geliştirici uygulamasının tüketici anahtarı (API anahtarı) veya OAuth jetonlarına dahil edilmelidir.

Bu boyutu almak için, çağrı alan proxy'lerin kontrol edilecek şekilde yapılandırılması gerekir test edilmesini sağlayın. Geliştirici uygulamaları API anahtarları alır. Bunlar şu amaçlarla kullanılabilir: OAuth jetonları oluşturabilirsiniz. Daha fazla bilgi için bkz. Öncelikle: Eksiksiz analiz verileri nasıl oluşturulur?

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. Ayrıca, Analytics varlığı için "(not set)" değeri ne anlama gelir? bölümüne de göz atın. ne anlama geliyor? gibi sorular sorabilirsiniz.

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

Bu boyutu almak için uygulamaların bir veya daha fazla API ürünüyle ilişkilendirilmesi gerekir ve proxy'lerin bir API anahtarı veya API çağrısıyla gönderilen OAuth jetonu. Anahtar veya jeton geliştirici uygulamasını tanımlar. Örneğin, Öncelikle: 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. Ayrıca, Analytics varlığı için "(not set)" değeri ne anlama gelir? bölümüne de göz atın. ne anlama geliyor? gibi sorular sorabilirsiniz.

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

Bu boyutu almak için geliştiricilerin bir veya daha fazlasıyla ilişkilendirilmiş uygulamaları olmalıdır Çağrılan API proxy'lerini içeren API ürünleri ile proxy'lerin belirli bir API çağrısıyla gönderilen API anahtarı veya OAuth jetonu. Anahtar veya jeton geliştiriciyi tanımlar uygulamasını indirin. Daha fazla bilgi için Öncelikle: Eksiksiz analiz verileri oluşturma bölümüne bakın.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. Ayrıca, Analytics varlığı için "(not set)" değeri ne anlama gelir? bölümüne de göz atın. ne anlama geliyor? gibi sorular sorabilirsiniz.

Edge'in oluşturduğu benzersiz geliştirici kimliği: org_name@@@org_name.

Bu boyutu almak için geliştiricilerin bir veya daha fazlasıyla ilişkilendirilmiş uygulamaları olmalıdır Çağrılan API proxy'lerini içeren API ürünleri; proxy'lerin API çağrılarıyla gönderilen API anahtarı veya OAuth jetonu. Anahtar veya jeton geliştiriciyim. Daha fazla bilgi için Öncelikle: Eksiksiz analiz verileri oluşturma bölümüne bakın.

Yukarıdaki ölçütler karşılanmazsa "(not set)" değerini görürsünüz. Ayrıca, Analytics varlığı için "(not set)" değeri ne anlama gelir? bölümüne de göz atın. ne anlama geliyor? gibi sorular sorabilirsiniz.

Hatanın hata kodu. Örnek: messaging.adaptors.http.flow.GatewayTimeout.

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

Yönetim API'sinde kullanılacak tam ad şudur: ax_execution_fault_flow_name, kullanabilirsiniz.

Hata oluşmadığında "(not set)" değeri gösterilir.

"PROXY_REQ_FLOW" gibi hatalara yol açan API proxy akışının adı veya "TARGET_RESP_FLOW".

Management API'de kullanılacak tam ad şudur: ax_execution_fault_flow_state, kullanabilirsiniz.

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

Management API'de kullanılacak tam ad şudur: ax_execution_fault_policy_name, kullanabilirsiniz.

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

API proxy ProxyEndpoint üzerinde yapılandırılan BasePath. Temel yol alan adı ve bağlantı noktası kısmını oluşturur. Örneğin, bir API proxy'sinin temel URL'si https://Apigeedocs-test.connector.net/releasenotes/ için temel yol /releasenotes şeklindedir.

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

API proxy'si temel yoluna eklenen kaynak yolu. Örneğin, bir API proxy'sinin temel URL https://apigeedocs-test.apigee.net/hello/ olur ve https://apigeedocs-test.apigee.net/hello/json, yol eki /json.

Herhangi bir path ek değeri kullanılmıyorsa değer boş olur.

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

Kaynak istemci IP adresini içerir. ax_resolved_client_ip değeri boyut, ax_true_client_ip ve x_forwarded_for_ip boyut.

İstemcilerin gerçek IP adreslerini yakalamak için Akamai gibi yönlendirme ürünlerini kullanırken istemci IP'si, True-Client-IP HTTP üst bilgisinde Edge'e iletilir. sonra ax_true_client_ip boyutunu ayarlamak için kullanılır.

ax_resolved_client_ip boyutunun değeri şu şekilde hesaplanır:

1. ax_true_client_ip boş değilse ve yerel IP adresi içermiyorsa ardından ax_resolved_client_ip öğesini ax_true_client_ip olarak ayarlayın.
2. Diğer durumlarda ax_resolved_client_ip adresini şuradaki ilk yerel olmayan IP adresi olarak ayarlayın: x_forwarded_for_ip.
3. Hem ax_true_client_ip hem de x_forwarded_for_ip şunları içeriyorsa: yerel IP adreslerini kullanarak, ax_resolved_client_ip öğesini x_forwarded_for_ip konumundaki ilk yerel IP adresi.
4. Hem ax_true_client_ip hem de x_forwarded_for_ip boşsa ax_resolved_client_ip öğesini (not set) olarak ayarla.
5. ax_true_client_ip bir yerel IP adresi ve x_forwarded_for_ip ise boş, ax_resolved_client_ip değerini (not set) olarak ayarlayın.

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

Bunu ikinci bir "ayrıntı" olarak kullanmak İşletim sistemi Ailesi (ax_ua_os_family) adresini ziyaret edin.

Arayan istemcinin IP adresi (proxy.client.ip içinde saklanır) akış değişkeni değerini girin. Bu genellikle gelen aramanın X-Forwarded-For adresidir. Bu, Edge'in son harici TCP el sıkışmasından aldığı IP adresidir. Bu çağrı yapan istemci veya yük dengeleyici olmalıdır. Aynı X-Forwarded-For üstbilgisi, listelenen son IP'dir.

İstemcilerin gerçek IP adreslerini yakalamak için Akamai gibi yönlendirme ürünlerini kullanırken istemci IP'leri, True-Client-IP HTTP üst bilgisinde Edge'e iletilir. Bu boyutu, söz konusu başlıktan bu gerçek istemci IP'lerini yakalar.

Orijinal istemci IP adresini belirlemek için ax_resolved_client_ip aracılığıyla erişilir boyutunu kullanıyorsanız Edge, ax_true_client_ip ve x_forwarded_for_ip boyut.

Sorgu hariç, hedef hizmete giden kaynak yolu (alan hariç) parametreleridir.

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net karşılama mesajı döndüren /user dahil olmak üzere çeşitli kaynaklar içeriyor. API proxy'nizin http://mocktarget.apigee.net/user çağrısı yapma şekline bakılmaksızın, request_path: /user

Sorgu dahil olmak üzere hedef hizmete giden kaynak yolu (alan hariç) parametreleridir.

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net /user?user={name} kaynak ve sorgu dahil olmak üzere çeşitli kaynaklar içerir parametresini kullanabilirsiniz. API'nizin her iki durumda da proxy http://mocktarget.apigee.net/user?user=Dude çağırıyor, request_uri ise /user?user=Dude.

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'dan telefon eden 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
• bir terminalden cURL: curl/7.51.0

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

Bunu ikinci bir "ayrıntı" olarak kullanmak Kullanıcı Aracısı Ailesi ile boyut (ax_ua_agent_family) yazın.

Sorgu hariç, hedef hizmete giden kaynak yolu (alan hariç) proxy'nin <TargetEndpoint> parametresinde tanımlanan parametrelerden biridir.

Ö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 değeridir.

Hedef şu olsaydı:

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

target_basepath boş olur.

İzleme aracında akış diyagramının sonundaki AX simgesini seçin, target.basepath akış değişkeni target_basepath boyutu

Hedef hizmet tarafından API proxy'sine döndürülen HTTP yanıt durum kodu. Örneğin: 200, 404, 503 vb.

"null" değeri isteğin hiçbir zaman hedef hizmete ulaşmadığı anlamına gelir. Bu, yanıt, Yanıt Önbelleği politikası tarafından veya istekte bir hata olduğunda sunulur bahsedeceğim.

Bu, Yanıt Durumu Kodu'ndan farklıdır (response_status_code) boyutunu ekleyebilirsiniz.

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, target_url http://mocktarget.apigee.net/user?user=Dude

URL'nin, target.url akış değişkeni.

proxy'de zincirleme ve komut dosyası kullanılırken hedefler (Node.js) için çağrı proxy'sindeki target_url değeri null olur.

X-Forwarded-For üstbilgisindeki IP adreslerinin listesi.

Orijinal istemci IP adresini belirlemek için ax_resolved_client_ip aracılığıyla erişilir boyutunu kullanıyorsanız Edge, ax_true_client_ip ve x_forwarded_for_ip boyut.

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

Zaman değeri UTC'dir.