Ana içeriğe atla

​
Genel Bakış

Merkezi Veri İletimi

Connection (Bağlantı) Integration Flow veya Connector adımlarının log, metrik ve arama verilerini merkezi Elasticsearch cluster’ına iletir.

Yüksek Erişilebilirlik

Çoklu host (HTTP/HTTPS) tanımıyla yüksek erişilebilirlik sağlayan REST isteklerini yönetir.

Otomasyon

Index Template ve Index Lifecycle Policy (ILM) otomasyonuyla cluster yönetişimini standartlaştırır.

Bakım Görevleri

Rollover, template oluşturma ve policy senkronizasyonu gibi bakım görevlerini tek tuşla tetikler.

Bağlantı Başlatma

Integration Flow veya Connector içerisinden Elasticsearch Connection (Bağlantı) talep edildiğinde, sistem yapılandırılmış connection parametrelerini okur.

Connection Pool Yönetimi

HTTP client, ioThreads, maxConnectionPerHost ve maxConnectionTotal değerlerine göre pool’dan uygun bağlantıyı seçer veya yenisini açar.

Kimlik Doğrulama

Basic Authentication sağlandığında kullanıcı adı/şifre gönderilir; aksi halde anonim erişim veya IP tabanlı güvenlik kullanılır.

Veri İletişimi

REST endpoint’lerine HTTP/HTTPS üzerinden JSON gövdeli CRUD istekleri gönderilir; socket ayarları (keep-alive, reuse) aktarım sürekliliğini sağlar.

Bağlantı Yönetimi

İşlem tamamlanınca bağlantı pool’a geri döner, açık socket’ler keep-alive süreleri dolunca kapanır.

Hata Yönetimi

Bağlantı hatası, timeout veya authentication hatasında Apinizer Message Service bilgilendirme üretir; deployment result diyalogunda detay gösterilir.

Gateway Logları

Gateway loglarını merkezi Elasticsearch indekslerine yazmak

Arama/Raporlama

Arama/raporlama amacıyla okuma-only cluster’lara erişmek

ILM ve Template Otomasyonu

ILM ve template otomasyonu gerektiren yüksek hacimli log kümelerini yönetmek

Disaster Recovery

Disaster recovery veya geo-yedekli Elasticsearch kümelerine trafik yönlendirmek

​
Teknik Özellikler ve Yetenekler

Çoklu Host Yönetimi

HTTP/HTTPS scheme, host ve port kombinasyonları ile cluster node’ları arasında yük dağıtımı sağlar.

Index Şablonu Otomasyonu

Shard/replica sayıları ve refresh interval değerleri UI üzerinden yönetilir.

İdari İşlemler

Administrate seçeneği açıkken Index Template, ILM Policy oluşturma ve rollover tetikleme butonları etkinleşir.

Ortam Bazlı Yapılandırma

Her ortam (Development, Test, Production) için ayrı connection parametreleri tanımlama imkanı.

Enable/Disable Kontrolü

Connection’ı aktif veya pasif hale getirme (enable/disable toggle). Pasif durumda bağlantı kullanılamaz ancak yapılandırması saklanır.

İndeks Yaşam Döngüsü Düzenleyicisi

Hot/Warm/Cold/Delete fazları için yaş, boyut ve replikasyon eşikleri modal üzerinden kontrol edilir.

TLS Sertifika Esnekliği

PKCS#12 veya PEM tabanlı CA/keystore dosyaları yüklenerek SSL/TLS iletişimi güvenceye alınır.

Okuma/Yazma Modu

READ_WRITE modunda administrate işlemleri aktif, READ modunda yalnızca sorgu yapılır.

Connection Test Özelliği

“Test Connection” butonu ile bağlantı parametrelerini kaydetmeden önce doğrulama imkanı.

Export/Import Özelliği

Connection yapılandırmasını ZIP dosyası olarak export etme. Farklı ortamlara (Development, Test, Production) import etme. Versiyon kontrolü ve yedekleme imkanı.

Connection Monitoring

Bağlantı sağlığı, pool durumu ve performans metriklerini izleme.

​
Connection Parametreleri

Name

