Arama Yap Mesaj Gönder
Biz Sizi Arayalım
+90
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro

Bize Ulaşın

Konum Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR

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.

Sentry Kurulumu: PHP, Laravel ve JavaScript Hatalarını Kendi Sunucunuzda İzleme
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
2. Swap oluşturma
sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo "/swapfile none swap sw 0 0" | sudo tee -a /etc/fstab
free -h
3. Kurulum
cd /opt
sudo git clone https://github.com/getsentry/self-hosted.git sentry-self-hosted
cd sentry-self-hosted
sudo ./install.sh
sudo docker compose up -d
4. Sağlık ve log
sudo docker compose ps
curl -I http://127.0.0.1:9000/_health/
sudo docker compose logs --since 15m --tail 200 web worker relay snuba-api
5. Laravel istemci
composer require sentry/sentry-laravel
php artisan sentry:publish --dsn=HTTPS_DSN_ADRESI
php artisan sentry:test
6. JavaScript istemci
npm install @sentry/browser
export SENTRY_AUTH_TOKEN=PROJE_TOKENI
npx sentry-cli sourcemaps inject ./dist
npx sentry-cli sourcemaps upload ./dist
7. Yedek öncesi durdurma
cd /opt/sentry-self-hosted
sudo docker compose stop web worker cron ingest-consumer post-process-forwarder
sudo docker compose exec -T postgres pg_dump -U postgres -Fc postgres > sentry-postgres-$(date +%F).dump
sudo docker compose start
8. Disk inceleme
sudo docker system df
sudo du -sh /var/lib/docker/volumes/* 2>/dev/null | sort -h | tail -20
sudo docker compose exec clickhouse clickhouse-client -q "SELECT database, formatReadableSize(sum(bytes_on_disk)) FROM system.parts GROUP BY database"
9. Nginx reverse proxy
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
sudo tee /etc/nginx/sites-available/sentry.example.com > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name sentry.example.com;
    client_max_body_size 10G;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_http_version 1.1;
        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;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
NGINX
sudo ln -s /etc/nginx/sites-available/sentry.example.com /etc/nginx/sites-enabled/sentry.example.com
sudo nginx -t
sudo systemctl reload nginx
10. Let’s Encrypt SSL ve yenileme testi
sudo certbot --nginx -d sentry.example.com --redirect --agree-tos --no-eff-email -m [email protected]
sudo certbot renew --dry-run
curl -I https://sentry.example.com
openssl s_client -connect sentry.example.com:443 -servername sentry.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

Üretime geçmeden önce bilinmesi gerekenler

Üretim notu
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 / SymptomKök neden ve çözüm / Root cause and fix
Kafka unhealthyRAM/swap, disk gecikmesi, broker logu ve volume izinleri kontrol edilir; körlemesine container restart yapılmaz.
ClickHouse disk dolduruyorRetention, proje event hacmi ve ClickHouse tablo boyutları ölçülür; volume elle silinmez.
Event gelmiyorDSN, outbound firewall, Relay health, proje ortamı ve SDK debug logu birlikte kontrol edilir.
Source map eşleşmiyorRelease/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

Resmî teknik kaynaklar

İlgili EKA Sunucu rehberleri

Sık sorulan sorular

Bu kurulum üretimde kullanılabilir mi?

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.

VPS paketlerini inceleyinKurulum için bize ulaşın
Top