Günümüzde web siteleri ve servislerinin kesintisiz çalışması işletmeler için kritik öneme sahiptir. Uptime Kuma, bu servislerin durumunu izlemek için kullanılan modern, açık kaynaklı ve kullanıcı dostu bir izleme aracıdır. Bu makalede Uptime Kuma’nın ne olduğunu, özelliklerini ve nasıl kurulacağını detaylı olarak inceleyeceğiz.
Uptime Kuma Nedir?
Uptime Kuma, web siteleri, API’ler, sunucular ve diğer internet servislerinin çalışma durumunu sürekli olarak izleyen bir monitörleme aracıdır. Temel özellikleri arasında:
– Web arayüzü üzerinden kolay yönetim
– Çoklu protokol desteği (HTTP(S), TCP, DNS, PING)
– Kapsamlı bildirim sistemi
– Detaylı uptime istatistikleri ve raporlama
– SSL sertifikası takibi
– Çoklu dil desteği
bulunmaktadır.
Sistem Gereksinimleri
Uptime Kuma’yı çalıştırmak için minimum gereksinimler:
– Node.js 14 veya üzeri
– 1 CPU çekirdek
– 512MB RAM
– 1GB disk alanı
Kurulum Yöntemleri
Docker Kurulum — kontrol
- Önce eski sürümleri kaldıralım (eğer varsa):
sudo apt-get remove docker docker-engine docker.io containerd runc
2. Gerekli paketleri yükleyelim:
sudo apt-get update
sudo apt-get install \
ca-certificates \
curl \
gnupg \
lsb-release
3. Docker’ın resmi GPG anahtarını ekleyelim:
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg – dearmor -o /etc/apt/keyrings/docker.gpg
4. Docker repository’sini ekleyelim:
echo \
“deb [arch=$(dpkg – print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
5. Docker Engine’i yükleyelim:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
6. Docker’ın doğru yüklendiğini test edelim:
sudo docker run hello-world
7. Docker’ı sudo olmadan kullanabilmek için kullanıcınızı docker grubuna ekleyelim:
sudo usermod -aG docker $USER
8. Değişikliklerin etkili olması için oturumu yeniden başlatın veya şu komutu çalıştırın:
newgrp docker
Eğer WSL (Windows Subsystem for Linux) kullanıyorsanız, Docker Desktop’ı Windows’a yüklemeniz ve WSL2 entegrasyonunu etkinleştirmeniz gerekebilir. Bu durumda farklı adımlar izlememiz gerekecektir. Hangi sistemi kullandığınızı belirtirseniz, ona göre daha spesifik yönlendirme yapabilirim.
- Docker’ın yüklü olduğundan emin olun:
docker –version
2. Docker servisinin çalıştığından emin olun:
sudo systemctl status docker
3. Kullanıcınızın docker grubunda olduğundan emin olun:
sudo usermod -aG docker $USER
(Bu komutu çalıştırdıktan sonra oturumu yeniden başlatmanız gerekebilir)
- Docker ile Kurulum (Önerilen)
Docker kullanarak kurulum en kolay ve önerilen yöntemdir:
# Container’ı çekme ve çalıştırma
docker run -d –restart=always -p 3001:3001 -v uptime-kuma:/app/data –name uptime-kuma louislam/uptime-kuma:1# Log’ları kontrol etme
docker run -d –restart=always -p 3001:3001 -v ~/uptime-kuma-data:/app/data –name uptime-kuma louislam/uptime-kuma:1 # kumayı çalıştıralım
Artık yeni servis ekleyeceğim, dashbordımız geldi. örnek olarak ggole.com ekledim ve sertifika statusunda gerekli bilgileri görebiliyiorum, dilersem Atanmış bildirim ekleyerek, bildirimlerimi ayarlayabilirim.
2. Node.js ile Manual Kurulum
# Git repository’sini klonlama
git clone https://github.com/louislam/uptime-kuma.git
cd uptime-kuma
# Bağımlılıkları yükleme
npm install
# Uygulamayı derleme
npm run build
# Uygulamayı başlatma
npm run start
İlk Yapılandırma
1. Kurulum tamamlandıktan sonra `http://sunucu-ip:3001` adresine gidin
2. İlk açılışta bir yönetici hesabı oluşturmanız istenecektir
3. Giriş yaptıktan sonra monitör eklemeye başlayabilirsiniz
Monitör Ekleme
1. Ana panelde “Add New Monitor” butonuna tıklayın
2. Monitör tipini seçin (HTTP(S), TCP, DNS vs.)
3. İzlenecek servisin URL veya IP adresini girin
4. Kontrol aralığını belirleyin (örn: 1 dakika)
5. İsterseniz bildirim ayarlarını yapılandırın
6. Kaydedin
Bildirim Yapılandırması
Uptime Kuma aşağıdaki bildirim kanallarını destekler:
– E-posta
– Telegram
– Discord
– Slack
– Microsoft Teams
– Webhook
– SMS (Twilio üzerinden)
Her monitör için farklı bildirim kanalları ve kuralları tanımlayabilirsiniz.
İleri Seviye Özellikler
SSL Sertifikası Takibi
HTTPS monitörleri için SSL sertifikası geçerlilik süresini takip edebilir ve sona erme tarihine yaklaşıldığında bildirim alabilirsiniz.
Status Page
Servislerinizin durumunu müşterilerinizle paylaşmak için public status page oluşturabilirsiniz.
Proxy Desteği
Monitörleri belirli bir proxy üzerinden çalıştırabilirsiniz.
En İyi Pratikler
1. **Kontrol Aralığı**: Çok sık kontrol gerektirmeyen servisler için 5 dakika veya daha uzun aralıklar kullanın
2. **Bildirimler**: Gereksiz bildirimlerden kaçınmak için uygun eşik değerleri belirleyin
3. **Yedekleme**: /app/data dizinini düzenli olarak yedekleyin
4. **Güvenlik**:
— Güçlü bir yönetici şifresi kullanın
— Mümkünse reverse proxy arkasında çalıştırın
— Erişimi güvenli ağlarla sınırlandırın
Sorun Giderme
Sık Karşılaşılan Sorunlar
1.Bağlantı Hataları
— Firewall ayarlarını kontrol edin
— DNS çözümlemesini test edin
— Proxy ayarlarını kontrol edin
2.Yanlış Alarmlar
— Timeout değerlerini artırın
— Yeniden deneme sayısını artırın
— Kontrol aralığını uzatın
3. Performans Sorunları
— Monitör sayısını ve kontrol sıklığını optimize edin
— Sistem kaynaklarını kontrol edin
— Log dosyalarını düzenli temizleyin
Sonuç
Uptime Kuma, modern ve kullanıcı dostu arayüzü, kolay kurulumu ve zengin özellikleriyle web servislerinin izlenmesi için mükemmel bir çözümdür. Açık kaynaklı olması ve aktif geliştirici topluluğu sayesinde sürekli gelişmekte ve yeni özellikler kazanmaktadır.
Kaynaklar
– [Resmi GitHub Repository](https://github.com/louislam/uptime-kuma)
– [Resmi Demo](https://demo.uptime.kuma.pet)
– [Docker Hub](https://hub.docker.com/r/louislam/uptime-kuma)
