Uptime Kuma ile Kesinti ve Uptime İzleme (Durum Sayfası)

Bir web sitesinin ya da API'nin gece yarısı çöktüğünü müşterinizden önce öğrenmek, dijital işlerin en temel ama en sık ihmal edilen ihtiyaçlarından biridir. Çoğu ekip bir kesintiyi ancak birileri "site açılmıyor" diye yazdığında fark eder; bu gecikme hem itibarı hem de geliri yıpratır. Uptime Kuma tam bu boşluğu doldurmak için geliştirilmiş, açık kaynaklı ve kendi sunucunuzda barındırabileceğiniz bir izleme (monitoring) aracıdır.

Bu rehberde Uptime Kuma'nın ne olduğunu, hangi kontrol türlerini desteklediğini, tipik kullanım senaryolarını, kendi altyapınızda barındırmanın neden mantıklı olduğunu ve gerçekçi kurulum gereksinimlerini adım adım ele alacağız. Amaç, aracı gereğinden fazla parlatmadan, gerçekten işinize yarayacak bilgiyi vermek.

Uptime Kuma nedir, ne işe yarar?#

Uptime Kuma, belirlediğiniz sitelere, servislere ve sunuculara düzenli aralıklarla istek göndererek "ayakta mı, ne kadar hızlı yanıt veriyor?" sorusunu yanıtlayan bir izleme yazılımıdır. Node.js ile yazılmış, tek bir web arayüzünden yönetilen ve modern bir gösterge paneli (dashboard) sunan bir uygulamadır. Louis Lam tarafından başlatılan proje, GitHub'da geniş bir topluluk tarafından geliştirilmeye devam eder. UptimeRobot veya Pingdom gibi ücretli bulut servislerine alternatif olarak sıkça tercih edilir; çünkü verileriniz kendi sunucunuzda kalır ve tekrar eden bir abonelik ücreti yoktur.

Temelde iki iş yapar: birincisi, izlediğiniz her hedefin çalışıp çalışmadığını sürekli kontrol eder; ikincisi, bir sorun tespit ettiğinde sizi seçtiğiniz kanaldan uyarır. Bunların üzerine bir de geçmiş veri (önceki kesintiler, yanıt süreleri, uptime yüzdesi) ve isteğe bağlı olarak müşterilerinizle paylaşabileceğiniz herkese açık bir durum sayfası ekler.

Temel özellikler#

Uptime Kuma'yı öne çıkaran özellikleri birkaç başlıkta toplamak mümkün:

• Çoklu kontrol türü: HTTP(S), TCP portu, ping (ICMP), DNS kaydı, SSL sertifika süresi ve veritabanı bağlantısı (MySQL, PostgreSQL, MongoDB, Redis gibi) dahil birçok yöntem. Yani yalnızca web sitenizi değil, arka plandaki servisleri de izleyebilirsiniz.
• Anahtar kelime ve durum kodu kontrolü: Sayfanın açılması tek başına yeterli değildir; yanıtın içinde belirli bir metnin (örneğin "Sepetim") bulunmasını ya da HTTP durum kodunun 200 olmasını şart koşabilirsiniz. Böylece "açılıyor ama aslında hata sayfası dönüyor" durumlarını da yakalarsınız.
• Esnek bildirim entegrasyonları: Telegram, e-posta (SMTP), Discord, Slack, Microsoft Teams, genel webhook ve onlarca farklı servise anlık uyarı gönderebilir.
• Herkese açık durum sayfası: Servislerinizin güncel durumunu gösteren, kendi logo ve renklerinizle özelleştirebileceğiniz bir sayfa oluşturabilirsiniz.
• Uptime istatistikleri: 24 saat, 30 gün ve 1 yıllık uptime yüzdesi, ortalama yanıt süresi ve kesinti geçmişi otomatik hesaplanır ve grafiklerle sunulur.
• Bakım penceresi (maintenance) planlama: Planlı bakım sırasında gereksiz alarm almamak için önceden zaman aralığı tanımlayabilirsiniz.
• Çok dilli arayüz: Türkçe dahil pek çok dili destekler.

