Ana içeriğe atla
Bu dokümanda, Apinizer’da kullanılan geolocation verilerinin Kibana Maps özelliği ile hangi şehirlerden istek geldiğinin harita üzerinde nasıl görselleştirileceği anlatılacaktır. Apinizer’da 2025 versiyonu ile birlikte geolocation özelliğini kullanabilirsiniz. Geolocation özelliğini kullanmak için ilgili dökümanı Geolocation Şehir Bazlı Erişim Kontrolü sayfasına bakabilirsiniz.

​
1) Apinizer Üzerinden Sağlanan Geolocation Verisi

Apinizer’da gelen isteğin coğrafi konum verisi, Elasticsearch’te aşağıdaki gibi bir JSON formatında temsil edilmektedir. 
{
  "toClientBody": "[]",
  "loc": {
    "lat": 41.0,
    "lon": 28.0
  }
}
Lat (latitude) ve lon (longitude) değerleri, bir noktanın Dünya üzerindeki konumunu belirlemek için kullanılan coğrafi koordinatlardır. Örneğin:
  • Latitude: 41.0082° N, Longitude: 28.9784° E (İstanbul, Türkiye)
  • Latitude: 40.7128° N, Longitude: 74.0060° W (New York, ABD)

​
2) Kibana’ya Veri Aktarma

​
2.1) Index Pattern Oluşturma

Kibana’ya veri aktarma adımında, Kibana kurulumu ve entegrasyonu sağlanmalıdır. Kibana kurulumu için ilgili dökümana Kibana API Trafik Log Görselleştirme sayfasına bakabilirsiniz. Kurulum sonrası Kibana’da, Stack Management → Index Patterns sayfasında, ‘Create Index Pattern’ bölümünden yeni bir index pattern oluşturulabilir: Index Pattern Oluşturma Elasticsearch’te kullanılan data stream seçilerek adımlar tamamlanır ve oluşturma işlemi gerçekleştirilir: Data Stream Seçimi Oluşturma işlemi tamamlandıktan sonra, ilgili alanları (fields) aşağıdaki sayfada görebilirsiniz: Index Pattern Fields Görünümü

​
2.2) Mevcut Index Pattern’i Kontrol Etme

Kibana daha önce kurulduysa ve index pattern mevcutsa aşağıdaki Stack Management → Index Patterns sayfasıdan Kibanaya eklediğiniz indeksi yenileyin. Arama kısmına ‘loc’ yazarak ilgili değerin var olduğunu kontrol etmelisiniz. loc Field Kontrolü Kibana, bu ‘loc’ verilerini (enlem ve boylam) kullanarak, harita üzerinde gelen isteklerin görselleştirilmesini sağlar.

​
3) Kibana Maps ile Harita Paneli Eklemek ve Görselleştirmesi

Kibana ana sayfasında, sol menüdeki “Maps” sekmesine tıklayın. Bu, harita görselleştirmeleri oluşturmak için kullanacağınız uygulamadır: Kibana Maps Menüsü Add layer butonuna tıklayın. Documents seçeneğini tercih edin: Add Layer Documents Seçimi Index pattern’ı seçtikten sonra, ‘loc’ alanı otomatik seçilecek. Ardından, ‘Add layer’ butonuna tıklayıp katmanı ekleyip isim vererek kaydedebilirsiniz: loc Alanı ile Layer Ekleme

​
4) Sonuç

Bu dokümanda, Apinizer’a gelen isteklerin IP bilgileri coğrafi verilere dönüştürülüp Elasticsearch’e gönderildikten sonra, Kibana Maps kullanılarak hangi şehirlerden istek geldiği adım adım görselleştirilmiştir. Bu yapı sayesinde, kullanıcı erişimleri şehir bazında analiz edilebilir. Harita üzerinde gelen istekler, yeşil işaretçilerle gösterilecektir: Kibana Maps Harita Sonucu