Waar deze handleiding over gaat
Een WatchZit-console controleert de apparaten die ze kan bereiken. De apparaten van een filiaal zijn vaak buiten bereik: ze zitten achter de NAT van de filiaalrouter, de VPN dekt ze niet of het beheernetwerk is bewust gesloten. Een externe collector lost dat op. Het is de gewone WatchZit-agent op één computer op de locatie, in de console als collector gemarkeerd. Hij krijgt de controles van de apparaten van zijn locatie, voert ze daar uit, detecteert het netwerk van de locatie en stuurt de resultaten terug over zijn eigen versleutelde verbinding. Valt de lijn naar de console weg, dan blijft hij meten, en een tweede collector kan het overnemen als de eerste uitvalt.
- Wat u nodig hebt
- De server voorbereiden op agents van buiten
- De agent op de locatie installeren
- Er een externe collector van maken
- De apparaten van de locatie toewijzen
- Het filiaalnetwerk detecteren
- Een kaart per locatie
- Meldingen als de filiaallijn of de collector uitvalt
- Een tweede collector voor failover
- Waar u op moet letten
- Verder
Wat u nodig hebt
- Een draaiende WatchZit-console (de appliance of het installatiescript; zie de downloadpagina).
- Op elke locatie één computer die altijd aanstaat: Linux of Windows. Een kleine VM of een machine van de Raspberry Pi-klasse is genoeg; de Linux-agent bestaat voor amd64 en arm64.
- Vanaf die computer een uitgaande verbinding naar de agentpoort 8444 van de server. Op de locatie hoeft niets open: de collector verbindt naar buiten, de console verbindt nooit naar hem.
- Beheerdersrechten in de console: alleen beheerders maken collectors en kiezen van waaruit apparaten worden bewaakt.
De server voorbereiden op agents van buiten
De console heeft twee poorten: 8443 voor de webinterface en de API, en 8444 voor agents. Houd 8443 voor uw beheernetwerken en maak alleen 8444 bereikbaar vanuit de filialen, bijvoorbeeld via port forwarding op de firewall van het hoofdkantoor.
Bereiken de filialen de server onder een andere naam dan de console, vul die dan in onder Instellingen → Netwerk en toegang als Openbaar agentadres, bijvoorbeeld https://monitor.example.com:8444. Het staat in elke aanmeldcode, dus stel het in voordat u codes maakt. Op dezelfde pagina kunt u de netwerken beperken waar agents vandaan mogen komen.
De agent op de locatie installeren
- Maak onder Agents een aanmeldcode: een naam, hoeveel dagen hij geldig is, hoeveel computers hem mogen gebruiken en de groep voor nieuwe apparaten. De code wordt één keer getoond. Hij bevat het serveradres en de vingerafdruk van het agentcertificaat, zodat de agent alleen uw server vertrouwt.
- Op een Windows-computer downloadt u de MSI van de pagina Agents en installeert u hem; hij vraagt om de code. Stil:
msiexec /i watchzit-agent-x64.msi ENROLLCODE="WZ1-…" /qn. De service heetWatchZitAgent. - Op Linux kopieert u de opdracht die de pagina Agents toont: die downloadt de agent via de agentpoort, controleert de SHA-256 en installeert hem met de code als systemd-service
watchzit-agent. Of installeer het deb- of rpm-pakket van de release en voersudo watchzit-agent enroll --code "WZ1-…"uit.
De computer verschijnt als apparaat met CPU, geheugen, schijven en interfaces. Maakt hij geen verbinding, controleer dan of hij poort 8444 bereikt en de toegestane netwerken onder Instellingen → Netwerk en toegang; het agentlogboek staat op Windows in C:\ProgramData\WatchZit Agent en op Linux in journalctl -u watchzit-agent.
Er een externe collector van maken
Open de apparaatpagina van de nieuwe agent en klik in het vak Agent op Gebruiken als externe collector. Meer is er aan de kant van de collector niet: hij heeft geen eigen webinterface en er wordt niets lokaal ingesteld — alles gebeurt in de console.
De pagina Agents toont hem nu onder Externe collectors, met zijn status en het aantal apparaten dat hij bewaakt. Een collector wordt bijgewerkt zoals elke andere agent: een agent die ouder is dan de server krijgt bij het verbinden de versie van de server.
De apparaten van de locatie toewijzen
Elk apparaat heeft op zijn apparaatpagina de instelling Bewaakt vanaf: Deze console of een van uw externe collectors. Voor één apparaat kiest u daar de collector en klikt u op Opslaan.
Voor veel apparaten tegelijk filtert u de apparatenlijst (bijvoorbeeld op de groep van het filiaal), vinkt u de apparaten aan en gebruikt u Selectie wijzigen: → Bewaakt vanaf.
De collector krijgt dan hun controles — ping, TCP, SNMP, webpagina's en scenario's, certificaten, DNS, databases, MikroTik RouterOS, JSON-API's — met de wachtwoorden en SNMP-instellingen die ze nodig hebben, voert ze uit op hun intervallen en stuurt de resultaten naar de console. Grafieken, triggers en kaarten werken precies zoals voor apparaten die de console zelf controleert.
Het filiaalnetwerk detecteren
U hoeft de apparaten van het filiaal niet met de hand toe te voegen. Voeg onder Apparaten → Detectie een bereik van het filiaal toe (bijvoorbeeld 192.168.20.0/24; tot een /22) en kies ernaast de collector. De collector scant het netwerk van zijn eigen locatie: hij pingt elk adres, probeert gangbare poorten, vraagt SNMP met uw SNMP-profielen en zoekt de DNS-namen op. Scan meteen, elke dag of elke week; met een planning verschijnen nieuwe hosts van het filiaal vanzelf.
Vink de gewenste hosts aan en klik op Als apparaten toevoegen. Apparaten die u toevoegt uit een bereik dat een collector heeft gescand, worden automatisch vanaf die collector bewaakt. De SNMP-detectie op de apparaatpagina en het uitlezen van gegevens, interfaces en VLAN's lopen ook via de collector.
Een kaart per locatie
Een kaart per filiaal houdt het overzicht helder. Voeg onder Kaarten een kaart toe, klik op Bewerken en zet de apparaten van het filiaal erop met Apparaat toevoegen. Voorgestelde verbindingen biedt de kabels die WatchZit op de apparaten heeft gevonden, met de poorten aan beide kanten; Alles toevoegen neemt ze over, Schikken legt de kaart uit volgens de kabels en Opslaan bewaart hem. Een plattegrond kan erachter als achtergrondafbeelding.
Maak daarna één overzichtskaart met een subkaart per filiaal: een subkaart verwijst naar de kaart van het filiaal en toont de slechtste toestand ervan, zodat een rood filiaal meteen opvalt. Voor een wandscherm toont Instellingen → Kioskschermen kaarten schermvullend achter een geheime link.
Om de lijn zelf te volgen, voegt u de controle Netwerkpad (traceroute) toe aan een apparaat dat de collector bewaakt: de collector traceert vanaf zijn eigen locatie, dus u ziet elke router onderweg vanuit het filiaal met verlies en vertraging, en wanneer de route veranderde.
Meldingen als de filiaallijn of de collector uitvalt
Valt de verbinding tussen filiaal en console weg, dan blijft de collector de controles uitvoeren. De resultaten — tot een dag, de nieuwste 200.000 — wachten op de collector en komen aan zodra de verbinding terug is, zodat de grafieken geen gat hebben.
Intussen doet de console niet alsof ze meer weet: de controles van de apparaten van de collector tonen Onbekend in plaats van uitgevallen, want op de locatie kan alles in orde zijn. De agentcontrole van de collector zelf opent een probleem, en dat is de melding die u krijgt: één melding voor het filiaal, niet één per apparaat. Waar problemen naartoe gaan, stelt u in onder Instellingen → Meldingen — e-mail, webhook, Slack, Microsoft Teams, Telegram, ntfy, PagerDuty, sms en meer.
Binnen het filiaal houden afhankelijkheden de ruis beperkt. Open de kaart van het filiaal en klik op Afhankelijkheden: de kabels volgend vanaf de router krijgt elk apparaat het apparaat ervoor aangeboden. Klik op Aangevinkte afhankelijkheden instellen. Valt de filiaalrouter of een switch uit, dan zijn de apparaten erachter alleen onbereikbaar; hun problemen worden vastgelegd maar niet verstuurd. Een trigger Geen nieuwe gegevens vangt controles op die geen waarden meer leveren.
Een tweede collector voor failover
Voor een belangrijke locatie installeert u de agent op een tweede computer daar en maakt u ook die een collector. Kies hem dan als Reserve naast Bewaakt vanaf op de apparaatpagina, of voor veel apparaten in de apparatenlijst onder Selectie wijzigen: → Reservecollector.
Zolang de eerste collector offline is, voert de reserve de controles van zijn apparaten uit. Is de eerste terug, dan neemt die ze weer over. Om de apparaten helemaal terug te geven aan de console, klikt u op de apparaatpagina van de collector op Stoppen met verzamelen.
Waar u op moet letten
- Resultaten die tijdens een storing zijn bewaard, overleven geen herstart van de collector: na een herstart krijgt hij zijn controles opnieuw van de console, en wat hij nog niet had verstuurd is weg.
- De buffer houdt tot een dag vast, hooguit de nieuwste 200.000 resultaten. Een langere storing laat een gat achter.
- Hypervisorcontroles blijven bij de console; een collector voert ze niet uit.
- Agentloze Linux-controles via SSH door een collector hebben de hostsleutel in de controle nodig: de collector kan hem niet opslaan en toont daarom de sleutel die hij zag.
- Zolang de lijn weg is, toont de console de apparaten van de collector als onbekend; hun echte toestand ziet u pas als de resultaten aankomen.
- Het verwijderen van de agent op de apparaatpagina maakt zijn sleutel onbekend; om die computer opnieuw te gebruiken, meldt u hem aan met een nieuwe code.
Verder
- Lees de hoofdstukken over agents en collectors in de documentatie, en bekijk alles wat WatchZit doet op de functiepagina.
- Draaien de filialen MikroTik, volg dan Een modern alternatief voor MikroTik The Dude voor SNMP, de RouterOS-API en het tekenen van de kaarten.
- De appliance en het installatiescript staan op de downloadpagina.
Vragen en ideeën zijn welkom in GitHub Discussions. Bedrijven kunnen commerciële support van MaxZit krijgen (alleen in het Engels).