Laravel Telescope, Pulse ve Nightwatch: Hangi İzleme Aracına Gerçekten İhtiyacınız Var?

İlk olarak hafiz.dev‘da yayımlandı.

Laravel ekosisteminde üç resmi izleme aracı bulunmaktadır. Ancak hangi aracı ne zaman kullanacağınız konusunda net bir açıklama yok. Eğer Laravel belgelerine baktığınızda “Peki ama hangisini gerçekten almalıyım?” diye düşündüyseniz, yalnız değilsiniz. Nightwatch tanıtıldığında böyle bir yazının var olması gerektiği düşünülüyor.

Kısa versiyonu: Telescope, yerel geliştirme hata ayıklama için; Pulse, yüksek düzeyde üretim metrikleri için; Nightwatch ise tam üretim gözlemlenmesi içindir. Ancak bu çerçeve tek başına karar vermenize yardımcı olmuyor. O yüzden daha derine inelim.

Her Aracın Çözdüğü Sorunlar

Bu üç araç, izleme sürecinin tek bir sorun olmadığı gerçeğinden doğmuştur. İzlemenin üç ayrı problemin yan yana gelmesidir:

Yerel geliştirme sırasında, uygulamanızın şu anda ne yaptığını bilmeniz gerekir. Her sorguyu, her işi, her e-postayı ve lezzetli detayları görmek istersiniz.

Üretim ortamında, nelerin yanlış gittiğine bağlı olarak iki çok farklı şeye ihtiyacınız vardır. Bir sağlık kontrolü yaparken (“her şey yolunda mı?”), toplu metriklere ihtiyacınız var. Bir sorun yaşandığında ve bir kullanıcı etkilenirse, neyin nasıl olduğu, hangi sırayla olduğu ve kimin etkilendiğine dair tam hikayeye ihtiyacınız var.

Bu üç farklı ihtiyacı karşılamama sebep. Telescope birincisini çözer. Pulse ikincisini çözer. Nightwatch ise üçüncüsünü çözer.

Laravel Telescope: Yerel Hata Ayıklama Destekçiniz

Telescope, bu üç araç arasında en olgunudur. 2018’den beri Laravel ekosisteminde yer almakta ve ücretsizdir. Geliştirici bağımlılığı olarak kurun, tarayıcınızda /telescope‘u ziyaret edin ve uygulamanızda olan her şeyi detaylı bir şekilde sunan bir log elde edin.

Kurulum için composer require laravel/telescope --dev komutunu çalıştırın, ardından php artisan telescope:install ve php artisan migrate komutlarını çalıştırın. Her istek, Eloquent sorgusu, iş gönderimi, e-posta, bildirim, olay, önbellek işlemi ve istisna, tam SQL, yığın izleri ve zamanlaması ile temiz bir gösterge panelinde görünmektedir.

Telescope’un başka hiçbir aracın yapmadığı şey, bir isteğin tam bağlamını göstermesidir. Örneğin, GET /dashboard isteği 47 sorgu çalıştırdı, 340ms sürdü, 2 iş gönderildi ve 6 olay tetiklendi – tüm detayları bir bakışta görebilirsiniz.

Telescope için önemli kural: onu asla üretimde çalıştırmayın. Her isteği veritabanınıza kaydettiğinden, ciddi performans yükü ve potansiyel bir gizlilik problemi yaratır. Resmi öneri, onu bir ortam kontrolü ile sınırlamaktır. AppServiceProvider içinde App::isLocal() kontrolü yaparak Telescope’u kaydetmeden önce kontrol edebilir veya sadece --dev ile talep ederseniz, üretim ortamında hiç kullanılmayacaktır.

Telescope ücretsizdir. Yerel geliştirme, sahne hata ayıklama ve CI sorun giderme için doğru araçtır. Üretim için yanlış bir seçimdir.

Laravel Pulse: Üretim Sağlık Gösterge Paneli

Pulse, (Laravel 11 ile birlikte) daha yeni bir araçtır ve Telescope ile karşıt bir konumda bulunmaktadır. Telescope ayrıntılı ve detaylıyken, Pulse toplu ve yüksek seviyededir. “Uygulamam şu anda sağlıklı mı?” sorusu için oluşturulmuştur.

Kurmak için composer require laravel/pulse komutunu kullanın, ardından php artisan pulse:install ve php artisan migrate komutlarını çalıştırın. /pulse‘u ziyaret ettiğinizde CPU kullanımı, bellek, yavaş sorgular, yavaş yollar, başarısız işler, kuyruk derinliği ve önbellek hit oranı gibi toplanmış metrikleri gösteren bir gösterge paneli göreceksiniz.

