Befehle des Server-Agents: update, status, remove

Aktualisiert am Oktober 18, 2026 2 Min. Lesezeit

Der Agent ist ein einziges Programm, uptimecheck-agent, das der Befehl auf der Seite des Servers als Dienst installiert. Siehe Server-Monitoring installieren. Unter Linux und macOS liegt er unter /usr/local/bin/uptimecheck-agent; führen Sie seine Befehle mit sudo aus. Unter Windows liegt er unter C:\Program Files\Uptimecheck\uptimecheck-agent.exe; führen Sie ihn in PowerShell als Administrator aus.

Befehle

sudo uptimecheck-agent status # läuft, gestoppt oder nicht installiert
sudo uptimecheck-agent update –check # gibt es eine neuere Version?
sudo uptimecheck-agent update # installieren und den Dienst neu starten
sudo uptimecheck-agent restart # stop und start funktionieren genauso
sudo uptimecheck-agent test # einen Bericht erfassen, anzeigen und senden
uptimecheck-agent version
sudo uptimecheck-agent uninstall # den Dienst stoppen und entfernen

Unter Windows: & „$env:ProgramFiles\Uptimecheck\uptimecheck-agent.exe“ status, und entsprechend für die anderen Befehle.

Updates

War Update the agent automatically aktiviert, als Sie den Installationsbefehl kopiert haben, sucht der Agent etwa alle 6 Stunden nach einer neuen Version und installiert sie selbstständig.Er installiert nur von Uptimecheck signierte Versionen und nie eine ältere Version.Ohne diese Option zeigt die Seite des Servers an, wann eine neue Version verfügbar ist, und nennt den Befehl, den Sie ausführen müssen.update setzt Agent 1.1.0 oder neuer voraus. Bei einem älteren Agent führen Sie den Installationsbefehl von der Seite des Servers erneut aus; Token, Einstellungen und Verlauf bleiben erhalten. Auf diesem Weg aktivieren Sie auch später automatische Updates: Option einschalten und den neuen Befehl ausführen.

Einstellungsdatei

Linux: /etc/uptimecheck-agent/agent.jsonmacOS: /Library/Application Support/Uptimecheck/agent.jsonWindows: C:\ProgramData\Uptimecheck\agent.json

Sie enthält die Adresse, an die der Agent berichtet (url), den token des Servers und autoUpdate. Halten Sie den Token geheim. Führen Sie nach einer Änderung sudo uptimecheck-agent restart aus.

So läuft er

Unter Linux läuft der Dienst als eigener Benutzer ohne Sonderrechte, uptimecheck-agent, unter systemd oder OpenRC. Mit systemd lesen Sie sein Log mit journalctl -u uptimecheck-agent.Er berichtet jede Minute per HTTPS (Port 443) an die url in seinen Einstellungen, bei neuen Installationen https://app.uptimecheck.com, und braucht keinen eingehenden Port.Der Token gehört zu genau einem Server-Monitor. Legen Sie für einen weiteren Server einen weiteren Server-Monitor an.

Agent entfernen

Pausieren oder löschen Sie zuerst den Server-Monitor in Uptimecheck, damit er nicht alarmiert, wenn keine Berichte mehr kommen.Führen Sie sudo uptimecheck-agent uninstall aus. Der Befehl stoppt und entfernt den Dienst und löscht die Einstellungsdatei.Löschen Sie das Programm: sudo rm /usr/local/bin/uptimecheck-agent, unter Windows den Ordner C:\Program Files\Uptimecheck. Unter Linux können Sie außerdem den Benutzer uptimecheck-agent entfernen.

Mehr zum Server-Monitoring und zu Alarmschwellen für Server.

War dieser Artikel hilfreich?

Testen Sie es in Ihrem eigenen Workspace

14 Tage kostenlos testen · Danach gratis für 5 Monitore · Keine Kreditkarte

Kommen Sie nicht weiter?

Schreiben Sie an support@uptimecheck.com, wir antworten innerhalb von 24 Stunden.

Sie möchten automatisieren? Die API-Referenz deckt REST-API, Webhooks, Cron-Job-Pings und MCP ab.