Sentry Kurulumu: PHP, Laravel ve JavaScript Hatalarını Kendi Sunucunuzda İzleme
Sentry self-hosted platformunu Ubuntu’da kurun; gerçek kaynak ihtiyacı, alan adı ve SSL, ilk proje, Laravel/JavaScript SDK, source map, veri saklama, yedekleme, güncelleme ve Kafka/ClickHouse hata çözümünü öğrenin.
Bu rehberin sonunda ne çalışacak?
Sentry self-hosted platformunu Ubuntu’da kurun; gerçek kaynak ihtiyacı, alan adı ve SSL, ilk proje, Laravel/JavaScript SDK, source map, veri saklama, yedekleme, güncelleme ve Kafka/ClickHouse hata çözümünü öğrenin. Komutlar kopyalanabilir biçimde verilmiştir; örnek alan adları ve parolalar çalıştırılmadan önce kendi değerlerinizle değiştirilmelidir.
Kurulum öncesi mimari ve gereksinimler
Linux x86-64, Docker Engine ve Compose
Resmî minimum: 4 CPU çekirdeği, 16 GB RAM, 16 GB swap ve en az 20 GB boş disk
sentry.example.com DNS kaydı
Kafka, ClickHouse, PostgreSQL, Redis ve Relay için NVMe tercih edilmeli
DNS ve port planı
80/443 TCP: reverse proxy
9000/TCP: Sentry web yalnız localhost/reverse proxy
25/587 TCP çıkış: e-posta kullanılacaksa
Uygulamalı kurulum adımları
1. Kaynak kontrolü
nproc
free -h
df -hT
docker --version
docker compose version
Sentry’nin resmî minimumu 4 çekirdek, 16 GB RAM ve ayrıca 16 GB swap’tır. 2–4 GB VPS üzerinde kurulmuş görünse bile Kafka/ClickHouse yük altında kararsızlaşır.
Üretim notu
Sentry yalnız PostgreSQL değildir. Event verisi ClickHouse, mesaj akışı Kafka ve bazı geçici durumlar Redis üzerinde bulunur. Felaket kurtarma planı bütün bileşenleri ve sürüm uyumunu kapsamalıdır.
Üretim notu
Source map yayınlanmazsa minify edilmiş JavaScript stack trace’leri kullanışsız kalır. Release adı, deploy sürümü ve source map upload aynı CI/CD zincirinde üretilmelidir.
Üretim notu
Hata içeriği parola, token, form verisi veya kişisel bilgi taşıyabilir. SDK beforeSend filtresi, PII ayarı, proje erişimi ve saklama süresi üretimden önce belirlenmelidir.
Yaygın hatalar ve kök nedenleri
Belirti / Symptom
Kök neden ve çözüm / Root cause and fix
Kafka unhealthy
RAM/swap, disk gecikmesi, broker logu ve volume izinleri kontrol edilir; körlemesine container restart yapılmaz.
ClickHouse disk dolduruyor
Retention, proje event hacmi ve ClickHouse tablo boyutları ölçülür; volume elle silinmez.
Event gelmiyor
DSN, outbound firewall, Relay health, proje ortamı ve SDK debug logu birlikte kontrol edilir.
Source map eşleşmiyor
Release/dist değerleri uygulama event’i ile upload sırasında birebir aynı yapılır.
Kurulum sonrası doğrulama listesi
Tüm container veya servisler healthy/running durumda
Alan adı HTTPS üzerinden geçerli sertifika ile açılıyor
Yalnız gerekli portlar dışarıdan erişilebilir
Yönetici hesabında güçlü parola ve MFA etkin
Yedek dosyasının checksum değeri kaydedildi
Ayrı ortamda en az bir geri yükleme testi tamamlandı
Loglarda tekrarlayan kritik hata bulunmuyor
Yeniden başlatma sonrası servisler otomatik açılıyor
Evet; fakat örnek değerler değiştirilmeden, erişim sınırları uygulanmadan ve geri yükleme testi yapılmadan üretime alınmamalıdır.
Minimum sunucu yeterli olur mu?
Minimum değer yalnız kurulumun açılması içindir. Eş zamanlı kullanıcı, veri büyümesi ve arka plan işleri ölçülerek kaynak payı bırakılmalıdır.
Cloudflare kullanılabilir mi?
Evet. SSL modu Full (strict), doğru origin sertifikası ve WebSocket/gerçek IP başlıkları uygulamanın gereksinimine göre ayarlanmalıdır.
Güncelleme otomatik yapılmalı mı?
Major sürümler otomatik güncellenmemelidir. Sürüm notu, veritabanı migration bilgisi, yedek ve geri dönüş imajı kontrol edilmelidir.
Hangi yedekler alınmalı?
Veritabanı, yüklenen dosyalar, volume verileri, yapılandırma, şifreleme anahtarları ve kullanılan sürüm etiketi aynı geri dönüş setinde tutulmalıdır.
VPS mi GPU sunucu mu?
Web paneli ve standart iş yükleri için NVMe VPS yeterli olabilir. Model inference, OCR hızlandırma veya video transcoding varsa uygun GPU gerekir.
Kurulum için bize ulaşın
Sentry self-hosted platformunu Ubuntu’da kurun; gerçek kaynak ihtiyacı, alan adı ve SSL, ilk proje, Laravel/JavaScript SDK, source map, veri saklama, yedekleme, güncelleme ve Kafka/ClickHouse hata çözümünü öğrenin.