Comandi dell’agent server: update, status, remove

Aggiornato il Ottobre 18, 2026 2 min di lettura

L’agent è un unico programma, uptimecheck-agent, che il comando nella pagina del server installa come servizio. Vedi come installare il monitoraggio server. Su Linux e macOS si trova in /usr/local/bin/uptimecheck-agent; esegui i suoi comandi con sudo. Su Windows si trova in C:\Program Files\Uptimecheck\uptimecheck-agent.exe; eseguilo in PowerShell come amministratore.

Comandi

sudo uptimecheck-agent status # in esecuzione, fermo o non installato
sudo uptimecheck-agent update –check # c’è una release più recente?
sudo uptimecheck-agent update # la installa e riavvia il servizio
sudo uptimecheck-agent restart # anche stop e start funzionano così
sudo uptimecheck-agent test # raccoglie un report, lo mostra e lo invia
uptimecheck-agent version
sudo uptimecheck-agent uninstall # ferma e rimuove il servizio

Su Windows: & “$env:ProgramFiles\Uptimecheck\uptimecheck-agent.exe” status, e lo stesso per gli altri.

Aggiornamenti

Se Update the agent automatically era attivo quando hai copiato il comando di installazione, l’agent cerca una nuova release circa ogni 6 ore e la installa da solo.Installa solo release firmate da Uptimecheck e mai una versione precedente.Senza questa opzione, la pagina del server indica quando è disponibile una nuova versione e mostra il comando da eseguire.update richiede l’agent 1.1.0 o successivo. Con un agent più vecchio, esegui di nuovo il comando di installazione dalla pagina del server; token, impostazioni e storico restano invariati. È anche il modo per attivare gli aggiornamenti automatici in un secondo momento: attiva l’opzione ed esegui il nuovo comando.

File delle impostazioni

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

Contiene l’indirizzo a cui l’agent invia i report (url), il token del server e autoUpdate. Tieni il token riservato. Dopo una modifica, esegui sudo uptimecheck-agent restart.

Come funziona

Su Linux il servizio gira con un proprio utente senza privilegi, uptimecheck-agent, sotto systemd o OpenRC. Con systemd, leggi il suo log con journalctl -u uptimecheck-agent.Invia un report ogni minuto via HTTPS (porta 443) all’url indicato nelle impostazioni, https://app.uptimecheck.com per le nuove installazioni, e non richiede alcuna porta in ingresso.Il token appartiene a un solo monitor server. Per un altro server, aggiungi un altro monitor server.

Rimuovere l’agent

Prima metti in pausa o elimina il monitor server in Uptimecheck, così non invia avvisi quando i report si interrompono.Esegui sudo uptimecheck-agent uninstall. Ferma e rimuove il servizio ed elimina il file delle impostazioni.Elimina il programma: sudo rm /usr/local/bin/uptimecheck-agent, oppure la cartella C:\Program Files\Uptimecheck su Windows. Su Linux puoi anche rimuovere l’utente uptimecheck-agent.

Scopri di più sul monitoraggio server e sulle soglie di avviso per i server.

Questo articolo ti è stato utile?

Provalo nel tuo workspace

Prova gratuita di 14 giorni · Poi gratis con 5 monitor · Nessuna carta di credito

Ancora bloccato?

Scrivi a support@uptimecheck.com e ti risponderemo entro 24 ore.

Vuoi automatizzare? La Riferimento API copre REST API, webhook, ping dei cron job e MCP.