Panduan Lengkap Install Hermes Agent di Ubuntu untuk Monitoring Server via Bot Telegram Grup

Jadi gini, Jumat sore kemarin aku lagi santai. Kopi udah nyruput, laptop nyala, terus iseng buka htop di salah satu server yang aku pegang. Bukan cek yang serius-serius, cuma kebiasaan biar tangan gatel. Eh, terus kepikiran. Kok aku masih manual kayak gini ya? Login SSH ke server satu-satu, lihat load, tutup lagi, pindah ke server berikutnya. Capek juga kalau jumlah server-nya udah mulai banyak.

Padahal kebutuhan aku waktu itu sebenarnya sederhana: pengen tau kondisi server tanpa harus SSH-an terus-terusan. Kalau client nanya “mas, servernya sehat?”, aku pengen bisa jawab tanpa mikir lama. Nah, dari situ aku mulai nyari cara biar notifikasi kondisi server bisa masuk langsung ke grup Telegram. Dan setelah nyoba beberapa cara, ketemu lah yang namanya Hermes agent. Ringan, gak ribet, dan langkah install Hermes agent di Ubuntu itu jelas banget.

Masalahe, pemantauan manual itu ibarat jaga rumah tanpa CCTV. Rumah aman-aman aja selama kamu duduk di teras. Tapi pas kamu pergi belanja ke pasar, nah lho — siapa yang tau? Server juga gitu. Kalau kamu cuma andal buka htop pas lagi ada firasat, ada banyak jam kosong di mana server bisa ngambek diam-diam. Impact-nya ke client: komplain telat ketahuan, downtime lebih lama dari seharusnya, dan yang paling sakit — kepercayaan client ke kamu mulai luntur. Sithik-sithik nanya, “kok server-nya down terus, apa gak ada yang mantau?”

Terus, banyak yang mikir solusinya pasti beli tool monitoring mahal atau langganan SaaS berbayar yang tiap bulan kirim invoice. Padahal buat kebutuhan dasar kayak “RAM mau habis nih”, “disk udah 90%”, “service nginx mati” — itu sebenernya cukup banget pakai bot Telegram plus agen kecil yang numpang jalan di server. Telegram gratis, notifikasinya real-time, dan gak perlu buka dashboard web yang kadang malah lebih ribet dari masalahnya sendiri. Ini penting banget buat NOC engineer yang pegang banyak server sekaligus.

Nah, bagian yang sering bikin orang kapok itu di tengah jalan. Muter-muter nyari referensi, tapi gagal terus karena ketuker-tuker antara token bot, chat_id, dan cara bikin bot-nya jadi anggota grup. Padahal konsepnya simpel: bot itu jembatan, token itu kuncinya, chat_id itu alamat tujuannya. Kalau tiga-tiganya bener, pesan monitor langsung mlebu ke grup kamu. Nah, di artikel ini aku tulis lengkap dari nol biar kamu gak usah pusing kayak aku dulu. Santai aja, pelan-pelan ikutin step-nya, dijamin jalan.

Apa Itu Hermes Agent dan Kenapa Pakai Telegram?

Sebelum nyemplung ke langkah install, aku jelasin sithik dulu apa yang sebenernya kita pasang. Hermes agent itu agen monitoring ringan yang jalan di server. Tugasnya cuma satu: ngumpulin metric sistem — CPU, RAM, disk, uptime, status service — terus kirim ke grup Telegram via bot. Dia jalan terus di background sebagai service systemd, jadi gak perlu interaksi manual sama sekali setelah terpasang.

Kenapa Telegram? Karena gak ada layer yang lebih simpel dari ini. Gak perlu install app tambahan di server, gak perlu buka port ke server, gak perlu maintain dashboard. Yang kamu butuhin cuma: server yang bisa akses internet keluar ke api.telegram.org, sama HP yang udah ada Telegram-nya. Itu aja.

Step 1 — Siapkan Bot Telegram Pakai BotFather

Hal pertama yang perlu disiapkan adalah bot-nya. Buka Telegram, cari akun @BotFather. Ini akun resmi dari Telegram buat ngelola bot. Ketik perintah /newbot, terus ikutin dua pertanyaan: nama bot (nama tampilan, bebas) dan username bot (wajib diakhiri ‘bot’, contoh: server_guard_bot).

Setelah selesai, BotFather bakal ngasih HTTP API token yang bentuknya kurang lebih kayak gini:

7234567891:AAHd8...token-ini-rahasia-yah...

Token ini ibarat password. Simpen baik-baik, jangan pernah di-share, apalagi dicantumin di postingan publik. Kalau bocor, orang bisa ngirim pesan pakai bot kamu atau baca percakapan yang masuk ke bot. Kalau terpaksa, tinggal minta /revoke ke BotFather dan dapet token baru. Gampang kok, cuma jangan sampe kejadian.

Step 2 — Bikin Grup dan Catat chat_id

Sekarang bikin grup Telegram baru. Namain terserah, misal “Server Monitoring”. Terus tambahin bot kamu ke grup itu. Penting: bot harus jadi member grup, bukan cuma dikasi akses chat terbatas. Biar gampang, kirim aja satu pesan tes di grup, misal ketik kata “test”. Kenapa? Biar Telegram nyatet aktivitas grup itu, dan kita bisa ngambil chat_id-nya.

Buat dapet chat_id, kita pakai API getUpdates. Buka terminal di laptop atau server mana aja yang ada curl, terus jalanin:

curl -s "https://api.telegram.org/bot<TOKEN>/getUpdates"

Ganti <TOKEN> dengan token dari BotFather tadi. Hasilnya JSON. Cari bagian yang ada “chat”: { “id”: -100xxxxxxxxx }. Angka dengan tanda minus itu chat_id grup kamu. Pesan yang masuk dari grup selalu punya id negatif, jadi jangan kaget kalau lihat minus. Catet angka itu, bakal dipakai di langkah berikutnya.

Step 3 — Siapin Server Ubuntu

Oke, sekarang balik ke server. Login dulu via SSH. Pastikan mulai dari state yang bersih biar gak bentrok sama paket lama:

sudo apt update
sudo apt upgrade -y
sudo apt install -y git python3 python3-venv python3-pip

Hermes agent ini jalan di atas Python, makanya butuh python3 lengkap plus venv. Pakai venv itu kebiasaan bagus biar dependency-nya rapi dan gak berantakan sama python bawaan sistem. Sambil jalan, kalau kamu belum familiar sama SSH, ini juga saat yang pas buat baca panduan SSH key untuk VPS biar login-nya lebih aman daripada password biasa.

Step 4 — Download dan Install Hermes Agent

Sekarang download kode agent-nya. Taruh di /opt biar ngikutin kebiasaan: aplikasi yang diinstall manual ditaruh di situ. Perintahnya:

cd /opt
sudo git clone <alamat-repo-hermes> /opt/hermes-agent
cd /opt/hermes-agent
sudo python3 -m venv venv
sudo ./venv/bin/pip install -r requirements.txt

Ganti <alamat-repo-hermes> dengan alamat repository Hermes agent yang kamu pakai. Kenapa aku saranin install ke /opt dan bikin venv sendiri? Biar rapi. Kalau nanti mau hapus, tinggal rm -rf dua direktori itu, selesai. Gak ada sisa dependency yang nyangkut di sistem. Nek kamu belum terbiasa sama virtual environment, tenang, gak perlu paham dalem-dalem. Yang penting semua dependency kepasang di dalam folder /opt/hermes-agent/venv, jadi gak nyentuh environment sistem.

Step 5 — Konfigurasi Agent

Ini bagian paling krusial. File config-nya biasanya ditaruh di /etc/hermes/. Bikin folder dan file-nya:

sudo mkdir -p /etc/hermes
sudo nano /etc/hermes/hermes.conf

Isi kira-kira kayak gini:

[telegram]
token = "7234567891:AAHd8...token-mu..."
chat_id = "-1001234567890"

[monitor]
hostname_alias = "server-prod-01"
interval = 60
cpu_threshold = 85
ram_threshold = 85
disk_threshold = 90

[services]
watch = nginx, mysql, docker

[alert]
timezone = "Asia/Jakarta"
cooldown = 300

Nah, perhatiin beberapa hal penting di sini:

• token: isi dengan token bot kamu.
• chat_id: isi dengan angka negatif yang tadi kita dapet dari getUpdates.
• hostname_alias: nama tampilan server di notifikasi. Kalau kamu monitor beberapa server, ini yang bikin pesan-pesannya gak ketuker.
• interval: jarak pengecekan dalam detik. 60 artinya cek tiap menit.
• cpu_threshold, ram_threshold, disk_threshold: ambang batas dalam persen. Kalau lewat dari angka ini, baru notifikasi dikirim. Ini biar bot gak spam kamu tiap detik.
• watch: daftar service yang dipantau statusnya, pisah pakai koma.
• cooldown: jeda minimal antar notifikasi, biar kalau disk lagi 95% terus, bot gak ngejek kamu tiap menit.

Sesudah diisi, kunci file-nya biar gak kebaca user lain:

sudo chmod 600 /etc/hermes/hermes.conf

Dan buat ngelindungin file config ini, jangan lupa biar server-nya sendiri juga aman — salah satu hal yang paling sering bikin masalah itu resource leak yang bikin high load. Kalau suatu saat server kamu mulai lelet dan bingung mau mulai dari mana, baca dulu panduan troubleshoot high load VPS.

Step 6 — Jalankan sebagai Systemd Service

Biar agent-nya jalan terus di background dan ikut start pas server reboot, kita daftarin jadi service systemd. Bikin unit file:

