LAN agent nedir ve ne zaman kullanılır
Kısaca: LAN agent, müşterinin iç ağındaki herhangi bir bilgisayara kurduğunuz küçük bir programdır. İnternet üzerinden ePulz.io'ya bağlanır, kontrol etmesi gereken adreslerin listesini ister, bunları yerel olarak doğrular ve sonuçları geri gönderir. Sayesinde bulut izlemenin erişemediği cihazları bile izleyebilirsiniz (NAS, kameralar, dahili sunucular, yerel web uygulamaları).
LAN agent'a ne zaman ihtiyacınız olur
- NAS ve ev veya iş sunucularının izlenmesi - Synology, QNAP, ZFS depolamalı kendi makineniz
- Mağaza veya ofiste IP kameralar, erişim kontrol sistemleri, alarmlar
- Dahili web uygulamaları - güvenlik duvarı arkasında Grafana, Jira, GitLab, Bookstack
- Ağ altyapısı - router, switch'ler, erişim noktaları (AP), VPN gateway
- IoT cihazlar ve gateway'ler - Modbus ve MQTT gateway'leri ve benzerleri
- MSP senaryosu - birden fazla müşteri için tek tip bir dağıtımla izleme yönetimi
Nasıl çalışır
- Dashboard'da bir agent oluşturur ve bir token (benzersiz bir anahtar)
epulzio_…alırsınız - yalnızca bir kez gösterilir. - Kurulum komutunu müşteri ağındaki bir cihazda çalıştırırsınız (Raspberry Pi, mini PC, NAS, Docker'lı bir bilgisayar).
- Agent her 30 saniyede bir ePulz.io'dan yeni görevler ister ve yerel kontrolleri çalıştırır.
- Sonuçları HTTPS üzerinden geri gönderir - her tarayıcının kullandığı aynı güvenli bağlantı.
- Bir cihazın durumu değiştiğinde ePulz.io standart bildirimi tetikler (e-posta, Telegram, webhook).
Agent ne gönderir (ve neyi asla göndermez)
Agent tam olarak üç şey gönderir:
- Heartbeat - agent sürümü, hostname ve işletim sistemi adı
- Kendiniz yapılandırdığınız kontrollerin sonuçları - up/down durumu, ms cinsinden yanıt süresi ve varsa hata mesajı
- Başka hiçbir şey. Ağı asla taramaz, dosyaları okumaz, trafik veya cihaz verisi toplamaz. Dokunduğu her bir IP adresini dashboard'da siz tanımlarsınız.
- Sınırlı token: agent token'ı yalnızca kendi kontrol listesini indirmeye ve sonuçları göndermeye izin verir. Hesabınıza, faturalandırmaya veya diğer monitörlere erişimi yoktur ve dashboard'da istediğiniz zaman iptal edebilirsiniz (Revoke).
- Root yetkisi olmadan çalışır: hizmet, systemd sandbox (NoNewPrivileges, ProtectSystem=strict) ile ayrıcalıksız bir sistem kullanıcısı olarak çalışır. Root yalnızca kurulum sırasında gereklidir.
- Tamamen denetlenebilir: agent'ın tamamı tek bir Python dosyasıdır (~600 satır, yalnızca standart kütüphane) - çalıştırmadan önce her satırını okuyabilirsiniz.
Üç tür LAN kontrolü
| Tür | Hedef | Ne tespit eder |
|---|---|---|
| lan_ping | 192.168.1.10 | Cihaz ICMP'ye yanıt veriyor (basit bir ağ testi). En ucuz kontrol. |
| lan_tcp | 10.0.0.50:5432 | Belirli bir port açık. Cihaz çalışıyor olsa bile, hizmetin kendisi (veritabanı, SSH ve benzerleri) kapalı olabilir. |
| lan_http | http://nas.local | HTTP veya HTTPS uygulaması doğru yanıt veriyor (2xx/3xx kodları). NAS arayüzü veya dahili bir dashboard için uygundur. |
Bir agent çalışmayı durdurduğunda ne olur
ePulz.io her dakika agentlerin yaşam sinyali (heartbeat) gönderip göndermediğini kontrol eder. Bir agent 5 dakikadan fazla yanıt vermezse, hem e-posta hem de Telegram mesajı alırsınız: "LAN agent X çevrimdışı". Agent geri döndüğünde, tekrar çevrimiçi olduğuna dair bir onay alırsınız. Böylece, agent veri göndermeyi durdurduğu için her şeyin çalıştığına dair yanlış bir izlenime kapılmazsınız.
Başlayın
Bir sonraki adımda agent kurulumunu ve ilk LAN monitörünü oluşturmayı gösteriyoruz.