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ı |
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 |
| 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ı |
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.
