Skip to content
alfathmallorcaPublic

About

Dashboard monitoring jaringan berbasis web untuk NOC: status Up/Down, latensi, trafik SNMP, dan notifikasi Telegram. Mendukung perangkat fisik dan lab GNS3. Coming soon: 18–19 November 2026.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

NetPulse — Hybrid NOC Dashboard

Status Release Candidate Laravel PHP Python Database License: MIT

Setiap perangkat. Setiap koneksi. Semua dalam pantauan.

NetPulse adalah aplikasi monitoring jaringan berbasis web untuk membantu NOC Technician dan Network Engineer memantau perangkat fisik maupun perangkat virtual di lab GNS3.

NetPulse menggabungkan pengukuran ICMP, statistik interface SNMP, pemeriksaan layanan, peta topologi, dan notifikasi Telegram dalam antarmuka dark yang responsif.

Status dan rencana rilis

Target rilis awal: Rabu–Kamis, 18–19 November 2026.

Per 17 November 2026, NetPulse berada pada tahap kandidat rilis 1.0.0-rc.1. Fitur utama telah diimplementasikan dan diuji pada lingkungan pengembangan lokal; peninjauan dokumentasi, materi pratinjau, dan validasi akhir masih berlangsung sebelum publikasi.

Repository ini menjadi tempat pengumuman dan dokumentasi persiapan rilis. Kode sumber, paket instalasi, serta catatan rilis akan dipublikasikan saat peluncuran. Jadwal di atas merupakan target dan dapat disesuaikan berdasarkan hasil pengujian akhir.

⭐ Star repository ini untuk mengikuti perkembangan NetPulse.

Pembaruan menjelang rilis

  • Monitoring Jaringan menjadi satu halaman utama untuk memantau topologi, insiden, grafik, dan kesehatan sistem.
  • Dashboard berfokus pada ringkasan inventaris, lokasi, serta pintasan ke fitur pengelolaan.
  • Live telemetry telah digabung ke Monitoring Jaringan; nama Mode NOC/TV tidak lagi digunakan pada menu.
  • Sidebar tetap tersedia saat monitoring. Tampilan tanpa sidebar dapat diaktifkan melalui tombol Layar penuh.
  • Satu jam analog bergerak ditempatkan secara ringkas di bagian atas monitoring, lengkap dengan hari, tanggal, waktu, dan pilihan zona waktu.
  • Penanganan data basi, gangguan jalur collector, dan ketidaktersediaan data trafik diperjelas agar kondisi monitoring lebih mudah dipahami.

Fitur utama

Area Kemampuan
Ketersediaan perangkat ICMP Up/Down, latensi, packet loss, konfirmasi gangguan, dan penanda data basi atau belum tersedia.
Trafik interface Grafik Rx/Tx dari selisih counter SNMP, interval pengukuran aktual, satuan otomatis, serta histori 1/6/24 jam.
Interface health Status administratif dan operasional port, kapasitas, utilisasi, error/discard, filter, pagination, dan jumlah hasil.
Topologi jaringan Peta status, koneksi antarport, dependency upstream, label trafik, zoom/pan, serta editor posisi perangkat.
Identitas perangkat Pemetaan beberapa IP monitoring pada satu perangkat fisik agar tidak selalu muncul sebagai node terpisah.
Discovery tetangga Kandidat koneksi LLDP/CDP untuk ditinjau dan dikonfirmasi, sesuai dukungan MIB perangkat.
Monitoring layanan Pemeriksaan TCP, HTTP/HTTPS, dan DNS dengan histori hasil pemeriksaan.
Manajemen insiden Prioritas Critical/Warning, acknowledgment, catatan penanganan, riwayat gangguan, dan pemulihan.
Notifikasi Telegram Pesan gangguan dan pemulihan, antrean pengiriman, percobaan ulang, serta pengingat opsional.
Maintenance dan dependency Jendela pemeliharaan, hubungan upstream, dan korelasi gangguan jalur untuk membantu mengurangi alarm yang menyesatkan.
Detail perangkat Grafik, interface, ketersediaan, dan timeline troubleshooting pada perangkat yang dipilih.
Collector dan watchdog Heartbeat, diagnosis gangguan jalur, pemantauan kesehatan server, dan konfigurasi operasi otomatis.
Remote collector Penugasan perangkat ke node collector, autentikasi token, buffer SQLite, serta pengiriman ulang dengan ACK dan idempotency.
Laporan dan histori Laporan ketersediaan/insiden, ekspor CSV, backup database, serta retensi histori.
Akses tim Akun Admin, Operator, dan Viewer, password hash, pencabutan sesi, serta audit aktivitas sesuai hak akses.

