Analiz metrikleri, boyutları ve filtreleri referansı

Saniye başına ortalama işlem sayısı (yani API proxy isteği sayısı). Dönem içindeki işlem sayınız nispeten azsa, bu sayı iki ondalık basamaktan küçükse kullanıcı arayüzü özel raporlarında saniyedeki 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 dönemde işlem başına L1 (bellek içi) önbellekteki öğe sayısını döndürür. Örneğin, bir günün süresi için max seçerseniz ve o 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 olur. 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 kaynaklanır. Örneğin, istekte geçersiz bir API anahtarı iletildiğinde API Anahtarını Doğrulama politikası hata bildirir ve API çağrılarının sayısı politikada tanımlanan sınırı aşarsa Spike Arrest politikası hata bildirir. Dolayısıyla bu metrik, API'lerinizdeki olası sorunlu noktaları bulmak için yararlıdır. Örneğin, developer_app boyutuna göre gruplandırılmış policy_error metrikleri, belirli bir uygulama için bir API anahtarının veya OAuth jetonunun süresinin dolduğunu keşfetmenize yardımcı olabilir ya da belirli bir API proxy'sinin çok sayıda Spike Arrest hatasına yol açtığını ve bunun da tatil trafiğindeki artışın proxy'deki artış durdurma sınırından kaynaklanmadığını keşfetmenizi sağladığını görebilirsiniz.

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

Hatayla İlgili Politika Adı (ax_execution_fault_policy_name) boyutu, politika hatalarının politika adına göre gruplandırılması için yararlıdır.

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

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 hedef hizmetten 404 ya da 503 gibi bir çalışma zamanı hatası olduğunda ortaya çıkabilir.

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)

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

Farklı boyutları kullanarak istek işleme gecikmelerini API proxy'si, geliştirici uygulaması, bölge ve benzeri ölçütlere 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)

Bir Yanıt Önbelleği politikasının belirli bir dönem içinde toplam yürütülme sayısı.

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

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

İzleme aracında, yürütülen bir API çağrısında Yanıt Önbelleği simgesini tıklayıp bir önbellek yürütmesi (1 değeri) olup olmadığını 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 çağrıya ilettiğinde sona erer.

Farklı boyutları kullanarak yanıt işleme gecikmelerini API proxy'si, bölge ve benzeri ölçütlere 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 5xx yanıtlarının toplam 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 milisaniye cinsinden süre (toplam, ortalama, minimum veya maksimum). Bu metrik, hedef sunucuların nasıl performans gösterdiğini belirtir. Bu süre, Edge'in bir isteği hedef hizmete yönlendirdiğinde başlar ve yanıtı aldığında sona erer.

Bir API çağrısı önbellekten yanıt döndürürse (ör. Yanıt Önbelleği politikası kullanılarak) çağrının hedef hizmete hiçbir zaman ulaşmayacağını ve hedef yanıt süresi metriklerinin kaydedilmediğini unutmayın.

API söz dizimi: avg(target_response_time)

Edge'in istemciden istek alması ile Edge'in yanıtı istemciye geri göndermesi arasındaki milisaniye cinsinden süre (toplam, ortalama, minimum veya maksimum). Bu süreye ağ ek yükü (yük dengeleyicilerin ve yönlendiricilerin işlerini yapmaları için gereken süre), istek işleme gecikmesi, yanıt işleme gecikmesi ve hedef yanıt süresi (yanıt, önbellek yerine hedef hizmetten sunuluyorsa) dahildir.

Farklı boyutları kullanarak işleme gecikmelerini API proxy'si, geliştirici uygulaması, bölge ve benzeri ölçütlere göre 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ı olacak ş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 boyutu elde etmek için çağrıları yapan geliştirici uygulamalarının, API proxy'leri 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ı veya OAuth jetonu olup olmadığını kontrol etmesi gerekir. Anahtar veya jeton bir API ürünüyle ilişkilendirilmiş olmalıdır. Daha fazla bilgi için Öncelikle: Eksiksiz analiz verileri nasıl oluşturulur? bölümüne bakın.

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