Kullanım senaryoları#

Uptime Kuma esnek yapısı sayesinde farklı ölçeklerdeki ekiplere hitap eder. En yaygın senaryolar şunlardır:

1. Kişisel siteler ve bloglar: Tek bir WordPress sitesi işleten biri bile, sitesi çöktüğünde Telegram'dan anında haber almak ister.
2. Ajanslar ve web tasarımcıları: Onlarca müşteri sitesini tek panelden izleyip her müşteriye ayrı bir durum sayfası açabilir. Bir siteyi taşırken kesinti süresini ölçmek için site taşıma sürecinizde de işe yarar.
3. SaaS ve API sağlayıcıları: Kritik uç noktaların (endpoint) yanıt süresini izleyerek performans düşüşlerini erkenden fark eder.
4. Kurumsal iç servisler: Ofis içi veritabanları, VPN sunucuları veya mikroservisler gibi dışarıya kapalı sistemleri izlemek için uygundur (izleyicinin bu ağa erişebiliyor olması koşuluyla).
5. E-ticaret siteleri: Ödeme sayfası ya da sepet gibi doğrudan gelirle bağlantılı adımların anahtar kelime kontrolüyle izlenmesi, sessizce kaçan satışların önüne geçer.

Örneğin bir e-ticaret sitesinin ödeme sayfasını izlemek için kuracağınız basit bir HTTP kontrolünün mantığı kabaca şöyledir:

Tür: HTTP(s) - Anahtar Kelime
URL: https://magazam.com/odeme
Anahtar Kelime: "Kart Bilgileri"
Kontrol Aralığı: 60 saniye
Yeniden Deneme: 3
Bildirim: Telegram + E-posta

Buradaki mantık şu: sayfa açılsa bile "Kart Bilgileri" metni yanıtta yoksa Uptime Kuma bunu arıza sayar; üç kez arka arkaya başarısız olursa hem Telegram'dan hem e-postadan uyarı düşer. Bu sayede yalnızca "sunucu ayakta mı" değil, "ödeme akışı gerçekten çalışıyor mu" sorusuna da yanıt almış olursunuz.

Avantajlar ve dikkat edilmesi gerekenler#

Uptime Kuma'nın en belirgin avantajı, oldukça yetenekli bir izleme setini ücretsiz ve açık kaynak olarak sunmasıdır. Kurulumu ve arayüzü, benzer teknik araçlara kıyasla sadedir; bir izleme aracını ilk kez kuran biri bile kısa sürede alışır. Verilerin tamamen sizde kalması ve pratikte sunucunuz elverdiği ölçüde çok sayıda izleme (monitor) ekleyebilmeniz de önemli artılardır.

Bununla birlikte dengeli olmakta fayda var; her araç gibi Uptime Kuma'nın da göz önünde bulundurulması gereken yönleri var:

• İzlediğiniz sitelerle aynı sunucuya kurmayın: İzleme aracını izlediğiniz sitelerle aynı sunucuya kurarsanız, sunucu çöktüğünde hem siteniz hem de uyarı sisteminiz aynı anda devre dışı kalır ve kesintiyi hiç duymazsınız. İzlemeyi ayrı, küçük bir sunucuda tutmak en sağlıklısıdır.
• Tek düğüm (single-node) yapısı: Uptime Kuma varsayılan olarak tek bir konumdan kontrol yapar. "Farklı ülkelerden ping atıp coğrafi olarak dağıtık ölçüm alma" özelliği kutudan çıktığı gibi gelmez; bunun için ayrı düğümler kurmanız gerekir.
• Ölçekleme sınırları: Çok yüksek sayıda ve çok sık kontrol yapan büyük operasyonlarda, tek düğümlü yapı zorlanabilir. Bu tür kurumsal ölçekler için özelleşmiş araçlar daha uygun olabilir; küçük ve orta ölçek için Uptime Kuma fazlasıyla yeterlidir.
• Bildirimleri mutlaka test edin: SMTP ya da Telegram entegrasyonunu kurduktan sonra bir kez test etmeden geçmeyin; yanlış yapılandırılmış bir bildirim, kesinti anında hiçbir uyarı almamanız anlamına gelir.

