Sistem Ayarları ve Limitler

Apinizer platformunun tüm sistem ayarlarını, yapılandırma parametrelerini ve varsayılan limitleri tek bir sayfadan görüntüleyip yönetin. Düzenlenebilir ayarlar, runtime parametreleri ve sistem kısıtları birleşik bir arayüzde sunulur.

Yönetim > Sistem Ayarları yolunu izleyerek birleşik Sistem Ayarları ekranına erişilir. Bu ekran, platformun tüm yapılandırma parametrelerini, varsayılan limitlerini ve sistem kısıtlarını 8 sekmede gruplayarak sunar.

Bu ekrana sadece Yönetici (Admin) rolü olan kullanıcılar erişebilir. Ayarlar platform genelinde etkili olduğundan dikkatli yapılandırılmalıdır.

​

Genel Bakış

Birleşik Sistem Ayarları sayfası, daha önce ayrı ekranlarda yönetilen Genel Ayarlar, Sistem Özellikleri ile belgelenmemiş olan runtime parametreleri ve sistem kısıtlarını tek bir arayüzde birleştirmektedir. Her ayarın yanında kapsam etiketi (scope badge) bulunur:

Kapsam	Renk	Açıklama
Deploy Gerekli	Turuncu	Veritabanında saklanır, değişikliğin geçerli olması için API Proxy’lerin yeniden deploy edilmesi gerekir
Restart Gerekli	Mavi	Ortam değişkeni olarak tanımlanır, değişiklik için pod yeniden başlatılmalıdır
Sabit	Gri	Değiştirilemez altyapı sınırı

Düzenlenebilir ayarlar ilgili giriş bileşenlerini (sayı, metin, açma/kapama, renk seçici vb.) kullanarak doğrudan ekrandan değiştirilebilir. Salt okunur parametreler kilit simgesiyle gösterilir.

---

​

Sekme 1: Yönlendirme ve Trafik Yönetimi (Routing & Traffic Management)

Bu sekme, API isteklerinin arka uç sunuculara nasıl yönlendirileceğini ve bağlantı yapılandırmasını kontrol eden ayarları içerir.

​

Bağlantı Ayarları

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Bağlantı kurma zamanı (Connect Timeout)	30 sn	1 - 3.600 sn	Deploy Gerekli
Yanıt okuma zamanı (Read Timeout)	30 sn	1 - 3.600 sn	Deploy Gerekli
İstek zamanı (Request Timeout)	3 sn	1 - 300 sn	Deploy Gerekli
Maksimum yönlendirme (Max Redirects)	50	0 - 100	Deploy Gerekli
Etkinlik sonrası doğrulama (Validate After Inactivity)	2.000 ms	-	Deploy Gerekli
Boşta kalma zamanı (Idle Timeout)	30 sn	-	Deploy Gerekli

​

Bağlantı Havuzları

Havuz	Sunucu Başına	Toplam	Kapsam
Yönlendirme (Routing)	1.024	2.048	Restart Gerekli
Önbellek	-	256	Restart Gerekli
Elasticsearch	256	-	Restart Gerekli
API Çağrısı	256	4.096	Restart Gerekli
Varsayılan HTTP İstemcisi	128	512	Restart Gerekli

Ek bağlantı havuzu parametreleri:

Parametre	Varsayılan	Kapsam
Bağlantı yaşam süresi	5 dakika	Restart Gerekli
Keep-alive süresi	30 saniye	Restart Gerekli
Boşta bağlantı temizleme	30 saniye	Restart Gerekli

​

Yük Dengeleme (Load Balancing)

Parametre	Varsayılan	Kapsam
Algoritma	Round Robin (Sırayla Dağıtım)	Deploy Gerekli
Diğer seçenekler	Least Recently Used, Weighted, Random, Pick First	Deploy Gerekli
Kullanıcı ajan değeri	-	Deploy Gerekli

​

Yönlendirme (Redirect)

Parametre	Varsayılan	Kapsam
Yönlendirme etkin	-	Deploy Gerekli
Göreli yönlendirme izni	-	Deploy Gerekli
Sıkıştırmayı devre dışı bırak	-	Deploy Gerekli

​

