Ana içeriğe atla

​
Log Kaydı Tutulan Bölgeler

API Proxy mesajları şu bölgelerde loglanabilir:

Request from Client

İstemciden API Proxy’e gelen istek mesajları

Request to Target

API Proxy’den Backend API’ye iletilen istek mesajları

Response from Target

Backend API’den API Proxy’e verilen yanıt mesajları

Response to Client

API Proxy’den istemciye gönderilen yanıt mesajları
Varsayılan olarak, projenin tüm mesaj bölgelerindeki alanların loglanması aktiftir. Loglanan alanlar ihtiyaca göre veya log sunucusunun kaynak tüketimi baz alınarak kısıtlanabilir.

​
Üretim Ortamı Önerileri

Üretim Ortamı İçin Öneriler: Üretim ortamında aşağıdaki bölgelerin loglanmasının devre dışı bırakılması tavsiye edilir.
Üretim ortamında çalışan API Proxy’lerde tüm poliçelerin ayarları ve testleri tamamlandığı için geliştirme yapılmayacaktır. Veritabanında verilerin aşırı büyümemesi için şu bölgelerin loglanması devre dışı bırakılabilir:
  • Request to Target: API Proxy’den Backend API’ye iletilen istekler
  • Response from Target: Backend API’den API Proxy’e verilen yanıtlar
Bu iki bölgedeki başlık, parametre ve gövde verilerinin yazılmaması veritabanı boyutunu kontrol altında tutmaya yardımcı olur.

​
Hata Durumunda Loglama

Hata Durumunda Otomatik Loglama: Tüm loglama alanları kapalı olsa dahi, istekte bir hata oluştuysa log alanlarının tümü hatanın tespit edilebilmesi için otomatik olarak kayıt edilir. Bu özellik genel ayarlarda açılıp kapatılabilir.

​
Formdata İstekleri

Formdata İstekleri: Formdata istekleri değişken veri büyüklükleri ve veri formatları nedeniyle dosya kısımları hiçbir şekilde loglanmamaktadır. Sadece diğer metadata alanları loglanmaktadır.

​
WebSocket ve gRPC İstekleri

WebSocket ve gRPC: WebSocket ve gRPC istekleri Apinizer’a gelen ve Apinizer’dan çıkan veriler şeklinde tutulduğundan bu tip API Proxy’lerde sadece 2 bölge bulunur:
  • Request from Client / Response to Client
  • Request to Target / Response from Target

​
Log Ayarları Sekmesi

API Proxy detay sayfasında Log Ayarları (Log Settings) sekmesi, trafik log konfigürasyonunu yönetmek için ayrılmış özel bir sekmedir. Eskiden Settings sekmesinin en altında yer alan log ayarları bölümü, artık bu ayrı sekmeden yönetilir.
Üç Seviyeli Yapılandırma: Log ayarlarını üç seviyede yapılandırabilirsiniz:
  • API Proxy bazında: Her API Proxy için genel log ayarları
  • Ortam bazında: Seçilen ortama özel log ayarları (ayarlar ortam bazlı saklanır)
  • Metod bazında: Belirli API metodları için özel log ayarları (Method Overrides)

​
Log Ayarları Ekranı

Log Ayarları sekmesinde API Proxy bazlı ve ortam bazlı log ayarları yapılabilir. Eğer entegrasyon ayarları yapılmışsa, hangi API Proxy’lerin trafik kayıtlarının bu entegrasyon hedeflerine gönderilebileceği de ayarlanabilir. Bu ayarlar sadece Elasticsearch için değil, Kafka, RabbitMQ, Veritabanı, ActiveMQ, Syslog, Webhook, Logback, Graylog gibi tüm konnektör tipleri için geçerlidir. Konnektör listesi ortamda tanımlı olan konnektör nesnelerine göre dinamik olarak oluşturulur; aynı tipte birden fazla konnektör yapılandırılabilir ve her biri bağımsız olarak ayarlanır. Log Ayarları Sekmesi

​
Ekran yapısı

API Proxy üst menü: Overview, Settings, Design, Develop, Upstream / Routing, Tracing, Log Ayarları (Log Settings) (aktif sekme), API Traffic, API Analytics, Audit Records, Application Logs vb. Üst çubuk:
  • Ortam (Environment): Log ayarlarının uygulanacağı ortamı seçersiniz; ayarlar ortam bazında saklanır.
  • Kaydet ve Yayınla (Save and Deploy): Değişiklikleri kaydeder ve ilgili ortama dağıtımı tetikler.
Sol panel — CONNECTORS:
  • Seçilen ortamda tanımlı konnektörler listelenir (örnek ekranda Elasticsearch, Database, Graylog). Liste ortamdaki gerçek konnektör kayıtlarına göre dinamiktir.
  • Aynı tipte birden fazla konnektör varsa her biri ayırt edici adla gösterilebilir; tek örnekte yalnızca tip adı görünebilir.
  • Metod Geçersiz Kılmaları (Method Overrides): Belirli API metodları için varsayılanlardan farklı log kuralları tanımlanır; tanım sayısı rozetle gösterilir.