sudo nano /etc/systemd/system/hermes-agent.service

Isi kurang lebih kayak gini:

[Unit]
Description=Hermes Monitoring Agent
After=network-online.target
Wants=network-online.target

[Service]
User=hermes
WorkingDirectory=/opt/hermes-agent
ExecStart=/opt/hermes-agent/venv/bin/python hermes.py --config /etc/hermes/hermes.conf
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Sekarang siapin user khusus biar agent-nya gak jalan sebagai root. Ini best practice yang sering dilupain orang:

sudo useradd -r -s /usr/sbin/nologin hermes
sudo chown -R hermes:hermes /opt/hermes-agent /etc/hermes
sudo systemctl daemon-reload
sudo systemctl enable --now hermes-agent
sudo systemctl status hermes-agent

Kalau statusnya active (running), berarti agent udah jalan. Kalau masih belum paham systemd, ada panduan dasar systemd service di situs ini yang bisa kamu baca santai-santai.

Step 7 — Test Notifikasi ke Grup

Nah, ini bagian yang paling seru. Setelah service jalan, tunggu beberapa detik, buka grup Telegram kamu. Seharusnya ada pesan masuk dari bot — biasanya berisi ringkasan status server kayak CPU, RAM, disk, uptime, dan status service yang di-watch.

Kalau gak ada, cek log dulu:

journalctl -u hermes-agent -f

Kalau muncul error kayak “Failed to send message” atau “401 Unauthorized”, artinya ada yang salah di config. Tenang, di bawah ada tabel troubleshooting-nya. Contoh pesan yang bakal kamu lihat di grup kurang lebih kayak gini:

[server-prod-01] Status Server
CPU : 12% | RAM : 48% (1.9GB/4GB)
Disk / : 63% (45GB/72GB)
Uptime : 14 hari 6 jam
Service: nginx OK, mysql OK, docker OK

Tabel Troubleshooting — Wajib Disimpen

Gejala	Penyebab	Solusi
Pesan gak masuk ke grup	chat_id salah atau bot belum jadi member grup	Ulangi getUpdates, pastikan id-nya negatif, tambahkan bot ke grup
401 Unauthorized	Token salah atau sudah di-revoke	Cek ulang token dari BotFather, /revoke kalau perlu
403 Forbidden	Bot di-block, atau grup private gak bisa diakses bot	Pastikan bot member grup, cek pengaturan privacy mode bot
Metric gak muncul di pesan	Service jalan tapi user-nya gak punya permission baca	Cek journalctl, pastikan chown hermes:hermes sudah dijalankan
Bot spam terus-terusan	Threshold kekecilan atau cooldown gak di-set	Naikin threshold, set cooldown minimal 300 detik
Service restart terus	Config error, misal token kebawa spasi	journalctl -u hermes-agent -e, periksa config, hapus spasi ekstra

Tips Keamanan Sebelum Dipakai di Production

• Jangan pernah commit file config ke git. Token di dalamnya itu kredensial sungguhan.
• chmod 600 file config-nya, dan jangan kasih akses ke user lain.
• Jalankan agent sebagai user khusus (hermes), bukan root.
• Jangan tambahkan bot ke grup yang isinya orang asing atau grup publik. Ini kan notifikasi internal server, bukan konten buat konsumsi umum.
• Kalau agent-mu mendukung command dari bot (misal perintah eksekusi), matikan aja kalau gak perlu. Lebih aman.
• Pastikan server bisa keluar ke api.telegram.org via HTTPS (port 443). Kalau ada firewall, whitelist dulu.
• Rutin update dan patch server kamu. Agent monitoring itu cuma mata dan telinga, bukan pengganti maintenance. Kombinasiin sama panduan update dan patch Ubuntu server biar lengkap.

Catatan Buat Yang Monitor Banyak Server

Salah satu hal yang aku suka dari pendekatan ini: satu grup bisa jadi dashboard buat semua server. Tinggal install agent yang sama di tiap server, set chat_id yang sama, dan bedain hostname_alias di masing-masing config. Jadi pas ada server A yang ngambek, notifikasi-nya udah jelas nyebut siapa yang bermasalah.

Oh iya, kalau kamu pengen lengkapin monitoring ini dengan visualisasi dashboard yang lebih lengkap, kombinasiin aja sama monitoring VPS pakai Netdata. Hermes buat notifikasi kilat, Netdata buat grafik mendalam. Cocok banget, piye nek?

FAQ — Pertanyaan yang Sering Muncul

Oke, cukup semene dulu artikelnya. Kalau kamu udah nyoba dan nemu error yang gak ada di tabel troubleshooting di atas, langsung drop di komentar ya. Sopo ngerti, bisa bantu temen-temen yang lain. Matur nuwun udah mampir, semoga server-server kalian adem ayem terus. Santai aja, monitoring mah gitu-gitu aja kok.