Forem: Emine Nur Arıcı

Kafka Kurulumu ve Zabbix JMX Entegrasyonu

Emine Nur Arıcı — Mon, 08 Dec 2025 10:45:43 +0000

Bu doküman; Ubuntu ortamında Kafka kurulumunu, JMX portunun aktif edilmesini, Zabbix Java Gateway kurulumunu ve metriklerin doğrulanmasını kapsar.

BÖLÜM 1: Kafka Sunucusu Kurulumu ve Yapılandırması (Host Tarafı)

1. Java Kurulumu ve Hazırlık

Kafka'nın çalışması için Java gereklidir.

sudo apt update
sudo apt install openjdk-17-jdk -y
java -version

2. Kafka'nın İndirilmesi ve Kurulması

Kafka 3.6.1 sürümü indirilir, arşivden çıkarılır ve /opt dizinine taşınır.

cd /tmp
wget https://archive.apache.org/dist/kafka/3.6.1/kafka_2.13-3.6.1.tgz

# Çıkart
tar -xvzf kafka_2.13-3.6.1.tgz

# Taşı
sudo mv kafka_2.13-3.6.1 /opt/kafka

# Klasöre gir
cd /opt/kafka

3. Servislerin Başlatılması (JMX Aktif)

Önce Zookeeper, ardından JMX portu (9999) tanımlanarak Kafka başlatılır.

# Zookeeper başlat
bin/zookeeper-server-start.sh -daemon config/zookeeper.properties

# JMX Portunu tanımla ve Kafka'yı başlat
export JMX_PORT=9999
bin/kafka-server-start.sh -daemon config/server.properties

4. Kontroller

Servislerin ve portun çalıştığı doğrulanır.

# Processleri gör (Kafka ve QuorumPeerMain görmelisin)
jps

# 9999 Portu dinleniyor mu? (Çıktı boş dönmemeli)
ss -tpln | grep 9999

BÖLÜM 2: Zabbix Server Tarafı Yapılandırması

Zabbix sunucusunun Java uygulamalarıyla konuşabilmesi için Java Gateway kurulmalı ve yapılandırılmalıdır.

1. Java Gateway Kurulumu

sudo apt update
sudo apt install zabbix-java-gateway -y
sudo systemctl enable --now zabbix-java-gateway

2. Zabbix Server Konfigürasyonu

Konfigürasyon dosyası düzenlenerek Java Gateway tanıtılır.

sudo nano /etc/zabbix/zabbix_server.conf

Dosya içerisinde aşağıdaki satırlar bulunur ve düzenlenir (veya eklenir):

# Gateway'in nerede olduğu (Aynı makinede olduğu için 127.0.0.1)
JavaGateway=127.0.0.1

# Gateway'in dinlediği port (Varsayılan 10052)
JavaGatewayPort=10052

# Java izleyecek işçi sayısı (Burası 0 ise çalışmaz, en az 5 yap)
StartJavaPollers=5

3. Servisi Yeniden Başlatma

sudo systemctl restart zabbix-server

BÖLÜM 3: Zabbix Web Arayüzü Konfigürasyonu

Kafka hostunun Zabbix'e eklenmesi adımlarıdır.

Menüye Git: Data Collection (veya Configuration) > Hosts yolunu izle. Sağ üstteki Create host butonuna tıkla.

Host Bilgilerini Gir:

Host name: emine-kafka (veya istenilen isim).
Templates: Apache Kafka by JMX (Verilerin gelmesini sağlayan kritik şablon).
Host groups: Applications veya Linux servers.

Bağlantı Ayarlarını (Interface) Yap:

Interfaces satırındaki Add butonuna bas ve JMX seç.
IP Address: 192.168.100.1 (Kafka makinesinin IP'si).
Port: 9999

Kaydet ve İzle:

Add butonuna tıkla.
Listede Availability sütunundaki JMX ikonunun gri renkten YEŞİL renge dönmesi beklenir (1-2 dakika sürebilir).

BÖLÜM 4: Sorun Giderme (SSL/Auth Hatası)

Eğer ikon yeşil yanmazsa ve aşağıdaki hata alınırsa:

HATA: SSL peer shut down incorrectly: service:jmx:rmi:///jndi/rmi://192.168.100.1:9999/jmxrmi

Çözüm Adımları:

Kafka durdurulur ve SSL/Kimlik doğrulama devre dışı bırakılarak IP adresi sabitlenir.

cd /opt/kafka
bin/kafka-server-stop.sh

# SSL ve Auth kapatılır, Hostname sabitlenir (IP adresini kendi yapınıza göre düzenleyin)
export KAFKA_JMX_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Djava.rmi.server.hostname=192.168.100.1"

export JMX_PORT=9999
bin/kafka-server-start.sh -daemon config/server.properties

BÖLÜM 5: Veri Doğrulama (JmxTool Testi)

Zabbix'e gelen verinin doğruluğunu teyit etmek için Kafka sunucusu üzerinde JmxTool kullanılır. Zabbix'teki değer ile terminal çıktısı karşılaştırılır.

Senaryo:

Item: Produce request total time, mean
Key: jmx["kafka.network:type=RequestMetrics,name=TotalTimeMs,request=Produce","Mean"]
Zabbix'te görülen değer: 0

Doğrulama Komutu (Kafka Sunucusu):

ubuntu@ubuntu:/opt/kafka$ cd /opt/kafka

JMX_PORT="" bin/kafka-run-class.sh kafka.tools.JmxTool \
  --jmx-url service:jmx:rmi:///jndi/rmi://127.0.0.1:9999/jmxrmi \
  --object-name "kafka.network:type=RequestMetrics,name=TotalTimeMs,request=Produce" \
  --attributes Mean \
  --date-format "YYYY-MM-dd HH:mm:ss"

Örnek Çıktı:

WARNING: The 'kafka.tools' package is deprecated...
Trying to connect to JMX url: service:jmx:rmi:///jndi/rmi://127.0.0.1:9999/jmxrmi
"time","kafka.network:type=RequestMetrics,name=TotalTimeMs,request=Produce:Mean"
2025-12-08 07:21:43,0.0
2025-12-08 07:21:45,0.0
2025-12-08 07:21:47,0.0

Sonuç: Terminal çıktısı da 0.0 döndüğü için Zabbix'e gelen veri doğrudur.

Docker Run İle SSL Sertifikalı Keycloak Kurma

Emine Nur Arıcı — Wed, 22 Oct 2025 12:19:10 +0000

bu kurulum için bir domain adına ihtiyacımız var benim senaryomda keycloak.local olarak ilerleyeceğim.

1. Adım: Host makinemde, yani browserımla keycloak'a erişeceğim makinede /etc/hosts dosyasını nano ile açıp en alta şunu ekleyelim:
<ip-adresi> keycloak.local

2. Adım: Nginx kurulumu

sudo apt update
sudo apt install nginx

3. Adım: SSL sertifikası oluşturma
önce sertifikayı koyacak dosya oluşturalım.

sudo mkdir -p /etc/ssl/certs/keycloak

openssl ile sertifika oluşturalım

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout /etc/ssl/certs/keycloak/keycloak.key \
 -out /etc/ssl/certs/keycloak/keycloak.crt \
 -subj "/CN=keycloak.local"

4. Adım: Nginx yapılandırma

Yeni yapılandırma dosyası oluşturalım

sudo nano /etc/nginx/sites-available/keycloak.conf

aşağıdaki içeriği dosyanın içine yapıştıralım

server {
    listen 80;
    server_name keycloak.local;
    # HTTP'den HTTPS'e yönlendir
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name keycloak.local;

    # SSL Sertifikalarının yolu
    ssl_certificate /etc/ssl/certs/keycloak/keycloak.crt;
    ssl_certificate_key /etc/ssl/certs/keycloak/keycloak.key;

    location / {
        # İsteği, Docker'da çalışan Keycloak'a yönlendir
        proxy_pass http://127.0.0.1:8080;

        # Gerekli HTTP başlıklarını ayarla
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

5. Adım: Yapılandırmayı aktive etme ve nginx'i yeniden başlatma

sudo ln -s /etc/nginx/sites-available/keycloak.conf /etc/nginx/sites-enabled/

Nginx'in varsayılan "Welcome" sayfasını devre dışı bırakalım (çakışmasın):

sudo rm /etc/nginx/sites-enabled/default

test edelim

sudo nginx -t

restart edelim

sudo systemctl restart nginx

6. Adım: Keycloak'ı kurma ve yapılandırma

Öncelikle Docker kurmamız lazım.

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

kurulumu başlatalım

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

servis kontrolü yapmak istersek bu komutu çalıştıralım

sudo systemctl status docker

Keycloak'ı docker run komutu ile kuralım. Burada kullanıcı adı şifre ve hostname verilir.

sudo docker run -d \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin \
  -e KC_PROXY_HEADERS=xforwarded \
  -e KC_HOSTNAME=keycloak.local \
  quay.io/keycloak/keycloak:latest \
  start-dev

sudo docker ps ile kontrol yapılabilir.

son olarak https://keycloak.local adresinden admin admin ile giriş yapalım.

Netex Server ve Netex Sensör kurulumu

Emine Nur Arıcı — Wed, 08 Oct 2025 10:23:12 +0000

NETEX SERVER KURMA ADIMLARI

not: zabbixin LTS sürümünün kurulu olduğu varsayılmıştır. Zabbix kurulumu için: zabbix kurulumu

Postgresql kurulumu:

sudo apt update
sudo apt install postgresql postgresql-contrib

veritabanı sunucusuna bağlanma:

sudo -u postgres psql

Kullanıcı ve veritabanımızı oluşturalım

CREATE USER netex WITH PASSWORD '1';
CREATE DATABASE netex WITH OWNER netex;

Daha sonrasında \q ile çıkış yapabiliriz

NETEX server kurulumu:

kurulumu size verilen deb dosyası ile yapabilirsiniz.

sudo apt install ./netex-sensor-455-x64.deb -y

Sonra düzenleme yapabilmek için sudo suile root kullanıcısına geçiyoruz, oradan
cd /opt/netex
komutu ile netex klasörüne geçip env.example içindeki içeriği .env içerisine kopyalıyoruz.

cp env.example .env

nano .env ile .env dosyasını açıp içini düzenliyoruz:

storage configuration kısmında farklı isimlerde DB ve USER oluşturulmadıysa değişiklik yapnmaya gerek yoktur.
Zabbix ayarlarını yaparken zabbix kurarken kullandığınız kullanıcı adı ve passwordu giriyoruz. URL kısmındaki ip adresi kısmına da zabbixin kurulu olduğu serverın ipsini giriyoruz.
JWT KEY ‘i bulmak için Liman'ın kurulu olduğu makineye gidip

 sudo su
cd /liman
cd server
cat .env

diyoruz ve çıkan .env dosyasının içeriğinde en altta JWT_SECRET’ı buluyoruz. Sonrasında .env dosyasında JWT kısmına yapıştırıyoruz.

.env dosyasının aşağıdaki kısımlarını yukarıdaki bilgilere göre düzenliyoruz.

# Storage Configuration @required
DB_HOST=127.0.0.1
DB_NAME=netex
DB_PASS=netex
DB_PORT=5432
DB_USER=netex

ZABBIX_USERNAME="<zabbix_username>"
ZABBIX_PASSWORD="<zabbix_password>"
ZABBIX_URL="<http://zabbix_ip_adresi/zabbix/api_jsonrpc.php>"
ZABBIX_SYNC="ON"

# Liman JWT Secret for http admin service usage @not-required
JWT_SECRET= <yukarıda nasıl bulunacağı belirtildi.>

Daha sonrasında bu iki komutla restart edip netex server'daki tüm servisleri kontrol edelim:


sudo systemctl restart netex@*
sudo systemctl status netex@*

NETEX SENSÖR KURMA ADIMLARI

netex kurulu makinede şunları yapalım:

sudo su
cd /opt/netex/clients
ls

burada sensör için gerekli kurulum dosyaları sıralanır. Ubuntu cihaza deb dosyası şu şekilde kurulur:

apt install ./netex-sensor-455-x64.deb -y

opt/netex-sensor/.env dosyasının içeriğini düzenleyelim.

SERVER_URL="https://<netex_server_ip>:7782"
SENSOR_IP="<netex_server_ip>"
DNS_SERVER_URL="<DNS_server_ip>:53"
DEBUG_MODE="OFF"
PORT_MIRRORING_INTERFACE="ens18"

SOURCE_IP_KEY=8
DEST_IP_KEY=12
SOURCE_MAC_KEY=56
DEST_MAC_KEY=57

Not: Lisans olmadığında netex-sensör çalışmayacaktır.

** NETEX’İ LİMAN ARAYÜZÜNE EKLEME**

Limanı kurduğumuz ip adresindeki Liman arayüzüne gidelim.
Öncelikle sunucular ekranına gelelim ve sunucu ekle diyelim.
Bu kısımda portu kendimiz ekliyoruz bu portu bulmak için terminalde netex'i restart ettikten sonra journalctl -u netex@* -fçalıştırdığımda şöyle bir çıktı alıyoruz ve orada port numarası yazıyor. Onu resimdeki belirtilen alana giriyoruz.

bu durımda bu port 7781

Anahatar Türü kısmında anahtarsız giriş seçelim.
Netex kurulu sunucumuzu ekleyelim ve sol panelden sunucumuza tıklayalım . eklentiler kısmına basalım. buradan da eklenti ekle diyelim.
Ekle diyerek ağ keşif seçelim ve böylelikle eklentiyi eklemiş olduk.
Arayüzde sol panelden eklentiye tıkladığımızda lisanslanmamış olsa da anasayfa açılır: