Uptime Kuma

Meskipun ada banyak solusi pemantauan ketersediaan layanan yang sudah ada, seringkali sulit menemukan yang memenuhi kebutuhan dasar Anda sekaligus bekerja dengan sederhana tanpa kustomisasi kompleks. Dengan menggunakan berbagai pendekatan untuk ketersediaan kontinu, kami merekomendasikan solusi sederhana yang cocok untuk semua pemilik instance On‑premise, baik yang diterapkan secara lokal di dalam organisasi maupun di layanan cloud.

Solusi ringkas yang kami rekomendasikan memenuhi kebutuhan berikut:

• Diterapkan secara lokal di server (oleh karena itu cocok untuk infrastruktur terklasifikasi)

• Mudah diinstal

• Memiliki antarmuka pengguna yang ramah dan tidak dibebani dengan terlalu banyak opsi

• Mampu memantau berbagai metrik (bukan hanya melakukan ping ke sebuah alamat)

• Mendukung berbagai opsi notifikasi (email, sms, messenger dan lainnya)

Solusi ini bernama Uptime Kuma dan tersedia di GitHub penulis:

https://github.com/louislam/uptime-kuma

Solusi ini dirancang untuk pemantauan eksternal ketersediaan layanan, yang biasanya sudah memadai. Ini tidak cocok untuk memantau metrik internal apa pun, seperti status layanan sistem, beban CPU, konsumsi memori, dll.

Instalasi

Instalasi dijelaskan secara rinci pada halaman produk di GitHub, jadi kami tidak akan memfokuskan pada detailnya. Perlu dicatat bahwa yang paling mudah adalah menerapkan container docker, yang dilakukan secara harfiah dengan satu perintah.

Bagaimana cara menginstal Docker?

Ada banyak petunjuk tentang cara menginstal Docker di berbagai platform. Cara yang paling sederhana adalah menggunakan Linux terbaru dan melakukan instalasi menggunakan perintah‑perintah ini:

curl -fsSL https://get.docker.com -o install-docker.sh
sh ./install-docker.sh

Jika Anda menggunakan platform lain (Mac, Windows) atau ingin menginstal Docker Desktop, silakan merujuk ke bagian yang sesuai dalam dokumentasi Docker:

https://docs.docker.com/manuals/

Ada juga metode instalasi alternatif tanpa menggunakan Docker, yang juga relatif mudah dan tersedia untuk Linux dan Windows. Pilihan metode instalasi diserahkan kepada Anda.

Penting untuk memastikan bahwa Anda memiliki port khusus tersedia di server untuk Uptime Kuma - defaultnya adalah 3001.

Setelah melakukan instalasi, antarmuka web Uptime Kuma akan dapat diakses melalui alamat server (domain atau alamat IP) dan port serta langsung siap digunakan. Anda perlu mengatur kredensial administrator dan melanjutkan ke konfigurasi metrik.

Metrik

Metrik terpenting dari perspektif bisnis adalah ketersediaan situs web, akses pelanggan ke data, dan pencatatan data baru dari perangkat pelacak. Inilah yang akan kami pantau.

Untuk setiap metrik, Anda dapat menentukan interval heartbeat untuk menyesuaikan seberapa sering pemeriksaan akan dijalankan (default adalah 60 detik), menyesuaikan jumlah percobaan ulang (sebelum menganggap server down), dan mengatur parameter lainnya.

Ketersediaan situs web

Untuk memulai, buat monitor pertama yang akan melacak ketersediaan domain berdasarkan permintaan HTTPS. Pilih tipe monitor HTTP(s), berikan nama dan tentukan URL situs web Anda. Ini akan memeriksa ketersediaan situs web berdasarkan kode status respons HTTP. Kode yang dianggap adalah 200–299, jadi jika kode lain diterima (mis. 404 Not found atau 504 Gateway timeout) itu akan dianggap sebagai kegagalan dan monitor akan melaporkan bahwa layanan mengalami gangguan.

Bagian “Advanced” menawarkan opsi konfigurasi pemantauan yang diperluas, khususnya pemberitahuan kedaluwarsa sertifikat. Tandai opsi ini agar diberi tahu ketika sertifikat situs web Anda kedaluwarsa sehingga Anda dapat segera menerbitkannya kembali.

Simpan pengaturan monitor, dan monitor akan otomatis mulai melacak ketersediaan situs web.

Ketersediaan API

API adalah layanan inti yang dibutuhkan agar situs web dapat berinteraksi dengan backend platform; selain itu, banyak klien menggunakannya untuk mengambil data langsung dari platform. Oleh karena itu, operasi API yang stabil juga sangat penting. Pemantauan operasi layanan ini dapat dilakukan dengan satu permintaan API sederhana.

Permintaan terlihat seperti ini:

https://my.domain.com/api/base/ping/

Dan respons dari layanan yang berfungsi normal akan berupa JSON berikut:

{"success": true}

Anda dapat mengonfigurasi monitor untuk bekerja dengan respons ini. Untuk melakukan ini, buat monitor lain dengan tipe HTTP(s), tentukan permintaan API di URL, lalu sesuaikan opsi HTTP:

• Method: GET

• Body encoding: JSON

• Body: {"success": true}

Simpan pengaturan monitor, dan monitor akan otomatis mulai memeriksa ketersediaan API dengan mengirimkan permintaan yang ditentukan dan mengurai responsnya.

Ketersediaan TCP

Menerima data dari perangkat sangat penting bagi platform pelacakan. Oleh karena itu, penting untuk menjaga akses perangkat dan memantau aktivitas server TCP. Karena layanan pemantauan bersifat eksternal terhadap platform, Anda cukup memantau ketersediaan eksternal dari salah satu port yang digunakan perangkat pelacak untuk terhubung. Misalnya, itu bisa berupa port 47770 untuk aplikasi seluler X-GPS tracker, 47776 untuk Teltonika atau port lain apa pun untuk perangkat yang Anda gunakan.

Konfigurasikan monitor: pilih tipe monitor “TCP Port”, tentukan domain dasar Anda dan port yang Anda pilih.

Simpan pengaturan monitor, dan monitor akan mulai memeriksa ketersediaan port.

Notifikasi

Untuk setiap metrik, Anda memiliki opsi untuk mengatur notifikasi sehingga Uptime Kuma memberi tahu Anda ketika terjadi kejadian ketidaktersediaan. Dengan demikian Anda tidak hanya memiliki grafik ketersediaan layanan, tetapi juga menerima notifikasi mendesak jika salah satu layanan turun.

Anda dapat mengatur berbagai jenis notifikasi, tetapi penting untuk dicatat bahwa Uptime Kuma sendiri bukan gateway notifikasi. Untuk mengatur jenis notifikasi apa pun, Anda memerlukan kredensial gateway eksternal yang sesuai (mis. SMTP, Twilio, Discord, dll.).

Setelah Anda menentukan pengaturan gateway notifikasi, Anda akan diberi tahu tentang masalah layanan melalui saluran pilihan Anda.