Pulse, kendi altyapınızda çalışır ve sıfır dış bağımlılığa sahiptir. Her şey kendi veritabanınıza kaydedilir. Dış bir hizmet yoktur, SaaS hesabı yoktur, olay kotaları yoktur. Tüm veriye sahipsiniz.

Sınırlama, “toplu” teriminin pratikte ne anlama geldiğidir. Pulse, /api/orders‘un son bir saat içinde 800ms P95 yanıt süresine sahip olduğunu söyler. Ancak, hangi belirli isteğin 2,400ms sürdüğünü, kimin tetiklediğini, o isteğin sırasında hangi sorguların çalıştığını ya da bu sorguların nasıl birbirleriyle ilişkilendiğini göstermez. Trend bilgisini verir. Olay bilgisini vermez.

Pulse ayrıca php artisan pulse:work‘inin bir daemon olarak çalışmasını gerektirir. Bu hafif bir süreçtir, ancak Supervisor yapılandırmanızda hesaba katmalısınız. Alternatif olarak, ayrı bir daemon gerektirmeyen daha az trafik alan uygulamalar için inline sürücüsünü kullanabilirsiniz.

Pulse, olayları hızlı bir şekilde belirlemek ve anormallikleri gözlemlemek için doğru bir araçtır. Ancak özel bir olayı araştırmak istediğinizde yanlış bir seçimdir.

Laravel Nightwatch: Tam Üretim Gözlemlenmesi

Nightwatch, Haziran 2025’te tanıtıldı ve Telescope ve Pulse’un kapsamadığı boşluğu doldurdu: Üretim ortamında bir şeylerin yanlış olduğunu biliyorsunuz ve ne olduğunu tam olarak anlamaya ihtiyacınız var.

Pulse toplu verileri gösterirken, Nightwatch her bir olayı saklar. Telescope sadece yerel olarak çalışırken, Nightwatch üretim için özel olarak tasarlanmıştır. İstek, kullanıcı, sorgular, işler, istisnalar ve zaman çizelgesi arasındaki bağlantıları tek bir görünümde bağlar.

Paketini composer require laravel/nightwatch ile kurun. NIGHTWATCH_TOKEN‘unuzu .env dosyasına ekleyin. Ardından ajansı başlatın:

php artisan nightwatch:agent

Ajan, yan süreç olarak çalışarak olayları yerel olarak tamponlar ve her yaklaşık 10 saniyede bir Nightwatch sunucularına gönderir. Yük, resmi belgelere göre iste başına 3ms’nin altındadır. Forge kullanıyorsanız, ajans kurulumu bir tıklama ile gerçekleştirilir. Cloud’da otomatik olarak çalışır.

Nightwatch, varsayılan olarak neyi takip eder; tam zamanlama ve kullanıcı bağlamı ile HTTP istekleri, yığın izleri ve etkilenen kullanıcı sayısı ile istisnalar, kaynakları ile Eloquent sorguları, yürütme süresi ve yeniden deneme geçmişi ile kuyruk işleri, çıkış HTTP istemleri, e-postalar, bildirimler, planlanmış görevler, önbellek işlemleri ve Artisan komutları.

Fiyat yapısı: ücretsiz plan, ayda 200,000 etkinliği kapsar, uygulamalar veya ortamlar üzerinde sınırlama yoktur ve 14 günlük raporlama sunar. Pro planı, 5M etkinlik, 30 günlük raporlama ve sınırsız koltuk için ayda 20$’dan başlar. Daha yüksek hacimler için Takım ve İşletme seviyeleri vardır.

Pulse’dan pratikte temel fark: bir kullanıcı, Salı gecesi saat 11:47’de ödeme işleminin zaman aşımına uğradığını bildirdiğinde, Nightwatch bunun tam olarak ne zaman gerçekleştiğini gösterebilir. Rota, kullanıcı, çalıştırılan 14 sorgu, hangi sorgunun 1,800ms sürdüğü, gönderilen iş, o işin başarılı olup olmadığı gibi detaylara ulaşmanızı sağlar. Pulse, Salı gecesinin P95 yanıt zamanlarının yükseldiğini gösterirken, olay ile ilgili bir cevabı sağlar. Bu, bir metrik ile bir yanıt arasındaki farktır.