Yeniden Deneme Politikası (Retry Policy)

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Sabit gecikme	500 ms	0 - 60.000 ms	Deploy Gerekli
Başlangıç gecikmesi	500 ms	0 - 60.000 ms	Deploy Gerekli
Maksimum gecikme	10.000 ms	0 - 300.000 ms	Deploy Gerekli
Geri çekilme çarpanı	2,0	1 - 10	Deploy Gerekli

​

Yapışan Oturum (Sticky Session)

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Çerez adı	-	-	Deploy Gerekli
Çerez geçerlilik süresi	1.800 sn (30 dk)	0 - 86.400 sn	Deploy Gerekli
Güvenli çerez	-	-	Deploy Gerekli
HttpOnly	-	-	Deploy Gerekli

​

Sağlık Kontrolü (Health Check)

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Kontrol aralığı	30 sn	5 - 3.600 sn	Deploy Gerekli
Zaman aşımı	5 sn	1 - 60 sn	Deploy Gerekli
Başarısız eşiği	3	1 - 20	Deploy Gerekli
Başarılı eşiği	2	1 - 20	Deploy Gerekli

​

Devre Kesici (Circuit Breaker)

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Hata penceresi	10 sn	1 - 3.600 sn	Deploy Gerekli
Hata eşiği	1	1 - 10.000	Deploy Gerekli
Bekleme süresi	10 sn	1 - 3.600 sn	Deploy Gerekli

​

Trafik Yansıtma (Traffic Mirroring)

Parametre	Varsayılan	Kapsam
Yansıtma oranı	%10	Deploy Gerekli

​

Hop-by-Hop Başlıklar (Salt Okunur)

Aşağıdaki HTTP başlıkları, yönlendirme sırasında gateway tarafından otomatik olarak işlenir ve arka uca iletilmez:

Content-Length, Host, User-Agent, TE, Trailers, Transfer-Encoding, Upgrade

Bu başlıklar HTTP/1.1 RFC 2616 standardına göre hop-by-hop olarak sınıflandırılır ve proxy sunucular tarafından yeniden oluşturulmalıdır.

---

​

Sekme 2: Protokol Yapılandırması (Protocol Configuration)

Bu sekme, farklı protokol türlerine (gRPC, WebSocket, HTTP/2) özgü ayarları içerir.

​

gRPC Yönlendirme (Deploy Gerekli)

Parametre	Varsayılan	Yapılandırma Aralığı	Kapsam
Gelen mesaj boyutu	16 MB	1 KB - 256 MB	Deploy Gerekli
Metadata boyutu	8 KB	1 KB - 16 MB	Deploy Gerekli
RPC başına tampon	1 MB	1 KB - 256 MB	Deploy Gerekli
Keep-alive süresi	120 sn	-	Deploy Gerekli
Keep-alive zaman aşımı	20 sn	-	Deploy Gerekli
Kanal boşta kalma süresi	5 dk	-	Deploy Gerekli
Yeniden deneme sayısı	5	0 - 100	Deploy Gerekli
Hedged istek sayısı	5	0 - 100	Deploy Gerekli
Trace olayları	-	-	Deploy Gerekli

​

