API Trafik Log Kaydı Veri Yapısı

Veri Yapısı Alanları

Alan Adı	Alanda Tutulan Veri/Açıklaması	Java Mapping Type	Mesajda yer alması için ayarlarda aktif edilmesi gereken alan
@timestamp	Time Stamp	Instant	Tanım Bilgisi
aci	Apinizer Correlation ID	String	Tanım Bilgisi
ei	Environment ID	String	Tanım Bilgisi
pi	Project ID	String	Tanım Bilgisi
appi	Application ID	String	API Proxy Bilgisi
appin	Application Name	String	API Proxy Bilgisi
api	API Proxy ID	String	API Proxy Bilgisi
apn	API Proxy Name	String	API Proxy Bilgisi
eat	API Type	String	API Proxy Bilgisi
aprp	API Proxy Relative Path	String	API Proxy Bilgisi
apmi	API Proxy Method ID	String	API Proxy Bilgisi
apmn	API Proxy Method Name	String	API Proxy Bilgisi
xff	X Forwarded For	String	İstek Bilgisi
hr1ra	Http Request Remote Address	String	İstek Bilgisi
hr1hm	Http Request Http Method	String	İstek Bilgisi
hr1ct	Http Request Content Type	String	İstek Bilgisi
hr1pi	Http Request Path Info	String	İstek Bilgisi
uok	Username or Key	String	İstek Bilgisi
hr1cp	Http Request Context Path	String	İstek Bilgisi
hr1qs	Http Request Query String	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1ru	Http Request Remote User	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1rsi	Http Request Requested Session Id	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1r1u	Http Request Request URI	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1ce	Http Request Character Encoding	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1cl	Http Request Content Length	Integer	İstek Bilgisi (Sadece "Trace" açıkken)
hr1p	Http Request Protocol	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1s	Http Request Scheme	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1sn	Http Request Server Name	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1sp	Http Request Server Port	Integer	İstek Bilgisi (Sadece "Trace" açıkken)
loc	Location	GeoLocation{Double lat, Double lon}	İstek Bilgisi
hr1rh	Http Request Remote Host	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1rp	Http Request Remote Port	Integer	İstek Bilgisi (Sadece "Trace" açıkken)
hr1ln	Http Request Local Name	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1la	Http Request Local Address	String	İstek Bilgisi (Sadece "Trace" açıkken)
hr1lp	Http Request Local Port	String	İstek Bilgisi (Sadece "Trace" açıkken)
trqpt	TimeRequestPipelineTotal	Integer	Metrik Bilgisi
trspt	TimeResponsePipelineTotal	Integer	Metrik Bilgisi
rrc	RoutingRetryCount	Integer	Metrik Bilgisi
rfc	RoutingFailoverCount	Integer	Metrik Bilgisi
trt	TimeRoutingTotal	Integer	Metrik Bilgisi
tapt	TimeApiProxyTotal	Integer	Metrik Bilgisi
ch	CacheHit	Boolean	Metrik Bilgisi
sr1t	SizeRequestTotal	Integer	Metrik Bilgisi
sr2t	SizeResponseTotal	Integer	Metrik Bilgisi
sc	Status Code	Integer	Yanıt Bilgisi
rt	Result Type	Enum	Yanıt Bilgisi
et	Error Type	Enum	Yanıt Bilgisi
pet	Parent Error Type	Enum	Yanıt Bilgisi
fcrp	From Client Read Only Parameter	Map<String,String>	Header from Client
fcrh	From Client Read Only Header	Map<String,String>	Param from Client
fcrb	From Client Read Only Body	String	Body from Client
tbap	To Backend API Parameter	Map<String,String>	Header to Backend API
tbah	To Backend API Header	Map<String,String>	Parameter to Backend API
tba	To Backend API Body	String	Body to Backend API
fbarh	From Backend API Read Only Header	Map<String,String>	Header from Backend API
fbarb	From Backend API Read Only Body	String	Body from Backend API
tch	To Client Header	Map<String,String>	Header to Client
tcb	To Client Body	String	Body to Client
pxt	Policy Execution Times	Nested<Object>	Politika Çalışma Süreleri

uyarı

Alanların sırası değişebilir.

Örnek JSON Verisi

Oluşan örnek JSON verisi:

{
  "@timestamp" : "2023-10-16T14:48:07.662Z",
  "aci" : "<correlation id>",
  "ei" : "<environment id>",
  "pi" : "<project id>",
  "appi" : "<api proxy group id>",
  "appin" : "<api proxy group name>",
  "api" : "<api proxy id>",
  "apn" : "<api proxy name>",
  "eat" : "REST",
  "aprp" : "<api proxy relative path>",
  "apmi" : "<api proxy method id>",
  "apmn" : "<api proxy method name>",
  "xff" : "<x-forwarded-for>",
  "hr1ra" : "<client address>",
  "hr1hm" : "<HTTP Method>",
  "hr1ct" : "<Content-Type>",
  "hr1pi" : "<http request path info>",
  "uok" : "<username or key>",
  "hr1cp" : "<http request context path>",
  "ra" : "<backend api address>",
  "rrc" : 0,
  "rfc" : 0,
  "trqpt" : 20,
  "trspt" : 30,
  "trt" : 100,
  "tapt" : 150,
  "sr1t" : 100,
  "sr2t" : 250,
  "ch" : false,
  "sc" : 200,
  "et" : "APIPROXY",
  "pet" : "API_PROXY",
  "rt" : "SUCCESS",
  "hr1qs" : "<Http Request Query String>",
  "hr1ru" : "<Http Request Remote User>",
  "hr1rsi" : "<Http Request Requested Session Id>",
  "hr1r1u" : "<Http Request Request URI>",
  "hr1ce" : "<Http Request Character Encoding>",
  "hr1cl" : 100,
  "hr1p" : "<Http Request Protocol>",
  "hr1s" : "<Http Request Scheme>",
  "hr1sn" : "<Http Request Server Name>",
  "hr1sp" : 443,
  "loc" : {
   "lat" : 45.405,
   "lon" : 11.1617
   },
  "hr1rh" : "<Http Request Remote Host>",
  "hr1rp" : 8443,
  "hr1ln" : "<Http Request Local Name>",
  "hr1la" : "<Http Request Local Addr>",
  "hr1lp" : 443,
  "fcrp" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "fcrh" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "fcrb" : "<request body from client>",
  "tbap" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "tbah" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "tba" : "<request body to backend api>",
  "fbarh" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "fbarb" : "<body response from backend api>",
  "tch" : [ {
    "k" : "key1",
    "v" : "value1"
  }, {
    "k" : "key2",
    "v" : "value2"
  }, {
    "k" : "key3",
    "v" : "value3"
  } ],
  "tcb" : "<body response to client>"
}

bilgi

"rt" alanında yer alan değerlerin listesini Hata Mesajları sayfasında yer alan "Sonuç Tipi Değerleri" tablosunda inceleyebilirsiniz.

"pet" alanında yer alan değerlerin listesini Hata Mesajları sayfasında yer alan "Hata Üst Tipi Değerleri" tablosunda inceleyebilirsiniz.

"et" alanında yer alan değerlerin listesini Hata Mesajları sayfasında yer alan "Hata Tipi Değerleri" tablosunda inceleyebilirsiniz.

Politika Çalışma Süreleri (pxt)

pxt yalnızca log hedefinde Politika çalışma süreleri açıkken yazılır (varsayılan kapalı). nested bir dizidir; her öğe o istekteki bir politika çalışmasını anlatır.

Anahtar	Alan	Tip	Açıklama
o	Sıra	Integer	Çalışma sırası. Aynı zamanda hattı da taşır: 0-9999 istek, 10000-19999 yanıt, 20000+ hata. Hat içindeki sıra o % 10000.
t	Politika Tipi	String	Politika tipi; örneğin jwt-auth, content-filter, ai-semantic-cache.
d	Süre	Integer	Politikanın çalışma süresi (milisaniye).
f	Bayrak	String	Tek karakter, normal kayıtlarda bulunmaz. S akış sonu, K atlandı (koşul karşılanmadı), X atlanmış akış sonu, T liste kesildi.

Politika adı tutulmaz: genellikle otomatik üretilmiş bir tanımlayıcıdır ve bir anlam taşımaz. pxt içine hiçbir gövde, başlık veya parametre içeriği yazılmaz — bu ayrıntı düzeyi için Trace kullanın.

"pxt": [
  { "o": 1, "t": "jwt-auth", "d": 12 },
  { "o": 2, "t": "rate-limit", "d": 3 },
  { "o": 10001, "t": "content-filter", "d": 41 },
  { "o": 10002, "t": "ai-semantic-cache", "d": 8, "f": "S" }
]

İlişkisel (SQL/JDBC) bir log hedefinde aynı veri policy_exec_times kolonuna, sıra:tip:süre üçlülerinden oluşan karakter sınırlı tek bir CSV olarak yazılır:

1:jwt-auth:12|2:rate-limit:3|10001:content-filter:41|10002:ai-semantic-cache:8[S]

Bir istek alışılmadık sayıda politika çalıştırdığında liste sessizce büyümek yerine kesilir ve kesinti görünür şekilde işaretlenir — iki temsil bunu farklı biçimde yapar. Elasticsearch ve MongoDB'de listenin sonuna t alanı +truncated, f alanı T, o alanı boş ve d alanı süre değil, dışarıda kalan politika sayısını taşıyan bir kayıt eklenir. policy_exec_times CSV'sinde ise string'in kendisi kesilir ve sonuna |+N eklenir (N = sığmayan üçlü sayısı); …|+12 ile biten bir değer 12 politika kaydının kolona sığmadığı anlamına gelir.

policy_exec_times kolonu, önceki bir sürümden yükseltilen kurulumlarda bulunmaz; her ortam veritabanına bir kez, 2026.09.1 — Log Tablosu ALTER Scriptleri sayfasındaki ALTER betiğiyle eklenmelidir. Yeni kurulumlarda kolon Apinizer Logları için Tablo Oluşturma Komutları sayfasındaki betikle zaten oluşur. Hangi politikaların, hangi hedeflerde kaydedileceği API Trafik Ayarları sayfasından yapılandırılır.