Neden kendi sunucunuzda barındırmalısınız?#

Uptime Kuma'yı bir bulut servisine para vermek yerine kendi sunucunuzda çalıştırmanın (self-host) birkaç somut nedeni var:

Veri sahipliği ve KVKK. İzleme verisi, hangi servislerinizin ne zaman çöktüğü gibi bilgileri içerir; kimi senaryolarda izlediğiniz uç noktalar müşteri verisiyle dolaylı olarak ilişkilidir. Bu bilgiyi yurt dışındaki üçüncü taraf bir servise emanet etmek yerine Türkiye'deki kendi sunucunuzda tutmak, KVKK uyumu ve veri egemenliği açısından daha rahat bir konumdur.

Maliyet. Ücretli izleme servisleri genellikle izleme sayısına ve kontrol sıklığına göre aylık ücret alır; izleme sayınız arttıkça fatura da büyür. Uptime Kuma ise tek seferlik bir kurulumla, mütevazı bir sunucuda çok sayıda izlemeyi ek ücret olmadan çalıştırır. Uzun vadede bu ciddi bir tasarruf anlamına gelir.

Kontrol ve esneklik. Kontrol aralığını 20 saniyeye kadar düşürebilir, istediğiniz bildirim kanalını ekleyebilir, durum sayfasını kendi alan adınızda kendi markanızla yayımlayabilirsiniz. Katı "plan limitleri" olmadan aracı ihtiyacınıza göre şekillendirirsiniz.

Kendi kendine barındırma yaklaşımını benimseyen başka araçlara da göz atmak isterseniz, açık kaynak dünyasında bol seçenek var. Örneğin veri analizi için Metabase üzerine hazırladığımız rehbere, otomasyon içinse OpenClaw hakkındaki yazımıza bakabilirsiniz.

Kurulum ve gereksinimler#

Uptime Kuma iki şekilde kurulabilir: doğrudan Node.js ile ("bare metal") ya da Docker konteyneri olarak. Pratikte en çok tercih edilen yol Docker'dır; çünkü tüm bağımlılıkları tek bir imaj içinde toparlar ve güncelleme ile yedeklemeyi belirgin biçimde kolaylaştırır. Tipik bir Docker kurulumu şuna benzer:

docker run -d --restart=always \
  -p 3001:3001 \
  -v uptime-kuma-data:/app/data \
  --name uptime-kuma \
  louislam/uptime-kuma:1

Bu komut aracı 3001 portunda başlatır ve verilerinizi uptime-kuma-data adlı kalıcı bir birimde (volume) saklar. Ardından tarayıcıdan sunucunuzun IP adresine :3001 ekleyerek kurulum sihirbazını açar, yönetici hesabınızı oluşturur ve ilk izlemenizi eklemeye başlarsınız. Verileri bir volume içinde tuttuğunuz için, konteyneri güncellediğinizde geçmişiniz kaybolmaz.

Donanım gereksinimleri oldukça mütevazıdır. Birkaç düzine izleme için 1 vCPU ve 512 MB – 1 GB RAM'e sahip küçük bir sunucu genellikle yeterlidir. İzleme sayınız ve saklanan veri geçmişiniz büyüdükçe biraz daha kaynak ayırmanız gerekebilir. Bu tür hafif ama kesintisiz çalışması gereken işler için bir sanal sunucu (VDS) ya da genel sunucu çözümlerimiz uygun bir zemin sunar.

Docker komutları ve terminalle uğraşmak istemiyorsanız, en pratik yol tek tıkla kurulumdur. Clou.TR App Center, Uptime Kuma'yı sizin için otomatik olarak hazırlar; port yönlendirmesi, kalıcı depolama ve güncellemeler arka planda halledilir. Kuruluma Uptime Kuma App Center sayfasından başlayabilir, diğer hazır uygulamaları da App Center kataloğunda inceleyebilirsiniz. Kurulumdan sonra, izleme geçmişinizi düzenli yedekleme ile güvence altına almak da iyi bir alışkanlıktır.