gRPC Sunucu (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
Mesaj boyutu	4 MB	Restart Gerekli
Keep-alive süresi	2 saat	Restart Gerekli
Başlık listesi boyutu	8 KB	Restart Gerekli
Bağlantı yaşam süresi	1 saat	Restart Gerekli
Bağlantı kapatma yetkisi	30 sn	Restart Gerekli
Boşta bağlantı süresi	5 dk	Restart Gerekli
Handshake zaman aşımı	20 sn	Restart Gerekli
Keep-alive izin süresi	5 dk	Restart Gerekli
Thread havuzu boyutu	CPU x 2	Restart Gerekli

​

WebSocket Yönlendirme (Deploy Gerekli)

Parametre	Varsayılan	Kapsam
Bağlantı kaybı zaman aşımı	30 sn	Deploy Gerekli
Adresi yeniden kullan	-	Deploy Gerekli
Bağlantı zaman aşımı	10 sn	Deploy Gerekli
Yeniden deneme sayısı	3	Deploy Gerekli
Otomatik yeniden bağlantı	-	Deploy Gerekli

​

WebSocket Sunucu (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
Boşta kalma süresi	60 sn	Restart Gerekli
Tampon boyutu	64 KB	Restart Gerekli
TCP NoDelay	true	Restart Gerekli

​

HTTP/2 (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
HTTP/2 etkin	false	Restart Gerekli

---

​

Sekme 3: Güvenlik ve Erişim Kontrolü (Security & Access Control)

​

Kimlik Doğrulama ve Oturum

Parametre	Varsayılan	Kapsam
Captcha için izin verilen yanlış giriş sayısı	3	Deploy Gerekli
Kilitleme için izin verilen yanlış giriş sayısı	7	Deploy Gerekli
Boşta kalma süresi (Idle Time)	92.000 sn	Deploy Gerekli
Boşta kalma zaman aşımı (Idle Timeout)	5 sn	Deploy Gerekli

​

JDK TLS/SSL Ayarları (Restart Gerekli, Salt Okunur)

Parametre	Açıklama	Kapsam
Devre Dışı Bırakılan Algoritmalar	TLS’de kullanımı engellenen algoritma listesi	Restart Gerekli
Sertifika Yolu Devre Dışı Bırakılan Algoritmalar	Sertifika doğrulama yolunda engellenen algoritmalar	Restart Gerekli
Etkin TLS Sürümleri	TLSv1, TLSv1.1, TLSv1.2, TLSv1.3	Restart Gerekli
Şifreleme Paketleri	24 farklı cipher suite	Restart Gerekli
Güvenli Olmayan Protokollere İzin	JVM düzeyi güvenlik ayarı	Restart Gerekli

​

CORS (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
İzin verilen kaynaklar	*	Restart Gerekli
Credential’lara izin	true	Restart Gerekli
İzin verilen metotlar	*	Restart Gerekli
İzin verilen başlıklar	*	Restart Gerekli
Max age	3600	Restart Gerekli

​

X-Forwarded-For (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
IP başlık adı	X-Forwarded-For	Restart Gerekli
Sıralama	rightmost	Restart Gerekli

​

XML Güvenliği (Sistem Kısıtı, Salt Okunur)

Özellik	Durum	Açıklama
DTD	Devre dışı	XXE saldırılarına karşı koruma
Harici entity’ler	Devre dışı	Harici kaynak yüklemesini engeller
Entity genişletme	Devre dışı	Billion laughs saldırısına karşı koruma
XInclude	Devre dışı	Harici dosya dahil etmeyi engeller

---

​

Sekme 4: Loglama ve İzleme (Logging & Monitoring)

​

Trafik Logu Gövde Limitleri

Parametre	Varsayılan	Kapsam
İstemciden gelen gövde	25 MB	Deploy Gerekli
Backend’e giden gövde	25 MB	Deploy Gerekli
Backend’den gelen gövde	25 MB	Deploy Gerekli
İstemciye giden gövde	25 MB	Deploy Gerekli
Elasticsearch sorgu tamponu	25 MB	Deploy Gerekli

​

Politika Logu

Parametre	Varsayılan	Kapsam
Execution log gövdesi	1 MB	Deploy Gerekli
Executable detay limiti	1 KB	Deploy Gerekli

​

Log Saklama (Log Retention)

Log saklama ayarları, farklı log tiplerine göre saklama sürelerini ve maksimum kayıt sayılarını belirler. Tüm log tipleri (trafik, uygulama, token, audit, login) için ayrı ayrı yapılandırılabilir.

​

Metrikler (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
Metrikler etkin	false	Restart Gerekli

---

​

Sekme 5: Veri İşleme ve Sınırlar (Data Processing & Limits)

​

SOAP Örnek Mesaj Üretimi

Parametre	Varsayılan	Kapsam
Maksimum eleman sayısı	1.000	Deploy Gerekli
Maksimum iç içe derinlik	15	Deploy Gerekli
Maksimum boyut	25 KB	Deploy Gerekli

​

REST-SOAP Dönüşüm Limitleri

Bu limitler, REST’ten SOAP’a dönüşüm sırasında JSON parser’ın kabul edeceği maksimum değerleri belirler.

Parametre	Varsayılan	Kapsam
Maksimum string uzunluğu	20.000.000	Deploy Gerekli
Maksimum iç içe derinlik	1.000	Deploy Gerekli
Maksimum sayı uzunluğu	1.000	Deploy Gerekli

​

Raporlama ve Dışa Aktarma

Parametre	Varsayılan	Kapsam
Excel dışa aktarma limiti	10.000 kayıt	Deploy Gerekli
Rapor üretici maks. kayıt	10.000 kayıt	Deploy Gerekli
Trafik logu önizleme	100 satır	Deploy Gerekli
Email ek boyutu	25 MB	Deploy Gerekli

​

Arayüz Gösterim Limitleri

Parametre	Varsayılan	Kapsam
Arayüzde gövde gösterim limiti	5 MB	Deploy Gerekli
Test konsolu dosya yükleme	5 MB	Deploy Gerekli
Test konsolu istek gövdesi	5 MB	Deploy Gerekli
Test konsolu yanıt gövdesi	5 MB	Deploy Gerekli

​

Multipart Yükleme (Restart Gerekli, Salt Okunur)

Parametre	Varsayılan	Kapsam
Maksimum dosya boyutu	100 MB	Restart Gerekli
Maksimum istek boyutu	100 MB	Restart Gerekli
Dosya boyutu eşiği	10 MB	Restart Gerekli

​

Sistem Boyut Kısıtları (Salt Okunur)

Kısıt	Değer	Açıklama
MongoDB doküman boyutu	16 MB	BSON doküman boyut sınırı, değiştirilemez
Elasticsearch maks. sonuç penceresi	10.000	Varsayılan sonuç penceresi sınırı
Denetim logu referans nesnesi	15 MB	MongoDB 16 MB sınırı nedeniyle

---

​

Sekme 6: Gateway Çalışma Zamanı (Gateway Runtime)

Bu sekmedeki tüm parametreler Restart Gerekli kapsamındadır ve salt okunurdur. Değiştirmek için ortam değişkeni olarak tanımlanmalı ve pod yeniden başlatılmalıdır.

​

Undertow Thread Havuzu

Parametre	Varsayılan	Açıklama
Worker Threads	CPU x 8	İşçi iş parçacığı sayısı
Worker Max Threads	CPU x 16	Maksimum işçi iş parçacığı sayısı
IO Threads	CPU sayısı	Giriş/çıkış iş parçacığı sayısı

​

Undertow Tampon Ayarları

Parametre	Varsayılan	Açıklama
Buffer Size	16 KB	Tampon boyutu
TCP Backlog	1.000	TCP bağlantı kuyruğu
Max Concurrent Request	0 (sınırsız)	Maks. eş zamanlı istek
Max Queue Size	0 (sınırsız)	Maks. kuyruk boyutu
Direct Buffers	true	Doğrudan bellek tamponu

​

Undertow Zaman Aşımları

Parametre	Varsayılan	Açıklama
Read Timeout	0 (sınırsız)	Okuma zaman aşımı
Streaming Read Timeout	0 (sınırsız)	Akış okuma zaman aşımı
No Request Timeout	60 sn	İsteksiz bekleme zaman aşımı

​

Sanal Thread (Virtual Thread)

Parametre	Varsayılan	Açıklama
Routing VT etkin	true	Yönlendirme için sanal iş parçacığı
Logging VT etkin	true	Loglama için sanal iş parçacığı

​

Async Executor

Parametre	Varsayılan	Açıklama
Core pool size	2	Çekirdek havuz boyutu
Max pool size	100	Maksimum havuz boyutu
Queue capacity	10.000	Kuyruk kapasitesi

​

Genel

Parametre	Varsayılan	Açıklama
Log seviyesi	INFO	Uygulama log seviyesi
Karakter seti	UTF-8	Varsayılan karakter kodlaması
Dağıtım zaman aşımı	30 sn	Worker dağıtım zaman aşımı
Küme adı	-	Kümeleme adı

​

Varsayılan Portlar (Sistem Kısıtı, Salt Okunur)

Port	Açıklama
8080	API Gateway HTTP
8090	Cache Server
8091	Management API
8443	API Gateway HTTPS
8092	gRPC
8094	WebSocket
9091	Undertow Admin

---

​

Sekme 7: Önbellek ve Kümeleme (Cache & Clustering)

Bu sekmedeki tüm parametreler Restart Gerekli kapsamındadır ve salt okunurdur.

​

Hazelcast Thread’leri

Parametre	Varsayılan	Açıklama
Operation thread sayısı	-	İşlem iş parçacıkları
Generic thread sayısı	-	Genel amaçlı iş parçacıkları

​

Bölme (Partitioning)

Parametre	Varsayılan	Açıklama
Partition sayısı	271	Hazelcast bölme sayısı

​

Harita Yapılandırması (Map Config)

Parametre	Varsayılan	Açıklama
Maks. kayıt sayısı	10.000	Harita başına maksimum kayıt
Yedekleme sayısı	1	Senkron yedekleme
Asenkron yedekleme	0	Asenkron yedekleme sayısı
Yedekten okuma	true	Yedek kopyadan okuma

​

Yazma Arkası (Write-Behind)

Parametre	Varsayılan	Açıklama
Yazma gecikmesi	5 sn	Toplu yazma süresi
Toplu yazma boyutu	100	Tek seferde yazılan kayıt
Birleştirme (coalescing)	true	Aynı key için birleştirme
Kuyruk kapasitesi	100.000	Yazma kuyruğu boyutu

​

Ağ Ayarları

Parametre	Varsayılan	Açıklama
Heartbeat aralığı	5 sn	Kalp atışı süresi
Maks. heartbeat olmadan bekleme	60 sn	Heartbeat zaman aşımı
Socket keep alive	true	Soket canlı tutma
Socket no delay	true	TCP NoDelay

​

Zaman Aşımları

Parametre	Varsayılan	Açıklama
İşlem çağrısı zaman aşımı	60 sn	İşlem zaman aşımı
Yedekleme zaman aşımı	5 sn	Yedekleme işlem zaman aşımı

​

Serializasyon

Parametre	Varsayılan	Açıklama
Native byte order	true	Platform byte sırası
IO write through	false	Doğrudan yazma

​

Harita Yükleme

Parametre	Varsayılan	Açıklama
Chunk boyutu	10.000	Toplu yükleme parça boyutu
Batch boyutu	10.000	Toplu yükleme adımı

---

​

Sekme 8: Platform (Platform)

​

Dağıtım (Deployment)

Parametre	Varsayılan	Kapsam
Geçmiş revizyon sayısı	6	Deploy Gerekli

​

Korelasyon Kimliği (Correlation ID)

Parametre	Varsayılan	Kapsam
Correlation ID başlık adı	APINIZER-CORRELATION-ID	Deploy Gerekli

Korelasyon kimliği başlık adı şu anda sabit olarak tanımlıdır ve değiştirilemez. Bu değer istekler arasında iz sürme (distributed tracing) için kullanılır.

---

​

Kullanıcı Arayüzü Sabitleri

Aşağıdaki limitler, arayüzde sabittir ve sistem ayarları ekranından değiştirilemez:

Limit	Varsayılan
Sayfalama	10 kayıt (seçenekler: 10 / 25 / 50 / 100)
Portal sayfalama	20 kayıt
Test zaman aşımı	10 saniye
Bildirim süresi	5 saniye
Logo/favicon yükleme	5 MB
API ürün dosya yükleme	2 MB
Toplu içe aktarma	100 MB
Parola uzunluğu	4 - 100 karakter

---

​

MCP (Portal WebSocket)

Parametre	Varsayılan	Yapılandırma
Maks. eş zamanlı bağlantı	100	YAML
Oturum zaman aşımı	5 dakika	YAML
Hız sınırı	Dakikada 100 istek	YAML

---

​

Değişikliklerin Kaydedilmesi

Ekranın sağ üst köşesindeki Değişiklikleri Uygula butonu ile değişiklikler kaydedilir. Sistem farklı veri kaynaklarına ait değişiklikleri ayrı ayrı kaydeder:

• Deploy Gerekli (DB) ayarlar anında tüm node’lara dağıtılır
• Restart Gerekli ayarlar için ilgili pod’un yeniden başlatılması gerekir
• Sabit değerler salt okunurdur ve değiştirilemez

Bazı ayarların (örneğin API Root Context) değiştirilmesi platformun yeniden başlatılmasını gerektirebilir.