Uptime Kuma: kendi sunucunuzda çalışma süresi izleme
Sitelerinizi ve servislerinizi her dakika kontrol eden ve biri yanıt vermeyi bıraktığı anda size haber veren, kendi sunucunuzda çalışan bir izleyici.
Uptime Kuma hakkında
Uptime Kuma, geliştirici Louis Lam tarafından başlatılan ve bugün GitHub'da en çok yıldız alan kendi sunucunuzda çalışan projelerden biri olan açık kaynak bir izleme aracıdır. Bir şeylerin yanıt verip vermediğini kontrol eder: HTTP(S) üzerinden web siteleri, bir sayfadaki anahtar kelimeler, TCP portları, ping, DNS kayıtları, veritabanları ve daha fazlası.
Bir kontrol başarısız olduğunda Telegram, Discord, Slack, e-posta ve webhook'lar dahil desteklenen onlarca kanaldan biriyle bildirim gönderir. Yanıt sürelerini de takip eder, TLS sertifikalarının süresi dolmadan uyarır ve müşterileriniz için herkese açık durum sayfaları oluşturmanızı sağlar.
İnsanlar onu hafif, ücretsiz ve birkaç dakikada kurulan temiz bir arayüzü olduğu için kendi sunucularında çalıştırır. Onu ayrı bir sunucuda çalıştırmak kilit noktadır: sitenizle aynı makinede yaşayan bir izleyici o makine çöktüğünde size haber veremez.
Ne için kullanılır
Bir site çöktüğünde uyarılar
Web sitenizi ve API'nizi her dakika kontrol edin ve yanıt vermeyi bıraktıkları anda bir Telegram veya e-posta mesajı alın.
Sertifika süresi uyarıları
Bir HTTPS sertifikasının süresinin dolduğunu müşterilerden duymak yerine günler öncesinden hatırlatma alın.
Herkese açık bir durum sayfası
Servislerinizin güncel durumunu müşterilere sizin kontrol ettiğiniz bir sayfada gösterin.
Sipariş verdikten sonra
Sunucunun ilk açılışında Uptime Kuma kurulur ve güvenlik duvarında 3001 portu açılır; böylece izleyiciye http://sunucu-adresiniz:3001/ adresinden ulaşılır. İlk ziyarette yönetici hesabını oluşturursunuz; bu yüzden adresi sunucu hazır olur olmaz açın. Ardından ilk izleyicinizi ekleyin ve bir bildirim kanalı bağlayın.
Nerede çalıştırmalı
Uptime Kuma, çalıştığı yerden kontrol eder. İzlediği servislerle aynı sunucudaki bir izleyici onlarla birlikte çöker ve sizi uyaramaz; bu yüzden onu izlediği şeylerden ayrı bir sunucuda tutun.
Uptime Kuma için kendi alan adınız ve HTTPS
Uptime Kuma kurulduğu haliyle sunucunun IP adresinde düz HTTP üzerinden yanıt verir. Ona sertifikalı status.example.com gibi bir isim vermek için DNS'inizde o isim için sunucunun IPv4 adresini gösteren bir A kaydı oluşturun, ardından önüne Caddy koyun: Caddy ücretsiz bir Let's Encrypt sertifikasını kendisi alır ve yeniler. Aşağıdaki komutlar, uygulama sunucularımızın çalıştırdığı Ubuntu 24.04 içindir.
Panelde sunucunun güvenlik duvarında 80 ve 443 numaralı TCP portlarını açın: Caddy'nin Let's Encrypt sertifikasını alması ve siteyi sunması için bunlara ihtiyacı var.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyÖnünde bir alan adı olunca Uptime Kuma'nın durum sayfaları müşterilerinizle paylaşılabilir: bir durum sayfası oluşturun, hangi izleyicileri göstereceğini seçin ve https://status.example.com/status/sayfaniz adresini paylaşın. Alan adını ayarlarından doğrudan bir durum sayfasına da bağlayabilirsiniz.
Alan adı çalışınca artık kimsenin çıplak 3001 portuna ihtiyacı kalmaz: /opt/uptime-kuma/compose.yml dosyasında "3001:…" ifadesini "127.0.0.1:3001:…" olarak değiştirin, docker compose up -d çalıştırın ve 3001 portunu güvenlik duvarından kaldırın. Uptime Kuma artık yalnızca HTTPS üzerinden erişilebilir.
Uptime Kuma'yı güncellemek
/opt/uptime-kuma/compose.yml dosyasındaki imajlar tam sürümlere sabitlenmiştir; bu yüzden yalnızca docker compose pull aynı sürümü tekrar indirir. Güncellemek için image: satırındaki sürümü istediğinizle değiştirin (önce sürüm notlarını okuyun), ardından imajı indirip konteynerleri yeniden oluşturun. Veriler Docker volume'larında durur ve korunur.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dUptime Kuma'nın yedeğini almak
Panelde tüm sunucunun günlük yedeklerini (paket fiyatının %20'si, son 7 kopya saklanır) açabilir ve sunucuyu bunlardan herhangi birinden geri yükleyebilirsiniz. Uygulamanın kendi verilerinin bir dosyadaki kopyası yine de değerlidir: başka bir sunucuya taşınabilir ya da geri kalan her şeyi geri almadan geri yüklenebilir.
İzleyiciler, bildirim ayarları ve kontrol geçmişi uptime-kuma_uptime_kuma volume'undadır (/app/data). Veritabanı dosyası tutarlı bir durumda kopyalansın diye uygulamayı bir anlığına durdurun:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startNasıl çalışır
- Sunucu sipariş sayfasında Uptime Kuma uygulamasını seçin ve yeterli belleğe sahip bir paket belirleyin.
- Uygulama, sunucu ilk açıldığında, genellikle birkaç dakika içinde kurulur.
- Panelinizde sunucuyu açın: adres ve giriş bilgileri orada.