Benzer araçlarla kısa karşılaştırma#

Uptime izleme alanında Uptime Kuma'nın yanında dikkate değer başka araçlar da vardır. Aşağıdaki tablo temel farkları özetler:

Kısaca özetlemek gerekirse: sıfır kurulumla ve farklı coğrafyalardan kontrol istiyorsanız SaaS çözümler; verilerinizin tamamen sizde kalmasını ve düşük maliyetle çok sayıda izleme yapabilmeyi önemsiyorsanız Uptime Kuma öne çıkar. Çok derin metrik ve grafik ihtiyacınız varsa Prometheus/Grafana ikilisi daha güçlüdür ama kurması ve yönetmesi belirgin biçimde daha zordur. Küçük ve orta ölçekli ekiplerin çoğu için Uptime Kuma, sadelik ile yetenek arasında dengeli bir orta yol sunar.

Sıkça Sorulan Sorular#

Uptime Kuma tamamen ücretsiz mi?#

Evet. Uptime Kuma açık kaynaklıdır ve MIT lisansıyla ücretsiz dağıtılır; herhangi bir lisans ya da abonelik ücreti yoktur. Yalnızca aracı çalıştıracağınız sunucunun maliyetini karşılarsınız, o kadar.

İzleme aracını izlediğim sitelerle aynı sunucuya kurabilir miyim?#

Teknik olarak mümkündür ancak önerilmez. Site ve izleme aracı aynı sunucuda olursa, sunucu çöktüğünde her ikisi de aynı anda düşer ve kesintiden haberiniz olmaz. En doğrusu, izlemeyi ayrı ve küçük bir sunucuda çalıştırmaktır.

Durum sayfasını kendi alan adımda yayınlayabilir miyim?#

Evet. Uptime Kuma'nın oluşturduğu durum sayfasını bir alt alan adına (örneğin durum.siteniz.com) yönlendirip kendi markanızla yayımlayabilirsiniz. Böylece müşterileriniz servislerinizin güncel durumunu şeffaf biçimde takip edebilir.

Hangi bildirim kanallarını destekliyor?#

Telegram, e-posta (SMTP), Discord, Slack, Microsoft Teams, genel webhook ve daha pek çok servisi destekler. Birden fazla kanalı aynı anda tanımlayarak, kesinti anında hem anlık mesaj hem de e-posta alacak şekilde ayarlayabilirsiniz.

Uptime Kuma ne kadar sık kontrol yapabilir?#

Kontrol aralığını her izleme için ayrı ayrı belirleyebilirsiniz; en sık 20 saniyede bir kontrolden birkaç dakikaya kadar esnek bir aralık sunar. Daha sık kontrol daha hızlı uyarı demektir, ancak sunucu ve ağ üzerindeki yükü de bir miktar artırır; çoğu senaryo için 60 saniye makul bir başlangıçtır.

Kurulum için teknik bilgi şart mı?#

Docker ile elle kurulum bir miktar komut satırı bilgisi ister. Ancak Clou.TR App Center'ın tek tıkla kurulumunu kullanırsanız komut satırına hiç dokunmadan aracı hazır hâlde alırsınız; yalnızca yönetici hesabınızı oluşturup izlemelerinizi eklemeniz yeterli olur.

Sitelerinizin ve servislerinizin sürekli ayakta olduğundan emin olmak, dijital işlerin sessiz ama kritik bir parçasıdır. Uptime Kuma bu işi sade, yetenekli ve tümüyle sizin denetiminizde bir araçla yapmanızı sağlar. Uğraşmadan hızlıca başlamak isterseniz, Uptime Kuma'yı Clou.TR App Center üzerinden tek tıkla kurabilir ve birkaç dakika içinde ilk izlemenizi eklemeye başlayabilirsiniz.