Susunan halaman

Halaman Fungsi
Dashboard Ringkasan inventaris IP fisik/virtual, lokasi, dan akses ke ruang kerja.
Monitoring Jaringan Topologi baca, insiden prioritas, grafik latensi/trafik/packet loss, jam jaringan, dan kesehatan monitoring.
Perangkat Pendaftaran, pengelolaan metadata, pengaturan pemantauan, serta detail dan timeline perangkat.
Insiden Penelusuran gangguan, acknowledgment, dan catatan penanganan.
Interface health Pemeriksaan kondisi port dan statistik interface.
Topologi Pengeditan layout, identitas node, pemetaan koneksi port, dan discovery tetangga.
Layanan Pengelolaan pemeriksaan TCP, HTTP/HTTPS, dan DNS.
Laporan Peninjauan histori ketersediaan dan insiden serta ekspor CSV.
Collector Pengelolaan dan penugasan remote collector, tersedia sesuai hak akses.
Pengaturan, Akun tim, Audit log Konfigurasi operasional, akses pengguna, dan penelusuran aktivitas sesuai peran.

Pengunjung yang belum login diarahkan ke halaman login. Setelah masuk, pengguna membuka Dashboard dan dapat berpindah ke Monitoring Jaringan melalui sidebar. Pengeditan topologi tetap dilakukan pada halaman Topologi.

Arsitektur sistem

flowchart LR
    Physical["Perangkat fisik"] <--> |"ICMP / SNMP"| Collector["Python collector lokal"]
    Virtual["Perangkat virtual GNS3"] <--> |"ICMP / SNMP"| Collector
    Services["Layanan TCP / HTTP / DNS"] <--> Collector
    Collector --> |"Hasil polling"| Database[("MySQL / MariaDB")]
    Database --> Web["Laravel 12 + API"]
    Web --> UI["Dashboard dan Monitoring Jaringan"]
    Database --> Outbox["Antrean notifikasi"]
    Outbox --> |"Diproses collector"| Telegram["Telegram Bot"]
    Remote["Remote collector + buffer SQLite"] -.-> |"API terautentikasi"| Web
    Watchdog["Watchdog independen"] -.-> |"Periksa health endpoint"| Web
Loading

Collector melakukan polling dengan interval bawaan sekitar 60 detik, sedangkan antarmuka melakukan auto-refresh setiap 15 detik. Refresh halaman tidak berarti perangkat dipolling ulang setiap 15 detik.

Operasi lokal otomatis disiapkan melalui service collector/watchdog dan Apache untuk web. Penjadwalan backup serta retensi dijalankan terpisah. Paket remote collector dan template deployment mesin lain juga telah disiapkan.

Cara membaca data monitoring

  • Up/Down ICMP menunjukkan keterjangkauan dari titik collector. Keberhasilan ping tidak otomatis berarti SNMP atau seluruh layanan sehat.
  • Trafik Rx/Tx merupakan rata-rata bit per detik dari selisih counter dan waktu aktual antarsampel, dilihat dari sisi interface perangkat. Nilainya dapat berbeda dari pembacaan sesaat di WinBox.
  • Baseline pertama belum menghasilkan rate trafik. Diperlukan dua sampel SNMP yang valid sebelum trafik dapat dihitung.
  • Data tidak tersedia ditampilkan sebagai gap atau penjelasan status, bukan dipaksakan menjadi nol. Pergantian baseline, reset counter, dan interval tidak valid diperhitungkan.
  • Data basi atau jalur bermasalah dibedakan dari bukti perangkat Down. Mesin collector tetap memerlukan konektivitas menuju perangkat.
  • Monitoring berkelanjutan memerlukan mesin yang tetap menyala, tidak sleep, dan mempunyai jalur management. Watchdog pada PC yang sama tidak dapat melaporkan ketika seluruh PC tersebut mati; gunakan mesin terpisah untuk kebutuhan itu.

Teknologi dan persyaratan

Komponen Teknologi / kebutuhan
Backend web PHP 8.2+, Laravel 12, Composer 2
Antarmuka Blade, Tailwind CSS 4, tema dark
Grafik Chart.js 4
Collector Python 3.11+, ping3, PySNMP, MySQL Connector, dnspython
Database MySQL 8 atau MariaDB yang kompatibel; validasi lokal menggunakan MariaDB 10.11
Web server Apache 2.4; instalasi lokal menggunakan XAMPP
Build frontend Node.js 22.12+ dan npm; aset hasil build disertakan pada paket source
Platform yang diuji Windows pada PC pengembangan; template Linux disiapkan untuk penyesuaian dan validasi lanjutan
Notifikasi Telegram Bot API, token dan chat ID di konfigurasi lokal
Virtual lab GNS3, opsional