Açıklama: Connection adı (benzersiz olmalı)
Örnek Değer: Production_ElasticLog
Notlar: Boşlukla başlamaz, özel karakterler kullanılmamalı

Index Name

Açıklama: Logların yazılacağı indeks adı
Örnek Değer: apinizer-log-apiproxy-default
Notlar: Administrate açıkken otomatik oluşturulur; çakışmalar kontrol edilir

Elastic Host (Host & Port)

Açıklama: Her host için scheme/host/port
Örnek Değer: HTTPS : es-prod-01 : 9243
Notlar: En az bir host zorunlu; host ve port alanları boş bırakılamaz

Connection Timeout (ms)

Açıklama: Bağlantı kurulumu için bekleme süresi
Örnek Değer: 5000
Notlar: Varsayılan 5000; negatif değer kabul edilmez

IO Threads

Açıklama: HTTP istemci iş parçacığı sayısı
Örnek Değer: 32
Notlar: Minimum 1; yüksek trafik için artırılmalı

Max Connection Per Host

Açıklama: Host başına eşzamanlı istek sınırı
Örnek Değer: 128
Notlar: Minimum 1

Max Connection Total

Açıklama: Toplam connection havuzu sınırı
Örnek Değer: 256
Notlar: Minimum 1

Connection Type

Açıklama: READ_WRITE veya READ modu
Örnek Değer: READ_WRITE
Notlar: READ seçilirse administrate devre dışı kalır

Description

Açıklama: Connection amacı açıklaması
Varsayılan Değer: Boş
Önerilen Değer: Operasyonel bilgi içeren kısa metin

Authenticate

Açıklama: Basic Authentication aç/kapa
Varsayılan Değer: false
Önerilen Değer: Production’da gereksinime göre true

Elastic Username

Açıklama: Kullanıcı adı
Varsayılan Değer: Boş
Önerilen Değer: Authentication aktifse zorunlu

Elastic Password

Açıklama: Parola
Varsayılan Değer: Boş
Önerilen Değer: Secret manager üzerinden girilmesi önerilir

Administrate

Açıklama: Template/ILM yönetimi
Varsayılan Değer: true (READ_WRITE)
Önerilen Değer: Harici ekip yönetiyorsa kapatılabilir

Socket Keep Alive

Açıklama: TCP keep-alive
Varsayılan Değer: true
Önerilen Değer: Ağ cihazları idle bağlantıları düşürüyorsa açık bırakın

Socket Reuse Address

Açıklama: Adres yeniden kullanımı
Varsayılan Değer: true
Önerilen Değer: Çoklu worker deployment’larında açık bırakın

Disable Hostname Verification

Açıklama: TLS hostname doğrulaması
Varsayılan Değer: true
Önerilen Değer: Production’da false olarak değiştirin

​
Timeout ve Connection Pool Parametreleri

Connection Timeout

Açıklama: Bağlantı kurulması için maksimum bekleme süresi
Varsayılan: 5000
Min: 1000 | Max: 60000
Birim: milisaniye

Request Timeout

Açıklama: Elasticsearch yanıtını bekleme süresi
Varsayılan: 60000
Min: 1000 | Max: 120000
Birim: milisaniye

Pool Size

Açıklama: Connection pool’daki maksimum bağlantı sayısı
Varsayılan: 256
Min: 1 | Max: 2000
Birim: adet

Socket Idle Timeout

Açıklama: Idle bağlantının kapatılma süresi
Varsayılan: 30000
Min: 1000 | Max: 600000
Birim: milisaniye

​
Kullanım Senaryoları

Yüksek Hacimli Log Yazımı

Durum: Dakikada milyonlarca log girişi
Çözüm: READ_WRITE, administrate açık, ioThreads=64, maxConnectionTotal=512
Beklenen Davranış: ILM otomatik rollover yapar, yazma kuyruğu oluşmaz

Raporlama Kümesi

Durum: Salt okuma sorguları
Çözüm: READ, administrate kapalı, authentication=true
Beklenen Davranış: Cluster sadece sorgu alır, yönetim işlemleri engellenir

Çoklu Host Failover