Bir mimari not: Nightwatch, yan süreç ajansının sürekli çalışmasını gerektirir. Laravel Vapor gibi sunucusuz dağıtımlarda, ajansı çalıştırmak için ayrı bir VM’e ihtiyacınız olacaktır. Bu bir engel değildir, ancak planlamanız gereken bir konu.

Doğru Aracı Seçmek

Karar ağacı göründüğünden daha basittir:

hafiz.dev’de etkileşimli diyagramı görüntüleyin.

Birkaç gerçek senaryo ile durumu somutlaştıralım:

Tek geliştirici, yan proje, bütçe yok: Yerel geliştirme için Telescope’u kurun. Üretim için Pulse’u ekleyin. Ciddi durumlarda gözlemciye sahip olmamanız kabul edilebilir bir ticaret. Düşük trafikli yan projeler için buna razı olabilirsiniz.

Küçük bir ekip, ödeme yapan müşteriyle SaaS ürünü: Puls’un ücretsiz planında Nightwatch’ı ekleyin. 200k etkinlik, çoğu erken aşama SaaS uygulaması için yeterlidir. Müşteri bir sorun bildirdiğinde, bunu araştırabilecek veriye sahip olursunuz. Bu, “ücretsiz ama hatayı bulamayacağım” durumundan “müşterim pes etmeden hatayı buldum”a dönüşür.

Önemli bir trafiği olan yerleşik bir ürün: Üçünü birden çalıştırın. Yerel olarak Telescope, hızlı sağlık göstergesi için Pulse ve olay araştırması ile üretim hata ayıklama için Nightwatch. Tamamlayıcıdırlar, birbirleriyle rekabet etmezler. Nightwatch’ın ücretsiz planı, yüksek hacimli uç noktalarda örnekleme ayarlandığında beklenmedik derecede fazla trafiği karşılar.

Üç Aracı Birlikte Kullanabilir Miyiz?

Evet, resmi kılavuz bunu onaylıyor. Laravel, Nightwatch’ın büyümesine bağlı olarak Telescope ve Pulse’u desteklemeye devam edecek. Araçlar yalnızca yüzeysel olarak örtüşmektedir. Gerçek kullanımları, üretim uygulamalarınız için üçünü çalıştırmanın mantıklı olduğu kadar farklıdır.

Üç aracı birlikte çalıştıracak bir ekibin pratik kurulumu:

Telescope, bir geliştirme bağımlılığıdır; sadece yerel ve sahnede bulunur. Pulse ve Nightwatch ise üretimde bulunur. Pulse php artisan pulse:work‘ü bir denetlenen daemon olarak çalıştırır. Nightwatch ise php artisan nightwatch:agent‘i bir denetlenen daemon olarak çalıştırır. İki ajan birbirleriyle etkileşime geçmez.

Nightwatch eklemeye karar verirseniz hemen yapmanız gereken bir şey: test ortamında devre dışı bırakın. NIGHTWATCH_ENABLED=false‘ı phpunit.xml‘ye veya test .env‘nize ekleyin. Test çalıştırmalarının etkinlik kotanızı yakmasını istemezsiniz.

Laravel Forge’da Nightwatch’ı Kurmak (En Hızlı Yol)

Forge kullanıyorsanız, Nightwatch’ın tek tıklama ile entegrasyonu mevcuttur. Forge site ayarlarınızda Nightwatch bölümünü bulun, ortam tokeninizi girin ve Forge otomatik olarak denetçi daemon’u oluşturur, çökmesi durumunda yeniden başlatır ve ortam değişkenlerini düzenler. Tüm işlem yaklaşık 90 saniye sürer.

Non-Forge sunucusu için, Supervisor yapılandırmasını manuel olarak ekleyin. /etc/supervisor/conf.d/nightwatch.conf dosyasını oluşturun:

[program:nightwatch]
process_name=%(program_name)s
command=php /var/www/your-app/artisan nightwatch:agent
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/your-app/storage/logs/nightwatch.log

Ardından sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start nightwatch komutunu çalıştırın.

Bu, Horizon veya başka bir uzun süre çalışan Laravel süreci için kullanacağınız aynı kalıptır. Zaten iş kuyruklarınız için Horizon’u çalıştırıyorsanız, Nightwatch eklemek tamamen aynı yöntemi takip eder. Eğer tam bir yürütme turu isterseniz, Laravel iş kuyrukları kılavuzu bu Supervisor yapılandırmasını detaylandırmaktadır.

Sıkça Sorulan Sorular

Geçen yıl Sentry’yi kullanıyorsam Nightwatch gerçekten faydalı mı?

