- Bunlardan ilki metrik verilerdir. Metrik verilerin saklanması isteğe bağlı değildir.
- İkincisi ise; İstemci → API Proxy, API Proxy → Backend API, Backend API → API Proxy, API Proxy → İstemci sırası ile iletilen istek ve yanıt mesajlarının, bu 4 bölgedeki içeriklerini oluşturan başlık (header), parametre (parameter) ve gövde (body) alanlarından oluşan kayıtlardır. Bu alanlardan hangilerinin log kayıtlarında bulunacağı ihtiyaca göre ya da log sunucusunun kaynak tüketimi baz alınarak belirlenebilir.
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ı
Üretim Ortamı Önerileri
Ü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
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
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ı Ekranı
Log ayarları ekranında API Proxy 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 gibi tüm connector tipleri için geçerlidir. Örneğin Kafka connector’üne hangi verilerin gönderileceğini (başlık, parametre, gövde gibi alanlar) seçebilirsiniz.
Global ayarlar ekranında da log ayarları yapılandırılabilir. Detaylı bilgi için Global Trafik Log Ayarları sayfasına bakabilirsiniz.
Düzenle Dialog Ekranı
Düzenle butonuna tıklandığında açılan dialog ekranında log ayarları yapılandırılabilir:
| Alan | Açıklama |
|---|---|
| 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. |
| Konnektörler | İlgili logların hangi konnektöre gönderileceğini seçmek için kullanılır. |
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.