Durum: İki veri merkezi
Çözüm: İki HTTPS host, encrypt communication + PKCS#12 CA
Beklenen Davranış: Trafik otomatik olarak sağlıklı host’a yönelir

Şema Güncellemesi

Durum: Yeni alanlar eklendi
Çözüm: Template adı ve shard/replica güncellenip “Create Index Template” çalıştırılır
Beklenen Davranış: Yeni indexler güncel şema ile açılır

Veri Saklama Politikası

Durum: 90 gün üstü loglar silinecek
Çözüm: ILM delete fazı aktif, minAgeOfDelete=90
Beklenen Davranış: Eski indexler otomatik temizlenir

Güvenli Tünel

Durum: TLS zorunlu, internal CA
Çözüm: Encrypt communication açık, CA_IN_PEM_FILE yüklenir
Beklenen Davranış: Sertifikalarla güvenli bağlantı sağlanır

​
Connection Yapılandırma

​
Yeni Elasticsearch Connection Oluşturma

Image 2024 9 9 15 35 35 Pn

​
Yapılandırma Adımları

1

Oluşturma Sayfasına Gitme

  • Sol menüden Connection → Elasticsearch bölümüne gidin.
  • Sağ üstteki [+ Create] butonuna tıklayın.
  • Yeni Elasticsearch Connection oluşturma formu açılır.
2

Temel Bilgileri Girme

Enable Status (Aktif Durumu) Ayarlama:
  • Formun üst kısmında Enable Status toggle’ını bulun.
  • Toggle’ı Aktif konumuna getirin (varsayılan olarak aktif gelir).
  • Connection’ı pasif yapmak isterseniz toggle’ı Pasif konumuna getirin.
  • Pasif connection’lar Integration Flow’larda kullanılamaz ancak yapılandırmaları saklanır.
Name (İsim) - Zorunlu Alan:
  • Name alanına benzersiz bir connection adı girin.
  • İsim örnekleri: `Production_ElasticLog`, `Test_ElasticConnection`, `Dev_ElasticSearch`
  • İsim kuralları:
  • Boşlukla başlamamalı
  • Özel karakterler kullanılmamalı (önerilen: harf, rakam, alt çizgi)
  • Maksimum 255 karakter
  • İsim yazdıkça sistem otomatik kontrol eder:
  • Yeşil tik işareti: İsim kullanılabilir
  • Kırmızı çarpı işareti: İsim zaten mevcut, farklı bir isim seçin
Description (Açıklama) - İsteğe Bağlı:
  • Description alanına connection’ın amacını açıklayan bir metin girin.
  • Örnek açıklamalar:
  • “Gateway loglarını production cluster’a yazar”
  • “Production ortamı Elasticsearch bağlantısı”
  • “Test ortamı için dummy Elasticsearch bağlantısı”
  • Maksimum 1000 karakter sınırı vardır.
  • Bu alan boş bırakılabilir.
3

Environment (Ortam) Seçimi

  • Environment dropdown menüsünü bulun.
  • Dropdown menüyü açın ve aşağıdaki seçeneklerden birini seçin:
  • Development: Geliştirme ortamı için
  • Test: Test ortamı için
  • Production: Üretim ortamı için
  • Her ortam için farklı connection parametreleri tanımlanabilir.
  • Ortam seçimi, connection’ın hangi ortamda aktif olacağını belirler.
  • Aynı isimde connection’lar farklı ortamlar için ayrı ayrı oluşturulabilir.
4

Elasticsearch Host Parametreleri

Scheme Seçimi:
  • Her host için Scheme seçin: HTTP veya HTTPS
  • HTTPS seçildiğinde Encrypt Communication otomatik açılır.
Host/Port - Zorunlu:
  • Host alanına Elasticsearch node’unun adresini girin.
  • Port alanına port numarasını girin (varsayılan: 9200).
  • Host formatı:
  • FQDN (Fully Qualified Domain Name): `es-prod-01.company.com`
  • IP adresi: `192.168.1.100`
  • Birden fazla host ekleyerek cluster erişimini yedekleyin.
  • En az bir host zorunludur.