Erişilen Yanıt Önbelleği değerini içeren anahtar. Anahtarın yanıt önbelleği için nasıl oluşturulduğu hakkında daha fazla bilgi için Yanıt Önbelleği politikası bölümüne bakın.

İzleme aracında, önbelleğe 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 ve önünde orgName__envName__ olan önbelleğin adı. Örneğin, kuruluş "foo" ise ortam "test" ve önbellek adı "myCache" ise ax_cache_name ise 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 önbellek yerine hedeften sunulduğunda (ve yanıt önbelleği hedef yanıtla yenilendiğinde) veya istekteki bir önbellek anahtarı geçersiz olduğunda da "CACHE_MISS" ifadesini 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 Dahili önbellek konusuna bakın.

API çağrılarını yapan geliştirici uygulamasının tüketici anahtarı (API anahtarı). İster API anahtarı olarak isterse OAuth jetonları olarak eklenmiş olsun, istekte bulunur.

Bu boyutu elde etmek için çağrı alan proxy'ler, geçerli bir API anahtarı veya OAuth jetonu olup olmadığını kontrol edecek şekilde yapılandırılmalıdır. Geliştirici uygulamaları, uygulamalar Edge'e kaydedildiğinde OAuth jetonları oluşturmak için kullanılabilen API anahtarlarını alır. Daha fazla bilgi için Öncelikle: Eksiksiz analiz verileri nasıl oluşturulur? bölümüne bakın.

Yukarıdaki ölçütler karşılanmazsa "(ayarlanmadı)" değerini görürsünüz. Analytics varlık değeri "(not set)" ne anlama gelir? bölümünü de inceleyin.

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

Bu boyutu almak 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ı veya OAuth jetonu olup olmadığını kontrol etmesi gerekir. Anahtar veya jeton, geliştirici uygulamasını tanımlar. Daha fazla bilgi için Önce yapılması gerekenler: Eksiksiz analiz verileri nasıl oluşturulur? bölümünü inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(ayarlanmadı)" değerini görürsünüz. Analytics varlık değeri "(not set)" ne anlama gelir? bölümünü de inceleyin.

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

Bu boyutu almak için geliştiricilerin çağrılan API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkilendirilmiş uygulamalara sahip olması ve proxy'lerin API çağrısıyla gönderilen bir API anahtarı veya OAuth jetonu olup olmadığını kontrol etmesi gerekir. Anahtar veya jeton, geliştirici uygulamasını tanımlar. Daha fazla bilgi için Önce yapılması gerekenler: Eksiksiz analiz verileri nasıl oluşturulur? başlıklı makaleyi inceleyin.

Yukarıdaki ölçütler karşılanmazsa "(ayarlanmadı)" değerini görürsünüz. Analytics varlık değeri "(not set)" ne anlama gelir? bölümünü de inceleyin.

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

Bu boyutu almak için geliştiricilerin çağrılan API proxy'lerini içeren bir veya daha fazla API ürünüyle ilişkilendirilmiş uygulamaları olması ve proxy'lerin API çağrılarıyla gönderilen bir API anahtarı veya OAuth jetonu olup olmadığını kontrol etmesi gerekir. Anahtar veya jeton geliştiriciyi tanımlar. Daha fazla bilgi için Önce yapılması gerekenler: Eksiksiz analiz verileri nasıl oluşturulur? bölümüne bakın.

Yukarıdaki ölçütler karşılanmazsa "(ayarlanmadı)" değerini görürsünüz. Analytics varlık değeri "(not set)" ne anlama gelir? bölümünü de inceleyin.

Hatanın hata kodu. Örneğin: messaging.adaptors.http.flow.GatewayTimeout

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

Management API'de kullanılacak tam adın satır sonu olmadan ax_execution_fault_flow_name olduğunu unutmayın.

Hata oluşmadıysa "(ayarlanmadı)" değerini görürsünüz.