Ana alan — seçilen konnektör (ör. Elasticsearch):
  • Konnektör için Etkin (Enabled) durumu (ör. yeşil rozet) ve Bu ortam için etkin (Active for this environment) anahtarı ile bu ortamda log gönderiminin açılıp kapatılması.
  • Log içeriği seçimi (Log Content Selection) — birbirinden bağımsız gruplar (birini kapatmak diğerlerini etkilemez):
    • HTTP İstek Detayları (HTTP Request Details) — IP, metot, URI, port vb.
    • Performans Metrikleri (Performance Metrics) — süre, boyut, önbellek vb.
    • Yanıt Durum Bilgisi (Response Status Info) — durum kodu, hata tipi vb.
    • Yönlendirme Adresi (Routing Address)
  • İstek ve yanıt akışı: Dört mesaj bölgesi üzerinden Parametre, Başlık (Header) ve Gövde (Body) loglaması ayrı ayrı açılıp kapatılır; istek taraflarında üç alan, yanıt taraflarında tipik olarak Başlık ve Gövde kullanılır. Her bölgede Kısmi boyut (Partial Size) ile gövde/başlık için kısmi kayıt modu yönetilebilir.
  • Gizlilik (Privacy): Açıkken, öğe adı ve işlem tipine göre maskeleme vb. kuralları tanımlayan tablo kullanılır; + Ekle ile ortama özel gizlilik tanımları eklenir. Tanım yoksa tabloda bilgi mesajı görünür.
API Proxy Log Ayarları — Elasticsearch konnektörü, log içeriği seçimi ve mesaj akışı bölgeleri
Platform genelinde geçerli log ayarlarını Genel Ayarlar ekranından yapılandırabilirsiniz.

​
Konnektör Ayarları

Her konnektör nesnesi için aşağıdaki alanlar bağımsız olarak yapılandırılabilir:
AlanAçıklama
Etkin (Enabled)Konnektörün bu ortamda kullanılabilir olup olmadığını gösterir (ör. yeşil rozet).
Bu ortam için etkin (Active for this environment)Seçilen ortamda bu konnektöre log gönderiminin açık/kapalı olmasını belirler.
Log içeriği seçimi (Log Content Selection)HTTP istek detayları, performans metrikleri, yanıt durum bilgisi, yönlendirme adresi gibi üst düzey alan gruplarının loglanıp loglanmayacağını ayrı ayrı seçersiniz.
Kısmi boyut (Partial Size)İlgili mesaj bölgesinde başlık/gövde için tam kayıt yerine kısmi (boyut sınırlı) kayıt modunu açar veya kapatır.
Başlık (Header)İlgili bölgedeki mesajın Başlık alanındaki değerlerin loglanmasını sağlar. Mesajdaki başlık bilgilerinin loglanıp loglanmadığını yönetir.
Gövde (Body)İlgili bölgedeki mesajın Gövde alanındaki değerin loglanmasını sağlar. Mesajdaki gövde bilgilerinin loglanıp loglanmadığını yönetir.
Parametre (Parameter)İlgili bölgedeki mesajın Parametre alanındaki değerlerin loglanmasını sağlar. Mesajdaki parametre bilgilerinin loglanıp loglanmadığını yönetir.

​
Metod Geçersiz Kılmaları

Belirli API metodları için varsayılan konnektör ayarlarından farklı log ayarları tanımlayabilirsiniz. Örneğin hassas bir metot için gövde loglamasını kapatabilir, diğer metodlar için açık bırakabilirsiniz.
  • Metod Geçersiz Kılması Ekle (Add Method Override): Metod ve konnektör seçerek özel ayar tanımlarsınız.
  • Her geçersiz kılma için başlık, parametre ve gövde loglaması ayrı ayrı yapılandırılabilir.
  • Mevcut geçersiz kılmalar düzenlenebilir veya silinebilir.
Daha önce yapılmış log ayarları otomatik olarak korunur. Mevcut ayarlar yeni konnektör bazlı sisteme sorunsuz geçiş yapar; ek bir işlem gerekmez.

​
Gizlilik Ayarları

API Proxy trafik loglarında hassas verilerin korunması için gizlilik ayarları yapılabilir. Bu ayarlar connector’ler environment’a eklenirken yapılandırılır. Hangi alanların loglanacağı ve hangi alanlarda gizlilik işlemleri (maskeleme, silme, hashleme, şifreleme) uygulanacağı belirlenebilir. Detaylı bilgi için Gateway Ortamlarına Konnektör Eklenmesi sayfasına bakabilirsiniz.
Log Ayarları bölümünde, log ayarları API Proxy bazlı olarak yönetilir.

​
İlgili Sayfalar

​
Sonraki Adımlar

Genel Ayarlar

API Proxy genel ayarları

Genel Bilgi Sekmesi

API Proxy genel bilgileri