Connection Type Seçimi:
  • Connection Type dropdown menüsünden seçim yapın:
  • READ_WRITE: Okuma ve yazma işlemleri için (administrate işlemleri aktif)
  • READ: Sadece okuma işlemleri için (administrate devre dışı)
  • Connection type seçimi, administrate davranışını belirler.
Birden fazla host ekleyerek yüksek erişilebilirlik sağlayabilirsiniz.
5

Index Template ve ILM Yapılandırması

Index Name - Zorunlu:
  • Index Name alanına logların yazılacağı indeks adını girin.
  • Örnek: `apinizer-log-apiproxy-default`
  • Administrate açıkken otomatik oluşturulur; çakışmalar kontrol edilir.
Administrate Ayarlama:
  • Administrate toggle’ını bulun.
  • Template ve ILM yönetimi için toggle’ı Aktif konumuna getirin.
  • Administrate aktifse aşağıdaki alanlar görünür hale gelir:
  • Template adı
  • Shard sayısı
  • Replica sayısı
  • Refresh interval
ILM Policy Yapılandırması:
  • Edit ILM Policy butonuna tıklayın.
  • Açılan modalda hot/warm/cold/delete faz eşiklerini ayarlayın.
  • Policy adının benzersiz olduğunu doğrulayın.
  • İlk deployment öncesi policy adını kontrol edin.
6

Timeout ve Connection Pool Ayarları

Connection Timeout:
  • Connection Timeout (ms) alanına bağlantı kurulumu için bekleme süresini girin.
  • Varsayılan: 5000 milisaniye
  • Minimum: 1000, Maksimum: 60000 milisaniye
IO Threads:
  • IO Threads alanına HTTP istemci iş parçacığı sayısını girin.
  • Minimum: 1
  • Yüksek trafik için artırılmalı (örn: 64)
Max Connection Per Host:
  • Max Connection Per Host alanına host başına eşzamanlı istek sınırını girin.
  • Minimum: 1
  • Önerilen: 128
Max Connection Total:
  • Max Connection Total alanına toplam connection havuzu sınırını girin.
  • Minimum: 1, Maksimum: 2000
  • Önerilen: 256
Socket Ayarları:
  • Socket Keep Alive toggle’ını bulun (varsayılan: aktif).
  • Socket Reuse Address toggle’ını bulun (varsayılan: aktif).
  • Ağ cihazları idle bağlantıları düşürüyorsa keep-alive açık bırakın.
  • Çoklu worker deployment’larında reuse address açık bırakın.
7

Güvenlik ve Authentication Ayarları

Authentication Ayarlama:
  • Authenticate toggle’ını bulun.
  • Elasticsearch cluster’ınız kimlik doğrulama gerektiriyorsa toggle’ı Aktif konumuna getirin.
  • Çoğu production ortamında kimlik doğrulama gerektirir.
Username ve Password:
  • Authenticate toggle’ı aktifse Elastic Username alanı görünür hale gelir.
  • Elasticsearch kullanıcı adını girin.
  • Elastic Password alanına şifreyi girin.
  • Şifre güvenlik nedeniyle maskelenmiş görünecektir.
  • Hassas bilgiler için secret manager kullanımı önerilir.
Encrypt Communication (TLS):
  • En az bir host HTTPS seçildiğinde Encrypt Communication bölümü görünür.
  • TLS tipi seçin:
  • PKCS#12 CA: PKCS#12 formatında CA dosyası
  • PEM CA: PEM formatında CA dosyası
  • PKCS#12 cert+key: PKCS#12 formatında sertifika ve anahtar dosyası
  • Gerekli dosyaları yükleyin.
  • Eksik dosyalarda form hata verir ve kayda izin vermez.
Disable Hostname Verification:
  • Disable Hostname Verification toggle’ını bulun.
  • Production’da false olarak değiştirin (varsayılan: true).
  • Test ortamında true bırakılabilir.
Production ortamında mutlaka SSL/TLS kullanın ve hostname verification’ı aktif tutun.
8

