Documentation Index
Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
Use this file to discover all available pages before exploring further.
Genel Bakış
Amacı Nedir?
- Log Politikası, mesaj işleme hattının (pipeline) herhangi bir noktasına yerleştirilerek o anki mesaj durumunun anlık görüntüsünü (snapshot) yakalar ve belirlenen konnektörlere gönderir.
- Standart trafik loglamasından farklı olarak, pipeline’ın ara noktalarında (örneğin bir dönüştürme politikasından önce ve sonra) loglama yaparak mesaj değişikliklerini izlemeyi sağlar.
- HTTP, WebSocket ve gRPC protokollerinde çalışır.
- Birden fazla konnektöre aynı anda gönderim yapabilir.
Çalışma Prensibi
- Politika Tetiklenmesi: Mesaj işleme hattında log politikasının sırası geldiğinde çalışır.
- Anlık Görüntü Oluşturma: O anki mesaj durumu protokole özel olarak yakalanır (başlık, parametre, gövde bilgileri).
- Konnektörlere Gönderim: Anlık görüntü, tanımlanan her konnektöre ayrı ayrı gönderilir.
- Gizlilik Uygulama: Gizlilik ayarları etkinse, hassas veriler gönderimden önce işlenir (maskeleme, silme, hashleme, şifreleme).
Özellikler ve Yetenekler
Temel Özellikler
- Senkron/Asenkron Çalışma: Senkron modda gönderim tamamlanana kadar pipeline bekler; asenkron modda pipeline devam eder, gönderim arka planda yapılır.
- Çoklu Protokol Desteği: HTTP, WebSocket ve gRPC protokollerinde çalışır.
- Çoklu Konnektör Gönderimi: Aynı anlık görüntü birden fazla konnektöre gönderilebilir.
- Alan Bazlı Kontrol: Başlık, parametre, gövde, metadata ve metrik bilgilerinin her biri ayrı ayrı açılıp kapatılabilir.
- Gövde Boyutu Sınırlama: Gövde verisi tam veya kısmi olarak loglanabilir. Kısmi modda maksimum boyut belirlenebilir.
- Politika Seviyesinde Gizlilik: Hassas veriler için maskeleme, silme, hashleme veya şifreleme uygulanabilir.
- Koşul Bazlı Çalışma: Koşul tanımlayarak politikanın yalnızca belirli durumlarda çalışmasını sağlayabilirsiniz.
Protokol Desteği
| Protokol | Başlık (Header) | Parametre | Gövde (Body) |
|---|---|---|---|
| HTTP | ✓ | ✓ | ✓ |
| WebSocket | ✓ | — | ✓ |
| gRPC | — | — | ✓ |
WebSocket ve gRPC protokollerinde başlık ve parametre bilgileri protokol yapısı gereği sınırlı olabilir.
Konfigürasyon Alanları
Genel Ayarlar
| Alan | Açıklama |
|---|---|
| Ad | Politikanın tanımlayıcı adı |
| Açıklama | Politikanın amacını belirten açıklama |
| Aktif | Politikanın aktif/pasif durumu |
| Çalışma Modu | Senkron veya Asenkron çalışma modu (aşağıda detaylandırılmıştır) |
| Koşul | Politikanın ne zaman çalışacağını belirleyen koşul (isteğe bağlı) |
Konnektör Seçimi
Politikanın log göndereceği konnektörleri seçebilirsiniz. Konnektörler, bağlantı tanımı üzerinden seçilir ve ortam bağımsız çalışır — aynı bağlantı tanımı farklı ortamlarda farklı konnektör örneklerine karşılık gelebilir.
Global politika olarak işaretlenen tanımlar birden fazla ortamda kullanılabilir; her ortamda aynı bağlantı tanımına karşılık gelen konnektörün yapılandırılmış olması gerekir.
Loglanan Alanlar
Aşağıdaki alan gruplarından hangilerinin log kaydına dahil edileceğini belirleyebilirsiniz:| Alan Grubu | Açıklama |
|---|---|
| İstemciden Gelen İstek Başlıkları | İstemciden API Proxy’ye gelen istek başlık bilgileri |
| İstemciden Gelen İstek Parametreleri | İstemciden API Proxy’ye gelen istek parametreleri |
| İstemciden Gelen İstek Gövdesi | İstemciden API Proxy’ye gelen istek gövdesi |
| Hedefe Gönderilen İstek Başlıkları | API Proxy’den Backend API’ye gönderilen istek başlık bilgileri |
| Hedefe Gönderilen İstek Parametreleri | API Proxy’den Backend API’ye gönderilen istek parametreleri |
| Hedefe Gönderilen İstek Gövdesi | API Proxy’den Backend API’ye gönderilen istek gövdesi |
| Hedeften Gelen Yanıt Başlıkları | Backend API’den gelen yanıt başlık bilgileri |
| Hedeften Gelen Yanıt Gövdesi | Backend API’den gelen yanıt gövdesi |
| İstemciye Gönderilen Yanıt Başlıkları | İstemciye gönderilen yanıt başlık bilgileri |
| İstemciye Gönderilen Yanıt Gövdesi | İstemciye gönderilen yanıt gövdesi |
| Metadata | IP adresi, HTTP metodu, URI, port gibi istek metadata bilgileri |
| Metrikler | Süre, boyut, önbellek durumu gibi performans metrikleri |
Gövde Loglama Modu
| Mod | Açıklama |
|---|---|
| Tam (Full) | Gövde verisi tamamen loglanır |
| Kısmi (Partial) | Gövde verisi belirtilen maksimum boyuta kadar loglanır. Boyut aşıldığında veri kesilir |
Gizlilik Ayarları
| İşlem | Açıklama |
|---|---|
| Maskeleme (Mask) | Hassas veriyi kısmen gizler (ör: ****1234) |
| Silme (Delete) | Hassas veriyi tamamen kaldırır |
| Hashleme (Hash) | Hassas veriyi tek yönlü hash değerine dönüştürür |
| Şifreleme (Encrypt) | Hassas veriyi şifreler |
Gizlilik ayarları iki seviyede uygulanır: önce politika seviyesindeki ayarlar, sonra konnektör seviyesindeki ayarlar. Her iki seviye de etkinse, her ikisi de sırasıyla uygulanır.
Senkron ve Asenkron Çalışma
| Mod | Gönderim | Hata Durumu | Pipeline Etkisi |
|---|---|---|---|
| Senkron (varsayılan) | Sıralı, tamamlanana kadar beklenir | Hata fırlatılır | Pipeline kırılır |
| Asenkron | Arka planda, beklenmez | Hata loglanır, yutulur | Pipeline devam eder |
Kullanım Senaryoları
| Senaryo | Açıklama | Önerilen Mod |
|---|---|---|
| Dönüştürme öncesi/sonrası karşılaştırma | Bir dönüştürme politikasından önce ve sonra log politikası ekleyerek mesaj değişikliklerini izleme | Asenkron |
| Hata ayıklama (Debug) | Belirli bir politikanın girdi ve çıktısını incelemek için pipeline’a geçici log noktası ekleme | Senkron |
| Denetim kaydı | Hassas API’lerde her isteğin tam kaydını tutma | Asenkron |
| Çoklu hedef loglama | Aynı mesajı Elasticsearch ve Kafka’ya aynı anda gönderme | Asenkron |
| Koşullu loglama | Yalnızca belirli bir başlık değeri veya yol ile eşleşen istekleri loglama | Asenkron |
İlgili Sayfalar
- Mesaj Akışı ve Politika Yönetimi
- API Proxy Trafik Log Ayarları
- Konnektörler
- Gateway Ortamlarına Konnektör Eklenmesi
Sonraki Adımlar
Script Politikası
Özel script ile veri dönüştürme
API Çağrısı Politikası
Pipeline içinde harici API çağrısı