Skip to content
VDS · Aplikasi dan bot

Monitoring Anda sendiri: Uptime Kuma

Cara menyiapkan pemeriksaan ketersediaan untuk situs dan layanan Anda dengan notifikasi di Telegram atau Discord dan mengaturnya agar hanya membangunkan Anda saat penting.

Diperbarui 23 Agustus 2026

Panel kontrol mesin Anda menampilkan grafik CPU, traffic, dan memori, tetapi tidak tahu apakah situs Anda merespons atau apakah basis data masih hidup. Untuk itu Anda memerlukan pengawas sendiri. Uptime Kuma adalah opsi paling sederhana: satu container, antarmuka web, puluhan metode notifikasi.

Instalasi

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"
docker compose up -d

Port sengaja diikat ke antarmuka lokal: panel pemantauan tidak boleh terekspos ke luar. Buka melalui web server dengan sertifikat dan kata sandi, atau melalui SSH tunnel:

ssh -L 3001:127.0.0.1:3001 root@<machine-address>

Lalu buka http://localhost:3001 di browser Anda; pengguna pertama menjadi administrator.

Apa yang perlu dipantau

Mulai dari yang kecil, atau Anda akan tenggelam dalam noise:

  • Pemeriksaan HTTP halaman utama setiap situs — kode respons dan waktu.
  • Pemeriksaan HTTP API penting dengan pemeriksaan kata kunci pada respons. Halaman bisa mengembalikan 200 tetapi tetap menampilkan error.
  • Port TCP basis data atau server game.
  • Kedaluwarsa sertifikat — Kuma akan memperingatkan Anda N hari sebelum kedaluwarsa.
  • Pemeriksaan push untuk tugas terjadwal: setelah eksekusi berhasil, skrip mengakses alamat unik, dan jika tidak, Anda mendapat peringatan. Cocok dipadukan dengan tugas terjadwal.

Interval 60 detik hampir selalu cukup. Percobaan ulang — 2-3, jika tidak satu paket jaringan yang hilang akan memicu alarm palsu.

Jangan menempatkan pemantauan situs di mesin yang sama tempat situs itu berada. Jika mesin mati, pengawas ikut mati, dan Anda tidak akan pernah tahu. Untuk situs eksternal, simpan Kuma di mesin terpisah, dan di mesin ini — hanya pemeriksaan layanan internal.

Notifikasi

Siapkan bot Telegram atau webhook Discord dan tambahkan di bagian notifikasi. Jangan gunakan kanal email: koneksi keluar mesin ke port 25, 465, dan 587 ditutup sampai dibuka atas permintaan, dan email dari Kuma tidak akan terkirim — lihat Mail server.

Kebiasaan yang berguna:

  • Kanal terpisah untuk "down" dan "sertifikat akan kedaluwarsa". Yang pertama perlu reaksi sekarang juga, yang kedua — dalam sepekan.
  • Notifikasi pemulihan diaktifkan. Tanpanya Anda tidak bisa tahu apakah gangguan sudah berakhir.
  • Pesan uji yang dikirim saat penyiapan. Separuh dari semua masalah adalah token yang salah, dan Anda baru mengetahuinya saat gangguan nyata.

Sumber daya dan pemeliharaan

Container ini muat dalam 150-250 MB memori dan berjalan nyaman di VDS-1. Basis data tumbuh seiring riwayat pemeriksaan: atur retensi ke 90-180 hari di pengaturan, jika tidak dalam setahun file akan tumbuh hingga gigabyte — lihat ruang disk.

Direktori ./data menyimpan seluruh status layanan. Sertakan dalam backup Anda: memulihkan tiga puluh pemeriksaan secara manual tidak menyenangkan.

Kesalahan umum

  • Memeriksa berdasarkan alamat IP alih-alih domain. Sertifikat dan virtual host tidak diperiksa, dan gangguan DNS tidak terdeteksi.
  • Ambang batas yang terlalu sensitif. Peringatan pada setiap kelebihan 2 detik membuat orang berhenti membaca notifikasi.
  • Panel terekspos ke luar tanpa kata sandi. Panel menampilkan seluruh infrastruktur Anda: alamat, port, nama layanan.