De agent is één programma, uptimecheck-agent, dat het commando op de pagina van de server als service installeert. Zie servermonitoring installeren. Op Linux en macOS staat het in /usr/local/bin/uptimecheck-agent; voer de commando’s uit met sudo. Op Windows staat het in C:\Program Files\Uptimecheck\uptimecheck-agent.exe; voer het uit in PowerShell als Administrator.
Commando’s
sudo uptimecheck-agent status # running, stopped or not installed
sudo uptimecheck-agent update –check # is a newer release out?
sudo uptimecheck-agent update # install it and restart the service
sudo uptimecheck-agent restart # stop and start work the same way
sudo uptimecheck-agent test # collect one report, show it and send it
uptimecheck-agent version
sudo uptimecheck-agent uninstall # stop and remove the service
Op Windows: & “$env:ProgramFiles\Uptimecheck\uptimecheck-agent.exe” status, en hetzelfde voor de andere commando’s.
Updates
Stond Update the agent automatically aan toen je het installatiecommando kopieerde, dan zoekt de agent ongeveer elke 6 uur naar een nieuwe release en installeert die zelf.Hij installeert alleen releases die door Uptimecheck zijn ondertekend, en nooit een oudere versie.Zonder deze optie meldt de pagina van de server wanneer er een nieuwe versie is en toont het commando dat je moet uitvoeren.update vereist agent 1.1.0 of hoger. Heb je een oudere agent, voer dan het installatiecommando van de serverpagina opnieuw uit; de token, instellingen en geschiedenis blijven zoals ze zijn. Zo zet je automatische updates ook later aan: zet de optie aan en voer het nieuwe commando uit.
Instellingenbestand
Linux: /etc/uptimecheck-agent/agent.jsonmacOS: /Library/Application Support/Uptimecheck/agent.jsonWindows: C:\ProgramData\Uptimecheck\agent.json
Het bevat het adres waaraan de agent rapporteert (url), de token van de server en autoUpdate. Houd de token geheim. Voer na een wijziging sudo uptimecheck-agent restart uit.
Hoe hij draait
Op Linux draait de service als eigen gebruiker zonder extra rechten, uptimecheck-agent, onder systemd of OpenRC. Met systemd lees je het log met journalctl -u uptimecheck-agent.Hij rapporteert elke minuut via HTTPS (poort 443) aan de url in zijn instellingen, https://app.uptimecheck.com bij nieuwe installaties, en heeft geen inkomende poort nodig.De token hoort bij één servermonitor. Voeg voor een andere server een nieuwe servermonitor toe.
De agent verwijderen
Pauzeer of verwijder eerst de servermonitor in Uptimecheck, zodat die geen alert stuurt als de rapporten stoppen.Voer sudo uptimecheck-agent uninstall uit. Dat stopt en verwijdert de service en wist het instellingenbestand.Verwijder het programma: sudo rm /usr/local/bin/uptimecheck-agent, of op Windows de map C:\Program Files\Uptimecheck. Op Linux kun je ook de gebruiker uptimecheck-agent verwijderen.
Meer over servermonitoring en drempels voor serveralerts.