Test Connection (Bağlantı Testi)

  • Formun alt kısmında veya sağ üst köşede [Test Connection] butonunu bulun.
  • Butona tıklayın.
  • Sistem bağlantı parametrelerini test eder:
  • Elasticsearch cluster’ına bağlantı kurulur
  • Kimlik doğrulama yapılır (Authentication aktifse)
  • TLS handshake yapılır (Encrypt Communication aktifse)
  • Cluster sağlığı kontrol edilir
  • Test sonucu:
  • Başarılı: Yeşil onay mesajı görüntülenir, “Connection test successful” gibi bir mesaj
  • Başarısız: Kırmızı hata mesajı görüntülenir, hata detayları gösterilir
  • Hata durumunda:
  • Hata mesajını okuyun
  • İlgili parametreleri kontrol edin (Host, Port, Username, Password)
  • Firewall ve network ayarlarını kontrol edin
  • Elasticsearch cluster sağlığını kontrol edin
  • Test başarılı olana kadar parametreleri düzeltin ve tekrar test edin.
9

Kaydetme ve Deploy Etme

  • Tüm zorunlu alanların doldurulduğundan emin olun.
  • Test connection’ın başarılı olduğunu doğrulayın (önerilir).
  • Formun sağ üst köşesinde bulunan [Save and Deploy] butonuna tıklayın.
  • Sistem connection’ı kaydeder ve seçilen ortama deploy eder.
  • Başarılı kayıt sonrası:
  • Connection listesi sayfasına yönlendirilirsiniz
  • Yeni connection listede görünür
  • Connection Enabled durumda olur
  • Integration Flow ve Connector adımlarında kullanılabilir hale gelir
Kontrol Listesi (Kaydetmeden Önce):
  • Name alanı benzersiz ve geçerli
  • En az bir Host ve Port alanları doldurulmuş
  • Index Name doldurulmuş
  • Connection Type seçilmiş
  • Authentication aktifse Username ve Password doldurulmuş
  • Environment seçilmiş
  • Test Connection başarılı (önerilir)
  • Zorunlu alanların hepsi doldurulmuş
Sonuç:
  • Connection başarıyla oluşturulur ve kaydedilir
  • Seçilen ortamda aktif hale gelir
  • Integration Flow ve Connector adımlarında connection seçimi yapılabilir
  • Connection listesinde görüntülenir ve yönetilebilir
Connection başarıyla oluşturuldu! Artık Integration Flow ve Connector adımlarında kullanabilirsiniz.

​
Connection’ı Silme

Connection’ı silmek için:

Yöntem 1: Liste Ekranından

  • Connection listesinde satır sonundaki ⋮ menüsünden Delete seçeneğini tıklayın.
  • Onay dialogunda silme işlemini onaylayın.

Silme İpuçları

Silmeden Önce Kontrol Edin:
  • Integration Flow veya Connector adımlarında kullanılıyor olabilir.
  • Gerekirse alternatif bir connection atayın.
  • Silmeden önce Export ile yedek alın.

Alternatif: Deaktif Etme

  • Silmek yerine view ekranından [Disabled] butonunu kullanın.
  • Connection pasif olur ancak silinmez.
  • Gerektiğinde [Enabled] butonu ile yeniden etkinleştirilebilir.

​
Connection’ı Dışa/İçe Aktarma

Bu adımda kullanıcı, mevcut connection’ları yedekleme, farklı ortamlara taşıma veya paylaşma amacıyla dışa aktarabilir (export) ya da daha önce dışa aktarılmış bir connection’ı tekrar içe aktarabilir (import). Bu işlem, sürüm yönetimi, test ve üretim ortamları arasında geçiş veya ekipler arası paylaşım süreçlerinde veri bütünlüğünü korumak için kullanılır.

Yöntem 1: Liste Ekranından

  • Connection listesinde satır sonundaki ⋮ menüsünden Export seçeneğini tıklayın.
  • ZIP dosyası otomatik olarak indirilir.

Dosya Formatı

Format: {Date}-elasticsearch-integration-{ConnectionName}-export.zip
Örnek: 13 Nov 2025-elasticsearch-integration-Production_ElasticLog-export.zip

ZIP İçeriği

  • Connection JSON dosyası
  • Metadata bilgileri
  • Bağımlılık bilgileri (örneğin sertifikalar, key store)

Kullanım Alanları

  • Yedekleme
  • Ortamlar arası taşıma (Test → Prod)
  • Versiyonlama
  • Ekip veya proje bazlı paylaşım

İçe Aktarma Adımları

  • Ana listede [Import Elasticsearch] butonuna tıklayın.
  • İndirilen ZIP dosyasını seçin.
  • Sistem kontrolleri: Format geçerli mi? İsim çakışması var mı? Bağımlılıklar mevcut mu?
  • Ardından [Import] butonuna tıklayın.

İçe Aktarma Senaryoları

Senaryo 1: İsim Çakışması → Eski connection’ın üzerine yazın veya yeni bir isimle oluşturun.Senaryo 2: Eksik Bağımlılıklar → Eksik sertifikaları veya key store’ları önce oluşturun veya import sırasında çıkarın.

​
Connection’ın Kullanım Alanları

Connection Oluşturma ve Aktif Etme

Adımlar:
  1. Connection’ı oluşturun.
  2. Test Connection ile bağlantıyı doğrulayın.
  3. Save and Deploy ile kaydedin ve etkinleştirin.
  4. Connection’ın Enabled durumda olduğundan emin olun.

Integration / Connector Adımlarında Kullanım

Elasticsearch log, metrik ve arama verilerini gerektiren adımlarda connection seçilir. Örnek: “Elasticsearch Index”, “Elasticsearch Query”, “Elasticsearch Bulk” gibi adımlar. Bağlantı seçimi bu adımların yapılandırmasında yer alan Connection alanından yapılır.

Scheduled Job Kullanımı

Zamanlanmış görevlerde (ör. belirli aralıklarla log yazma, index yönetimi vb.) bağlantı seçilerek Elasticsearch cluster’ına erişim sağlanır. Connection değiştiğinde, job çalışma davranışı da buna göre güncellenir.

Test Amaçlı Kullanım

Connection Test özelliği ile bağlantının doğruluğu Integration Flow’dan bağımsız olarak kontrol edilebilir. Bu test hata ayıklama sürecinde kritik önem taşır.

​
Best Practices

Index İsimlendirme

Kötü: index1.
İyi: log-prod.
En İyi: `prod-apiproxy-log-{yyyy.MM.dd}`

ILM Politikaları

Kötü: Varsayılanları değiştirmemek.
İyi: Günlük veri büyüklüğüne göre max size ayarlamak.
En İyi: Hem boyut hem yaş eşiği ayarlayıp rollover butonunu düzenli kullanmak

TLS Sertifika Yönetimi

Kötü: Tüm ortamda aynı sertifikayı paylaşmak.
İyi: Ortam bazlı sertifika yüklemek.
En İyi: Sertifika rotasyonunu otomasyonla planlamak ve expiration alarmları kurmak

Connection Türü Seçimi

Kötü: Okuma-only cluster’a READ_WRITE vermek.
İyi: Yetki gereksinimine göre seçim yapmak.
En İyi: Cluster rolü değişirse connection tipini güncellemek

Ortam Yönetimi

Kötü: Tüm ortamlarda aynı connection parametrelerini kullanmak.
İyi: Her ortam için ayrı connection oluşturmak.
En İyi: Environment seçeneğini kullanarak tek connection’da tüm ortamları yönetmek, ortamlar arası geçişte sadece environment değiştirmek

Connection Test

Kötü: Connection’ı test etmeden kaydetmek ve deploy etmek.
İyi: Kaydetmeden önce Test Connection ile doğrulamak.
En İyi: Her parametre değişikliğinden sonra test etmek, production’a geçmeden önce test ortamında tam entegrasyon testi yapmak

Erişim Segmentasyonu

Production cluster için ayrı connection ve RBAC kullanıcıları oluşturun; erişim tokenlarını paylaşmayın

Dosya Yükleri

PKCS#12/PEM dosyalarını versiyon kontrolüne koymayın; secret storage üzerinden yükleyin

Hostname Doğrulama

Disable Hostname Verification yalnızca test için kullanılmalı; production’da false bırakılması önerilir

Kimlik Bilgileri Yönetimi

Kullanıcı adı ve şifre gibi hassas bilgileri environment variable veya secret manager kullanarak saklayın. Kimlik bilgilerini kod veya konfigürasyon dosyalarına hardcode etmeyin. Periyodik olarak şifreleri güncelleyin