API proxy akışının adı, hata oluştuğunu belirtir (ör. "PROXY_REQ_FLOW" veya "TARGET_RESP_FLOW").

Management API'de kullanılacak tam adın satır sonu olmadan ax_execution_fault_flow_state hali olduğunu unutmayın.

Hataya yol açan 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ın satır sonu olmadan ax_execution_fault_policy_name olduğunu unutmayın.

Bir politika hata bildirirse ancak continueOnError politika kök özelliği true olarak ayarlanırsa API proxy akışı hata olmadan devam eder ve politika hatası bu boyutta sayılmaz.

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

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

API proxy temel yoluna eklenen kaynak yolu. Örneğin, bir API proxy'sinin temel URL'si https://apigeedocs-test.apigee.net/hello/ ise ve https://apigeedocs-test.apigee.net/hello/json öğesine çağrı yapılırsa pathuffix /json olur.

Hiçbir pathuffix kullanılmazsa değer boş olur.

Değer, proxy.pathsuffix akış değişkeninde de saklanı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.

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

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

1. ax_true_client_ip null değilse ve yerel IP adresi içermiyorsa ax_resolved_client_ip öğesini ax_true_client_ip olarak ayarlayın.
2. Aksi takdirde ax_resolved_client_ip, x_forwarded_for_ip içindeki ilk yerel olmayan IP adresine 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 adresi olarak ayarlayın.
4. ax_true_client_ip ve x_forwarded_for_ip null ise ax_resolved_client_ip değerini (not set) olarak ayarlayın.
5. ax_true_client_ip yerel bir IP adresiyse ve x_forwarded_for_ip boşsa ax_resolved_client_ip değerini (not set) olarak ayarlayın.

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

İşletim sistemlerinin sürümlerini görmek için OS Ailesi (ax_ua_os_family) ile ikinci bir "ayrıntılı inceleme" boyutu olarak bunu kullanmak faydalıdır.

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

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

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

Sorgu parametreleri hariç olmak üzere, hedef hizmete giden kaynak yolu (alan dahil değildir).

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net, karşılama mesajı döndüren /user de dahil olmak üzere çeşitli kaynaklar içerir. API proxy'nizin http://mocktarget.apigee.net/user çağrısı yapma yönteminden bağımsız olarak request_path /user olur.

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

Örneğin, Apigee örnek hedefi http://mocktarget.apigee.net, verilen ada özel bir karşılama mesajı döndürmek için kullanılan /user?user={name} kaynağı ve sorgu parametresi gibi çeşitli kaynakları içerir. API proxy'nizin http://mocktarget.apigee.net/user?user=Dude çağrısından bağımsız olarak request_uri değeri /user?user=Dude olur.

API çağrısını 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
• Bir terminalden cURL: curl/7.51.0

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

Bu aracı, aracı ailesinin sürümünü almak için Kullanıcı Aracısı Ailesi (ax_ua_agent_family) ile ikinci bir "ayrıntılı inceleme" boyutu olarak kullanmak faydalıdır.

Proxy'nin <TargetEndpoint> öğesinde tanımlanan, sorgu parametreleri hariç hedef hizmete giden kaynak yolu (alan hariç).

Ö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 şöyle olsaydı:

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

target_basepath null 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 hizmet tarafından API proxy'sine döndürülen HTTP yanıtı durum kodu (ör. 200, 404, 503).

"Boş" değeri, isteğin hiçbir zaman hedef hizmete ulaşmadığı anlamına gelir. Bu durum, yanıt, Yanıt Önbelleği politikası tarafından sunulduğunda veya istek işlemede bir hata olduğunda ortaya çıkar.

Bu, Yanıt Durumu Kodu (yanıt_durumu_kodu) 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 target_url değeri http://mocktarget.apigee.net/user?user=Dude'dir.

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

Proxy zincirlemede ve komut dosyası hedefleri (Node.js) kullanılırken, çağrı yapan proxy'deki target_url boştur.

X-Forwarded-For üstbilgisindeki IP adreslerinin listesi.

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

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

Zaman değeri UTC saat dilimindedir.