Perangkat fisik maupun virtual harus dapat dijangkau dari collector. Monitoring SNMP memerlukan SNMP v2c read-only, akses UDP 161, dan dukungan MIB yang sesuai. Fitur khusus vendor, seperti level optik ONU/ONT, tidak termasuk jaminan statistik interface standar.

Validasi dan batas pengujian

Validasi yang telah dilakukan selama pengembangan mencakup:

  • Pengujian otomatis backend Laravel dan collector Python, serta perhitungan/pemformatan metrik JavaScript.
  • Pemeriksaan browser desktop/mobile: login, navigasi, grafik, jam analog, zona waktu, dan layar penuh.
  • Integrasi ICMP/SNMP, database, pemeriksaan layanan, alarm/pemulihan, buffer remote collector, serta backup/restore pada lingkungan pengujian.
  • Pemeriksaan paket source: checksum SHA-256, manifest berkas, kelengkapan aset, dan pengecualian rahasia konfigurasi.

Uji kapasitas lokal dilakukan dengan 10, 50, dan 100 perangkat simulasi, masing-masing delapan interface dan satu layanan TCP. Putaran terburuk pada profil 50 perangkat sekitar 40,26 detik, sedangkan profil 100 perangkat mencapai 71,60 detik, melewati target interval 60 detik.

Hasil tersebut berasal dari tiga putaran pada simulator loopback di PC pengembangan. Ini bukan jaminan kapasitas pada jaringan WAN, bukan hasil uji ketahanan 24 jam, dan bukan klaim aplikasi bebas bug. Kapasitas perlu diukur ulang sesuai perangkat, jumlah port, timeout, dan lingkungan deployment.

Dokumentasi dan instalasi

Dokumentasi berikut telah disiapkan secara lokal dan akan dipublikasikan bersama kode sumber serta paket rilis:

Berkas Isi
INSTALL.md Instalasi baru, dependensi, setup database, serta pemeriksaan awal.
OPERATIONS.md Penggunaan fitur, alarm, pengukuran, Telegram, topologi, dan troubleshooting.
DEPLOYMENT.md Collector lokal/remote, watchdog, dan penempatan pada mesin lain.
PRODUCTION.md Web server, akses LAN, dan konfigurasi HTTPS.
UPGRADE.md Upgrade, backup konfigurasi, dan rollback.
CAPACITY-REPORT.md Metode, hasil, serta batas uji kapasitas.
SECURITY.md Pengaturan keamanan dan penanganan informasi sensitif.
CHANGELOG.md Catatan perubahan kandidat rilis.

Petunjuk instalasi lengkap dan screenshot antarmuka akan ditambahkan pada publikasi rilis. Konfigurasi lokal seperti .env, token Telegram, community SNMP, password, serta database operasional tidak disertakan dalam repository atau paket publik.

Rencana rilis awal

  • Collector ICMP/SNMP dan pemeriksaan layanan.
  • Halaman Monitoring Jaringan serta pengelolaan perangkat.
  • Topologi, koneksi port, dan pemetaan beberapa IP pada satu perangkat.
  • Insiden, Telegram, maintenance, dan dependency.
  • Akses tim, audit, laporan, dan timeline troubleshooting.
  • Collector/watchdog otomatis, remote collector, backup, dan retensi.
  • Penyusunan panduan instalasi, deployment, upgrade, dan kandidat paket rilis lokal.
  • Pengujian kapasitas awal dan pencatatan batas hasilnya.
  • Penambahan screenshot antarmuka ke repository.
  • Peninjauan akhir dokumentasi serta validasi kandidat rilis.
  • Publikasi kode sumber dan rilis awal, ditargetkan 18–19 November 2026.

Lisensi

Proyek ini menggunakan MIT License.

Copyright (c) 2026 Alfath Mallorca.

Pengembang

Dikembangkan oleh Alfath Mallorca — @alfathmallorca.

NetPulse menggabungkan praktik network monitoring, otomasi Python, dan pengembangan aplikasi web untuk kebutuhan operasional serta pembelajaran jaringan.


NetPulse — Setiap perangkat. Setiap koneksi. Semua dalam pantauan.

About

Dashboard monitoring jaringan berbasis web untuk NOC: status Up/Down, latensi, trafik SNMP, dan notifikasi Telegram. Mendukung perangkat fisik dan lab GNS3. Coming soon: 18–19 November 2026.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors