Ana içeriğe geç

Sorun Giderme

Apinizer'ın Kubernetes, Docker ve Sanal Sunucu kurulumlarında karşılaşılabilecek sorunların tanı ve çözüm rehberidir. Kurulum tipinize göre uygun sekmeyi seçerek sorununuzu bulabilirsiniz.

API Manager Sorun Giderme​

Konteyner URI is not set veya DATABASE is not set ile exit oluyor​

Zorunlu env var boş. Değerleri verip yeniden oluşturun. ?replicaSet=…&authSource=… shell quoting'ine dikkat — -e SPRING_DATA_MONGODB_URI="…" çift tırnaklı veya env-file ile geçirin.

Health endpoint 503 OUT_OF_SERVICE dönüyor​

MongoDB erişilemez durumda. Konteyner içinden test:

docker exec -it apinizer-apimanager sh -lc \
  "wget -qO- $SPRING_DATA_MONGODB_URI" 2>&1 | head

Host 32 GB olduğu hâlde log'da Memory tier: 1GB (heap 50%…) görünüyor​

--memory / mem_limit vermediniz. Cgroup default'u max ve auto-tuner host belleğine düşer. mem_limit'i konteynerin gerçekten kullanmasını istediğiniz değere set edin.

MongoDB bağlantısı timeout​

  • Ağ erişimini doğrulayın: docker exec apinizer-apimanager sh -lc 'nc -zv mongo 25080'.
  • URI'da replicaSet= ve authSource= doğru mu?
  • MongoDB'ye TLS gerekiyorsa &tls=true ekleyin ve CA dosyasını mount edin.

Worker Sorun Giderme​

APINIZER_ENVIRONMENT_NAME uyuşmazlığı → konteyner başlıyor ama proxy yüklenmiyor​

İsim Manager UI'daki bir Environment ile case-sensitive eşleşmiyorsa proxy snapshot çekilmez ve her istek 404 döner. Çözüm: env var'ı düzeltin veya Environment oluşturun.

UnsatisfiedLinkError: brotli​

Alpine üzerinde custom build çalıştırıyorsunuz. Resmi apinizercloud/worker (Ubuntu noble) imajına geri dönün.

EMFILE: too many open files​

docker run'a --ulimit nofile=1048576:1048576 ekleyin. Host tarafında /etc/security/limits.conf / daemon'un LimitNOFILE değerinin de izin verdiğinden emin olun.

Cache Sorun Giderme​

Peer listesi doğru ama her node Members {size:1} görüyor​

  • HAZELCAST_CLUSTER_NAME her node'da case-sensitive eşleşiyor mu?
  • 5701/tcp her iki yönde erişilebilir mi: konteyner içinden nc -zv <peer-ip> 5701.
  • NAT arkasında çoklu host kurulumu (cloud) için TCP/IP discovery routable, simetrik adres ister.

Quota'lar beklenmedik sıfırlanıyor​

CACHE_QUOTA_TIMEZONE değeri Worker / Manager timezone'undan farklı. Hepsi aynı olmalı.

Integration Sorun Giderme​

Quartz job beklenen zamanda fire olmadı​

  • INTEGRATION_TIMEZONE'ı Manager'daki cron expression'a göre kontrol edin.
  • Çoklu Integration node'ları farklı timezone'larla tutarsız fire oluşturur.

Hard kill sonrası Locked by another scheduler ile exit​

Önceki konteyner trigger ortasında SIGKILL aldı. Yeni konteynerin lock-recovery sweep'i başlangıçta stale row'u temizler; gerekiyorsa bir clusterCheckin cycle bekleyin (default 7.5 s).

Manager UI Integration'ı offline gösteriyor​

Manager http://<integration-host>:8092/'a erişemiyor. Manager UI'daki host/port, firewall ve Integration konteynerinin boot sequence'ini bitirip bitirmediğini doğrulayın.

API Portal Sorun Giderme​

Konteyner sürekli restart, log'da API_PORTAL_ID is not set​

Zorunlu env var boş. Üçünü de verin: API_PORTAL_ID, API_PORTAL_MANAGEMENT_API_BASE_URL, API_PORTAL_MANAGEMENT_API_KEY.

Ana sayfa 502 Bad Gateway dönüyor​

Portal Manager REST API'ye erişemiyor. Konteyner içinden kontrol:

docker exec apinizer-apiportal sh -lc \
  "wget --header='X-Apinizer-Api-Key: $API_PORTAL_MANAGEMENT_API_KEY' \
        -qO- $API_PORTAL_MANAGEMENT_API_BASE_URL/api/portal/v1/ping"
En son tarihinde güncellendi