Sentry özel olarak istisna izleme için mükemmel bir araçtır. Ancak yavaş sorgu verisi, kuyruk derinliği, önbellek kaçırma oranları veya zamanlayıcı sağlığı hakkında bilgi vermez. Nightwatch, istisnalar dahil olmak üzere tam resmi verir. Eğer Sentry’nin hata izleme akışını isterseniz, yan yana çalışabilirler; ancak Nightwatch tek başına daha geniş bir perspektif sunar.

Pulse, Telescope’un yerini alır mı?

Hayır. Pulse, üretim metrikleri içindir. Telescope, yerel hata ayıklamak içindir. Tamamen farklı amaçlar için hizmet ederler ve farklı ortamlarda çalışırlar.

Nightwatch paylaşımlı barındırmada çalışabilir mi?

Nightwatch ajansı sürekli bir süreç gerektirir; bu, çoğu paylaşımlı sunucunun desteklemediği bir durumdur. Bir VPS, Forge yönetimindeki bir sunucu, Laravel Cloud veya bir konteyner ortamına ihtiyacınız vardır. Eğer paylaşımlı barındırma kullanıyorsanız, Pulse tek üretim izleme seçeneğinizdir.

Nightwatch’ta bir “etkinlik” ne olarak sayılır?

Aşağıdakilerin her biri bir etkinlik olarak sayılır: bir HTTP isteği, bir çıkış HTTP isteği, bir kuyruk işleme, bir Eloquent sorgusu, bir e-posta gönderimi, bir bildirim, bir zamanlanmış görev çalıştırma, bir önbellek işlemi ve bir Artisan komutu çalıştırma, ve bir istisna. Tipik bir istekte 12 sorgu çalıştırıldığında, bu 13 etkinlik (1 istek + 12 sorgu) demektir. Yüksek trafikli uç noktalarda kotayı yönetmek için örnekleme yapılandırmasını kullanın.

Yerel geliştirmede Nightwatch’ı devre dışı bırakmalı mıyım?

Nightwatch’ı yerel olarak, Nightwatch hesabınızdaki ayrı bir geliştirme ortamıyla çalıştırabilirsiniz; ancak bu, ücretsiz kotanızı gereksiz yere harcar. Yerel .env dosyanızda NIGHTWATCH_ENABLED=false olarak ayarlayın ve Telescope’u yerel olarak kullanın. Tam olarak bunu başarmak için tasarlanmıştır.

Nightwatch Pratikte: Nerede Farkını Gösterir

Nightwatch’tan en çok faydalanan araçlar, en fazla hareketli parçaya sahip olanlardır. Eğer, birçok tüketici ile bir Laravel REST API çalıştırıyorsanız, Nightwatch hangi uç noktaların hangi kullanıcılar için yavaş olduğunu ve hangi harici hizmetlerin yanıt sürelerini düşürdüğünü göstermektedir.

Filament ile yönetim ağırlıklı SaaS uygulamaları geliştiriyorsanız, Nightwatch özellikle faydalıdır. Yönetim panelleri genellikle büyük veri setlerine karşı karmaşık Eloquent sorguları çalıştırır ve devre dışındaki N+1 sorunları gerçek üretim verileri ile görünür hale gelir. Kapsamlı Laravel + Filament SaaS kılavuzu en fazla üretim gözlemlenmesi istemcisini anlamınıza yardımcı olur. Nightwatch’ta Filament kaynak listelerinin 10,000 satırlık bir tablodaki her sayfa yüklemesinde 60 sorgu çalıştırdığını gördüğünüzde, hemen hangi ilişkiye besleme eklemeniz gerektiğini ve ilk olarak hangisinin optimizasyonunu yapmanız gerektiğini bilirsiniz.

Laravel geliştiricilerinin gözlem konusunda yaptığı en yaygın hata, durumu ikili bir şekilde ele almaktır: ya var ya yok. Gerçekte Telescope, Pulse ve Nightwatch, geliştirme döngüsündeki üç farklı sorunu çözer. Öncelikle yerel geliştirmede Telescope kullanın. Üretimde ücretsiz Pulse’u ekleyin. Kullanıcılarınız bir şeyler yanıldığında gecikmeden Nightwatch’ı ekleyin.

Bir Laravel uygulaması geliştiriyorsanız ve şeklinize uyan bu araçlardan hangisinin sizin için uygun olduğunu bilmiyorsanız, lütfen benimle iletişime geçin ve kurulumunuzu gözden geçirelim.