SSL/TLS Kullanımı

Production ortamında mutlaka SSL/TLS aktif edin. Self-signed sertifikalar sadece development ortamında kullanın. Sertifika expiration tarihlerini takip edin ve zamanında yenileyin

Erişim Kontrolü

Connection yapılandırmasını sadece yetkili kullanıcıların değiştirmesine izin verin. Connection değişiklik loglarını saklayın. Kritik connection’lar için değişiklik approval süreci uygulayın

İndex Adı Yeniden Kullanımı

Neden kaçınılmalı: Aynı template’i paylaşan indekslerde çakışma yaratır.
Alternatif: Proje bazlı prefix kullanın

Eksik Host Tanımı

Neden kaçınılmalı: Tek host arızasında tüm akış durur.
Alternatif: En az iki host girin, health check izleyin

İzin Verilmeyen TLS Tipleri

Neden kaçınılmalı: Yanlış dosya tipi handshake başarısızlığına yol açar.
Alternatif: HTTPS seçimine uygun sertifika paketini kullanın

Production Connection'ı Test Ortamında Kullanma

Neden kaçınılmalı: Test verileri production sistemine yazılabilir, gerçek kullanıcılar etkilenebilir, güvenlik riski oluşur.
Alternatif: Her ortam için ayrı connection oluşturun, environment parametresini kullanın, connection isimlerini ortama göre prefix ekleyerek ayırın (Test_, Prod_)

Çok Düşük Timeout Değerleri

Neden kaçınılmalı: Ağ gecikmelerinde connection sürekli timeout olur, Entegrasyon adımları başarısız olur.
Alternatif: Gerçek kullanım senaryolarına göre timeout değerlerini ayarlayın, network latency’yi ölçün ve timeout’ları buna göre belirleyin

Connection Pool Kullanmama

Neden kaçınılmalı: Her istekte yeni bağlantı açılır, performans düşer, kaynak tüketimi artar, hedef sistem yükü artar.
Alternatif: Connection pool aktif edin, pool size’ı trafik hacmine göre ayarlayın, pool monitoring kurun

Shard/Replica Planlaması

Öneri: Günlük kayıt hacmine göre shard sayısını belirleyin, replica sayısını cluster kapasitesine göre ayarlayın.
Etki: Arama performansı artar, disk kullanımı dengelenir

ILM Faz Süreleri

Öneri: Hot fazı kısa, cold fazı uzun tutarak depolama maliyetini azaltın.
Etki: Pahalı düğümlerde gereksiz veri tutulmaz

Thread Pool İzleme

Öneri: Monitor ekranından bulk/search queue uzunluklarını takip edin; eşikler aşarsa ioThreads/pool değerlerini yükseltin.
Etki: Kuyrukta bekleyen istek sayısı azalır

Connection Pool Optimizasyonu

Öneri: Pool size’ı peak trafiğe göre ayarlayın (önerilen: eşzamanlı istek sayısı × 1.5), idle connection timeout’ları belirleyin, pool health check yapın.
Etki: Bağlantı açma maliyeti %80 azalır, yanıt süreleri düşer, kaynak kullanımı optimize edilir

Timeout Değerleri Optimizasyonu

Öneri: Gerçek network latency’yi ölçün, timeout değerlerini buna göre ayarlayın, çok düşük veya çok yüksek timeout’lardan kaçının.
Etki: Gereksiz beklemeler önlenir, hızlı fail-over sağlanır, kullanıcı deneyimi iyileşir

Connection Monitoring

Öneri: Connection pool kullanımını izleyin, timeout oranlarını takip edin, connection health check yapın, alerting kurun.
Etki: Sorunlar proaktif tespit edilir, performans darboğazları erken belirlenir, kesinti süresi azalır

​
Sorun Giderme (Troubleshooting)

Administrate kapalı, Template adı çakışıyor veya Elasticsearch kullanıcı yetkisi yetersiz olabilir.
1

Administrate Etkinleştirme

Administrate’i etkinleştirin.
2

Template Adı

Template adını değiştirin.
3

Kullanıcı Yetkisi

Kullanıcıya manage_index_templates yetkisi verin.
Policy adı mevcut, Hot phase devre dışı veya UI modalı kapatılmamış olabilir.
1

Policy Adı

Policy adını benzersiz yapın.
2

Hot Fazı

Hot fazı etkinleştirin.
3

Modal Kaydetme

Modalda Save’e basıp tekrar deneyin.
Network gecikmesi, hedef sistem yavaş yanıt veriyor veya timeout değeri çok düşük olabilir.
1

Network Kontrolü

Network connectivity kontrol edin.
2

Sistem Sağlığı

Hedef sistem sağlığını kontrol edin.
3

Timeout Ayarları

Timeout değerlerini artırın.
4

Log İnceleme

Connection loglarını inceleyin.
Yanlış kullanıcı adı/şifre, expired credentials veya yetki problemi olabilir.
1

Kimlik Bilgileri

Kimlik bilgilerini doğrulayın.
2

Kullanıcı Durumu

Hedef sistemde kullanıcının aktif olduğunu kontrol edin.
3

Yetki Kontrolü

Gerekli yetkilerin verildiğini kontrol edin.
4

Sertifika Kontrolü

SSL/TLS sertifikalarını kontrol edin.
Pool size çok düşük, connection leak var veya trafik çok yüksek olabilir.
1

Pool Size

Pool size’ı artırın.
2

Connection Kontrolü

Connection’ların düzgün kapatıldığını kontrol edin.
3

Idle Timeout

Idle connection timeout’ları ayarlayın.
4

Metrik İzleme

Connection kullanım metriklerini izleyin.
Integration/Connector adımında farklı connection seçili olabilir, adım yanlış yapılandırılmış olabilir veya Flow/Job redeploy edilmemiş olabilir.
1

Enable Toggle

Connection’ın enable toggle’ının aktif olduğunu kontrol edin.
2

Connection Seçimi

Integration Flow’da doğru connection’ın seçildiğini doğrulayın.
3

Connection Deploy

Connection’ı tekrar deploy edin.
4

Flow/Job Deploy

Integration Flow veya Job’ı redeploy edin.
5

Log Kontrolü

Gateway loglarını kontrol edin.

​
Sık Sorulan Sorular (SSS)

Ortam dropdown’ı sayesinde aynı connection içinde Development/Test/Production değerleri tutulabilir; ancak erişim politikaları için ayrı connection oluşturmak daha güvenlidir.
Belirtilen connection’ın aktif indeksini manuel olarak rollover eder; ILM eşiği dolmadan önce acil durumlarda kullanılabilir.
Hayır, en az bir host HTTPS seçilmedikçe TLS alanları görünmez; güvenlik gereksinimi için host scheme’i güncelleyin.
Aynı template ve policy adıyla oluşturulan indeksler etkilenir; farklı adlar kullanırsanız manuel atama gerekir.
Elasticsearch node’larının bulk/search/ingest queue uzunluklarını, rejection sayılarını ve aktif thread sayısını gösterir; performans tuning için kullanılır.
Evet, aynı connection birden fazla Integration Flow veya Connector adımında kullanılabilir. Bu merkezi yönetim sağlar ve konfigürasyon tutarlılığını garanti eder. Ancak connection’da yapılan değişiklikler tüm kullanım yerlerini etkileyeceği için dikkatli olunmalıdır.
Connection pool kullanımı zorunlu değildir ancak yüksek trafikli sistemlerde şiddetle önerilir. Her istekte yeni bağlantı açmak yerine mevcut bağlantıları yeniden kullanmak performansı önemli ölçüde artırır.
Evet, her ortam için ayrı connection oluşturmanız önerilir. Alternatif olarak environment parametresini kullanarak tek connection içinde tüm ortamları yönetebilirsiniz. Bu yaklaşım daha kolay yönetim ve daha az hata riski sağlar.
Birkaç neden olabilir:
  1. Connection enable toggle’ı pasif olabilir
  2. Integration adımında farklı bir connection seçili olabilir
  3. Connection deploy edilmemiş olabilir
  4. Integration Flow henüz redeploy edilmemiş olabilir